premake/README.md

92 lines
4.3 KiB
Markdown
Raw Normal View History

2019-08-21 00:09:37 +00:00
<p align="center">
<a href="https://premake.github.io/" target="blank"><img src="https://premake.github.io/premake-logo.png" height="200" width="200" alt="Premake" /></a>
</p>
2016-01-17 22:02:57 +00:00
2019-08-21 00:09:37 +00:00
<p align="center">
<img src="https://img.shields.io/github/release/premake/premake-core/all.svg" alt="Latest release" />
<img src="https://img.shields.io/github/release-date-pre/premake/premake-core.svg" alt="Release date" />
<img src="https://img.shields.io/github/commits-since/premake/premake-core/v5.0.0-alpha14.svg" alt="Commits" />
<a href="https://opensource.org/licenses/BSD-3-Clause" target="_blank">
<img src="https://img.shields.io/github/license/premake/premake-core" alt="BSD 3-Clause" />
</a>
<br/>
<a href="https://travis-ci.org/premake/premake-core" target="_blank">
<img src="https://img.shields.io/travis/premake/premake-core/master.svg?label=linux" alt="Linux" />
</a>
<a href="https://ci.appveyor.com/project/PremakeOrganization/premake-core" target="_blank">
<img src="https://img.shields.io/appveyor/ci/PremakeOrganization/premake-core?label=windows" alt="Windows" />
</a>
<a href="https://github.com/premake/premake-core/graphs/contributors" target="_blank">
<img src="https://img.shields.io/github/contributors/premake/premake-core?label=code+contributors" alt="Contributors" />
</a>
<a href="https://opencollective.com/premake" _target="blank">
<img src="https://opencollective.com/premake/all/badge.svg?label=financial+contributors" alt="Contributors" />
</a>
<a href="https://twitter.com/premakeapp" target="_blank">
<img src="https://img.shields.io/twitter/follow/premakeapp.svg?style=social&label=Follow">
</a>
</p>
2019-08-21 00:09:37 +00:00
# Welcome to Premake
2019-08-21 00:09:37 +00:00
Premake is a command line utility which reads a scripted definition of a software project, then uses it to perform build configuration tasks or generate project files for toolsets like Visual Studio, Xcode, and GNU Make. Premake's scripts are little [Lua](http://www.lua.org/) programs, so the sky's the limit!
2015-07-28 20:18:28 +00:00
2019-08-21 00:09:37 +00:00
```lua
workspace "MyWorkspace"
configurations { "Debug", "Release" }
2015-07-28 20:18:28 +00:00
2019-08-21 00:09:37 +00:00
project "MyProject"
kind "ConsoleApp"
language "C++"
files { "**.h", "**.cpp" }
2015-07-28 20:18:28 +00:00
2019-08-21 00:09:37 +00:00
filter { "configurations:Debug" }
defines { "DEBUG" }
symbols "On"
2015-07-28 20:18:28 +00:00
2019-08-21 00:09:37 +00:00
filter { "configurations:Release" }
defines { "NDEBUG" }
optimize "On"
```
2015-07-28 20:18:28 +00:00
2019-08-21 00:09:37 +00:00
## Getting Started
2015-07-28 20:18:28 +00:00
2019-08-21 00:09:37 +00:00
* [Documentation](https://github.com/premake/premake-core/wiki)
* [Contributing](https://github.com/premake/premake-core/blob/master/CONTRIBUTING.md)
* [Issue Tracker](https://github.com/premake/premake-core/issues)
2015-07-28 20:18:28 +00:00
2019-08-21 00:09:37 +00:00
## Sponsors
2015-07-28 20:18:28 +00:00
2019-08-21 00:09:37 +00:00
Premake is a BSD-licensed open source project. Our many thanks to these fine people who help us spend more time adding features and supporting the community. :tada:
2015-07-28 20:18:28 +00:00
2019-08-21 00:09:37 +00:00
Want to join them? [Learn more here](https://opencollective.com/premake). Use Premake at work? Ask your manager or marketing team about contributing too; your company logo will appear on our [website](https://premake.github.io/) and README, as well as all of our [release pages](https://github.com/premake/premake-core/releases).
2019-08-21 00:09:37 +00:00
### Organizations
2019-08-21 00:09:37 +00:00
<a href="https://opencollective.com/premake#sponsors" target="_blank"><img src="https://opencollective.com/premake/sponsors.svg?width=890&avatarHeight=92&button=false"/></a>
2019-08-21 00:09:37 +00:00
### Individuals
2019-08-21 00:09:37 +00:00
<a href="https://opencollective.com/premake#backers" target="_blank"><img src="https://opencollective.com/premake/backers.svg?width=890&button=false"/></a>
2019-08-21 00:09:37 +00:00
## Contributing
2019-08-21 00:09:37 +00:00
We love getting [pull requests](https://www.quora.com/GitHub-What-is-a-pull-request) and rely heavily on the contributions of our community to keep Premake healthy and growing. If you're new to the project, [our Contributing Guide is here](https://github.com/premake/premake-core/blob/master/CONTRIBUTING.md).
2019-08-21 00:09:37 +00:00
A great big thank you to all of you who have already contributed your time and know-how!
2019-08-21 00:09:37 +00:00
<a href="https://github.com/premake/premake-core/graphs/contributors"><img src="https://opencollective.com/premake/contributors.svg?width=890&avatarHeight=32&button=false" /></a>
2019-08-21 00:09:37 +00:00
## Stay in touch
2019-08-21 00:09:37 +00:00
* Website - https://premake.github.io
* Twitter - [@premakeapp](https://twitter.com/premakeapp)
2015-07-28 20:18:28 +00:00
2019-08-21 00:09:37 +00:00
## License
[BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
2015-07-28 20:18:28 +00:00
The Lua language and runtime library is &copy; TeCGraf, PUC-Rio.
See their website at http://www.lua.org/