Reuh/ubiquitousse
1
0
Fork 0
mirror of https://github.com/Reuh/ubiquitousse.git synced 2025-10-27 17:19:31 +00:00
Code Releases Activity

Add make script and precompile Candran files

Browse source
This commit is contained in:
Étienne Fildadut 2021-12-27 17:22:50 +01:00
parent bfa73f6dd0
commit bfbe236e58
18 changed files with 1307 additions and 80 deletions
Download patch file Download diff file Expand all files Collapse all files

51
docs/modules/ubiquitousse.html
View file

@ -60,29 +60,37 @@
<h1>Module <code>ubiquitousse</code></h1>
<p>Ubiquitousse main module.</p>
<p> Set of various Lua libraries to make game development easier, mainly made to be used alongside the <a href="https://love2d.org/">LÖVE</a> game framework.
Nothing that hasn&rsquo;t been done before, but these are tailored to what I need. They can be used independently too, and are relatively portable, even without LÖVE.</p>
<p><p>Set of various Lua libraries to make game development easier, mainly made to be used alongside the <a href="https://love2d.org/">LÖVE</a> game framework.
Nothing that hasn&rsquo;t been done before, but these are tailored to what I need. They can be used independently too, and are relatively portable, even without LÖVE.</p>
<p> This is the main module, which will try to load every other Ubiquitousse module when required and may even provide a few convenience functions.</p>
<p>This is the main module, which will try to load every other Ubiquitousse module when required,
and also perform a quick LÖVE version check and show a warning in case of potential incompatibility.</p>
<p> This also perform a quick LÖVE version check and show a warning in case of potential incompatibility.</p>
<p><strong>Regarding Ubiquitousse&rsquo;s organization</strong></p>
<p> <strong>Regarding Ubiquitousse&rsquo;s organization</strong></p>
<p>Ubiquitousse may or may not be used in its totality. You can delete the modules directories you don&rsquo;t need and Ubiquitousse
should adapt accordingly. You can also simply copy the modules directories you need and use them directly, without using this
file at all.
However, some modules may provide more feature when other modules are available.
These dependencies are written at the top of every main module file.</p>
<p> Ubiquitousse may or may not be used in its totality. You can delete the modules directories you don&rsquo;t need and Ubiquitousse
should adapt accordingly. You can also simply copy the modules directories you need and use them directly, without using this
file at all.
However, some modules may provide more feature when other modules are available.
These dependencies are written at the top of every main module file.</p>
<p>Ubiquitousse&rsquo;s original goal was to run everywhere with the least porting effort possible, so while the current version now mainly focus LÖVE, it
should still be easily modifiable to work with something else. Ubiquitousse is mainly tested on LuaJIT and Lua 5.3 but should also support Lua 5.1 and 5.2.
In order to keep a good idea of how portable this all is, other dependencies, including LÖVE, are explicited at the top of every module file and in specific
functions definition using the <code>@require</code> tag (e.g., <code>&mdash; @require love</code> for LÖVE).</p>
<p> Ubiquitousse&rsquo;s original goal was to run everywhere with the least porting effort possible, so while the current version now mainly focus LÖVE, it
should still be easily modifiable to work with something else. Ubiquitousse is mainly tested on LuaJIT and Lua 5.3 but should also support Lua 5.1 and 5.2.
In order to keep a good idea of how portable this all is, other dependencies, including LÖVE, are explicited at the top of every module file and in specific
functions definition using the <code>@require</code> tag (e.g., <code>&mdash; @require love</code> for LÖVE).</p>
<p>Some modules are developped in <a href="https://github.com/Reuh/candran">Candran</a> (<code>.can</code> files), but can easily be compiled into regular Lua code. In fact,
you will find precompiled Lua files in the ubiquitousse repository alongside the Candran files, so you don&rsquo;t have to install Candran yourself and everything
should be pretty much plug and play.</p>
<p> Some modules are developped in <a href="https://github.com/Reuh/candran">Candran</a> (.can files), but can easily be compiled into regular Lua code.</p>
<p>Regarding the documentation: Ubiquitousse uses LDoc/LuaDoc styled-comments, but since LDoc hates me and my code, the
generated result is mostly garbage, so to generate the documentation you will need to use my <a href="https://github.com/Reuh/LDoc">LDoc fork</a>
which I modified to force LDoc to like me.</p>
<p> Units used in the API documentation, unless written otherwise:</p>
<p>If you want to recompile the Candran files or the documentation yourself, there&rsquo;s a build script <code>make</code> available at the root of
the repository to save you a few seconds.</p>
<p>Units used in the API documentation, unless written otherwise:</p>
<ul>
<li>All distances are expressed in pixels (px)</li>
@ -90,9 +98,9 @@
</ul>
<p> These units are only used to make writing documentation easier; you can use other units if you want, as long as you're consistent.</p>
<p>These units are only used to make writing documentation easier; you can use other units if you want, as long as you're consistent.</p>
<p> Style:</p>
<p>Style:</p>
<ul>
<li>tabs for indentation, spaces for esthetic whitespace (notably in comments)</li>
@ -102,10 +110,7 @@
<li>lowerCamelCase is expected for everything else.</li>
</ul>
<p> Regarding the documentation: Ubiquitousse uses LDoc/LuaDoc styled-comments, but since LDoc hates me and my code, the
generated result is mostly garbage, so to generate the documentation you will need to use my <a href="https://github.com/Reuh/LDoc">LDoc fork</a>
which I modified to force LDoc to like me.</p>
</p>
<h3>Usage:</h3>
<ul>
<pre class="example">local ubiquitousse = require(&quot;ubiquitousse&quot;)
@ -362,7 +367,7 @@
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2021-12-27 16:25:25 </i>
<i style="float:right;">Last updated 2021-12-27 17:22:39 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>