sol2/docs/source/index.rst

140 lines
3.6 KiB
ReStructuredText
Raw Normal View History

.. sol documentation master file, created by
2016-03-12 06:47:15 +08:00
sphinx-quickstart on Mon Feb 29 21:49:51 2016.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
.. image:: media/sol.png
2016-04-26 03:58:13 +08:00
:target: https://github.com/ThePhD/sol2
:alt: sol repository
:align: center
2016-04-26 03:58:13 +08:00
sol |version|
2016-11-06 11:17:31 +08:00
=============
*a fast, simple C++ and Lua Binding*
2016-03-12 06:47:15 +08:00
When you need to hit the ground running with Lua and C++, `sol`_ is the go-to framework for high-performance binding with an easy to use API.
2016-03-12 10:45:41 +08:00
get going:
----------
2016-03-12 06:47:15 +08:00
.. toctree::
2016-08-25 00:22:51 +08:00
:maxdepth: 1
:name: mastertoc
2016-03-12 06:47:15 +08:00
tutorial/all-the-things
2016-04-24 05:16:56 +08:00
tutorial/tutorial-top
errors
compilation
features
functions
usertypes
containers
threading
traits
api/api-top
mentions
benchmarks
2016-08-17 03:19:51 +08:00
performance
safety
exceptions
rtti
codecvt
2018-11-10 06:36:27 +08:00
build
licenses
origin
2016-03-12 06:47:15 +08:00
2016-03-12 10:45:41 +08:00
connect
--------
Come to the Github Issues or the Discord! We've got a friendly community, and they can help you out or you can come just to talk about the things you are working on!
|ds| |gh|
support
-------
You can support the project and other related endeavors in various ways.
|gs| |pa| |kf| |lp| |pp|
GitHub Sponsors is matching all sponsorships 100% and they also do not charge fees on either end of the transaction as well until sometime in June 2020. Still, you can support sol3 development by using any of the above. This is a time-consuming effort, so individuals who donate get to:
- steer the direction and time spent on sol
- get a role on the Discord server
- get their name put up in the CONTRIBUTORS list
- put something of their choice on sol3's README or the documentation's front page
2016-03-12 06:47:15 +08:00
"I need feature X, maybe you have it?"
--------------------------------------
Take a look at the :doc:`Features<features>` page: it links to much of the API. You can also just straight up browse the :doc:`api<api/api-top>` or ease in with the :doc:`tutorials<tutorial/tutorial-top>`. To know more about the implementation for usertypes, see :doc:`here<usertypes>` To know how function arguments are handled, see :ref:`this note<function-argument-handling>`. Don't see a feature you want? Send inquiries for support for a particular abstraction to the `issues`_ tracker.
2016-03-12 06:47:15 +08:00
2016-03-12 10:45:41 +08:00
the basics:
2016-03-12 06:47:15 +08:00
-----------
.. note::
The code below *and* more examples can be found in the `examples directory`_.
2016-03-12 06:47:15 +08:00
2016-04-11 14:15:06 +08:00
.. literalinclude:: ../../examples/source/docs/simple_functions.cpp
:name: simple-functions-example
2016-04-11 14:15:06 +08:00
:linenos:
2016-03-12 06:47:15 +08:00
.. literalinclude:: ../../examples/source/docs/simple_structs.cpp
:name: simple-structs-example
:linenos:
2016-03-12 06:47:15 +08:00
2019-05-25 04:39:55 +08:00
Search
======
2016-03-12 06:47:15 +08:00
* :ref:`search`
2016-03-12 10:45:41 +08:00
.. _Sol: https://github.com/ThePhD/sol2
.. _issues: https://github.com/ThePhD/sol2/issues
.. _examples directory: https://github.com/ThePhD/sol2/tree/develop/examples
.. |pa| image:: media/become_a_patron_button.png
:height: 50
:target: https://www.patreon.com/soasis
:alt: sol3 Patreon
:align: middle
.. |kf| image:: media/Ko-fi_Blue.png
:height: 50
:target: https://ko-fi.com/soasis
:alt: sol3 ko-fi
:align: middle
.. |lp| image:: media/liberapay_logo.png
:height: 50
:target: https://liberapay.com/Soasis
:alt: sol3 ko-fi
:align: middle
.. |pp| image:: media/pp_cc_mark_111x69.jpg
:height: 50
:target: https://www.paypal.me/Soasis
:alt: sol3 PayPal
:align: middle
.. |ds| image:: media/discord_logo_wordmark.png
:height: 75
:target: https://discord.gg/buxkYNT
:alt: sol3 Discord
.. |gh| image:: media/github_logo.png
:height: 75
:target: https://github.com/ThePhD/sol2/issues
:alt: sol3 Github Issues Page
.. |gs| image:: media/github_sponsors_logo.png
:height: 55
:target: https://github.com/users/ThePhD/sponsorship
:alt: sol3 Sponsors Page