Skip to content

Commit

Permalink
Expanded ShapeGen secion
Browse files Browse the repository at this point in the history
  • Loading branch information
NiLSPACE committed Oct 7, 2016
1 parent dd0249f commit 2ce843e
Show file tree
Hide file tree
Showing 30 changed files with 2,206 additions and 2,164 deletions.
24 changes: 12 additions & 12 deletions .travis.yml
@@ -1,12 +1,12 @@
language: python
python:
- "2.7"
before_install:
- sudo apt-get update
- sudo apt-get install oracle-java8-installer
- sudo update-java-alternatives -s java-8-oracle
install:
- "pip install html5validator"
script:
- "python generate.py"
- "html5validator --root out/"
language: python
python:
- "2.7"
before_install:
- sudo apt-get update
- sudo apt-get install oracle-java8-installer
- sudo update-java-alternatives -s java-8-oracle
install:
- "pip install html5validator"
script:
- "python generate.py"
- "html5validator --root out/"
468 changes: 234 additions & 234 deletions LICENSE

Large diffs are not rendered by default.

74 changes: 37 additions & 37 deletions README.md
@@ -1,37 +1,37 @@
users-manual
============

A User's Manual for Cuberite

There is an automatically updated version of the manual at [book.cuberite.org](https://book.cuberite.org), which updates every hour if a new commit has been pushed to this repository.


Developers' Area
----------------

This book is structured as individual HTML snippets for each chapter. The filename describes the section number and also the name of the section, separated by " - ".

A sample input directory structure would be:

/
|> 0 - Introduction/
| |> 1 - Intro.html
| |> 2 - Notes.html
|> 1 - Setting Up/
| |> 1 - Downloading.html
| |> 2 - Running.html

The idea is that the generator, combines the files to form 2 outputs - one standalone HTML page with all sections integrated and internal links, and another with each file (or section?) being a separate page. At the moment the generator only compiles to a single page, but multiple page is planned.

Here is a guide to writing:

Links to another section are automatically generated like so - `{{Section Number - Text of Link}}`.

Here is a list of semantically correct and styled HTML elements for specific purposes:

* `<p>` For Paragraphs
* `<h4>` For Headings
* `<aside class="infobox">` For information tangentially related to the content.
* `<aside class="warnbox">` For a warning related to the content.
* `<figure class="codebox">` For a code sample, with nested `<pre>` and `<code>` tags. Optionally with a `<figcaption>` for a caption.
* `<figure class="imgbox"` For an image/screenshot. Optionally with a `<figcaption>` for a caption.
users-manual
============

A User's Manual for Cuberite

There is an automatically updated version of the manual at [book.cuberite.org](https://book.cuberite.org), which updates every hour if a new commit has been pushed to this repository.


Developers' Area
----------------

This book is structured as individual HTML snippets for each chapter. The filename describes the section number and also the name of the section, separated by " - ".

A sample input directory structure would be:

/
|> 0 - Introduction/
| |> 1 - Intro.html
| |> 2 - Notes.html
|> 1 - Setting Up/
| |> 1 - Downloading.html
| |> 2 - Running.html

The idea is that the generator, combines the files to form 2 outputs - one standalone HTML page with all sections integrated and internal links, and another with each file (or section?) being a separate page. At the moment the generator only compiles to a single page, but multiple page is planned.

Here is a guide to writing:

Links to another section are automatically generated like so - `{{Section Number - Text of Link}}`.

Here is a list of semantically correct and styled HTML elements for specific purposes:

* `<p>` For Paragraphs
* `<h4>` For Headings
* `<aside class="infobox">` For information tangentially related to the content.
* `<aside class="warnbox">` For a warning related to the content.
* `<figure class="codebox">` For a code sample, with nested `<pre>` and `<code>` tags. Optionally with a `<figcaption>` for a caption.
* `<figure class="imgbox"` For an image/screenshot. Optionally with a `<figcaption>` for a caption.
76 changes: 38 additions & 38 deletions book/0 - Introduction/1 - Introduction.html
@@ -1,38 +1,38 @@
<p>
This is the Cuberite User's Manual. It is intended as a guide on how to
operate the basics of Cuberite, as well as an introduction to some advanced
features. It is organised into major sections as well as more detailed
subsections and these are laid out in the {{toc - Table of Contents}}.
The first section deals with downloading, installing, and running Cuberite.
The second section is an overview of configuring Cuberite. Reading those two
sections is enough to get you started. The remaining sections cover more
advanced features and further configuration options in greater depth.
</p>

<p>
As with Cuberite itself, this manual is in active development, and you can
contribute yourself or file an issue if you find an error or ommission on the
<a href="https://github.com/cuberite/users-manual">GitHub Repository</a>.
If you're using a printed version, note that the latest version of this
manual is always available <a href="https://book.cuberite.org/">online</a>.
</p>

<h4>Resources</h4>

<ul>
<li><a href="http://cuberite.org/">Cuberite Homepage</a></li>
<li><a href="https://forum.cuberite.org/">Forum</a></li>
<li><a href="https://forum.cuberite.org/forum-2.html">Plugin Repository</a></li>
<li><a href="https://forum.cuberite.org/thread-1435.html">Server List</a></li>
<li><a href="https://forum.cuberite.org/thread-2146.html">Development Progress</a></li>
<li><a href="https://forum.cuberite.org/thread-2504.html">Crash Avoidance Tips</a></li>
<li><a href="mailto:support@cuberite.org">Support E-mail Address</a></li>
</ul>

<h4>Developer Resources</h4>

<ul>
<li><a href="http://api-docs.cuberite.org/Writing-a-Cuberite-plugin.html">Writing your First Plugin</a></li>
<li><a href="http://api-docs.cuberite.org/">Plugin API Documentation</a></li>
<li><a href="https://github.com/cuberite/cuberite">GitHub Repository</a></li>
</ul>
<p>
This is the Cuberite User's Manual. It is intended as a guide on how to
operate the basics of Cuberite, as well as an introduction to some advanced
features. It is organised into major sections as well as more detailed
subsections and these are laid out in the {{toc - Table of Contents}}.
The first section deals with downloading, installing, and running Cuberite.
The second section is an overview of configuring Cuberite. Reading those two
sections is enough to get you started. The remaining sections cover more
advanced features and further configuration options in greater depth.
</p>

<p>
As with Cuberite itself, this manual is in active development, and you can
contribute yourself or file an issue if you find an error or ommission on the
<a href="https://github.com/cuberite/users-manual">GitHub Repository</a>.
If you're using a printed version, note that the latest version of this
manual is always available <a href="https://book.cuberite.org/">online</a>.
</p>

<h4>Resources</h4>

<ul>
<li><a href="http://cuberite.org/">Cuberite Homepage</a></li>
<li><a href="https://forum.cuberite.org/">Forum</a></li>
<li><a href="https://forum.cuberite.org/forum-2.html">Plugin Repository</a></li>
<li><a href="https://forum.cuberite.org/thread-1435.html">Server List</a></li>
<li><a href="https://forum.cuberite.org/thread-2146.html">Development Progress</a></li>
<li><a href="https://forum.cuberite.org/thread-2504.html">Crash Avoidance Tips</a></li>
<li><a href="mailto:support@cuberite.org">Support E-mail Address</a></li>
</ul>

<h4>Developer Resources</h4>

<ul>
<li><a href="http://api-docs.cuberite.org/Writing-a-Cuberite-plugin.html">Writing your First Plugin</a></li>
<li><a href="http://api-docs.cuberite.org/">Plugin API Documentation</a></li>
<li><a href="https://github.com/cuberite/cuberite">GitHub Repository</a></li>
</ul>
14 changes: 7 additions & 7 deletions book/0 - Introduction/2 - What is Cuberite.html
@@ -1,7 +1,7 @@
<p>
Cuberite is a Free and Open Source (FOSS) Minecraft-compatible Game Server. Cuberite is designed with performance, configurability, and extensibility in mind, and also aims to accurately recreate most vanilla features. Cuberite is written in C++, and there is an extensive plugin system that allows for the user to write their own plugins with Lua. In fact, many of the built in commands are implemented by the Core plugin, which has its own <a href="https://github.com/cuberite/Core">GitHub repository</a> and developer community. For more information on the plugin system and how to use it, as well as how to develop for it, please see {{2.4 - Plugins}}.
</p>

<p>
Cuberite today is maintained by a large team of <a href="https://github.com/cuberite/cuberite/blob/master/CONTRIBUTORS">contributors</a> and plugin developers. If you want to reward the developers for their work, you should set up a donation on <a href="https://salt.bountysource.com/teams/cuberite">Bountysource</a> with a credit card, bitcoin or other currency.
</p>
<p>
Cuberite is a Free and Open Source (FOSS) Minecraft-compatible Game Server. Cuberite is designed with performance, configurability, and extensibility in mind, and also aims to accurately recreate most vanilla features. Cuberite is written in C++, and there is an extensive plugin system that allows for the user to write their own plugins with Lua. In fact, many of the built in commands are implemented by the Core plugin, which has its own <a href="https://github.com/cuberite/Core">GitHub repository</a> and developer community. For more information on the plugin system and how to use it, as well as how to develop for it, please see {{2.4 - Plugins}}.
</p>

<p>
Cuberite today is maintained by a large team of <a href="https://github.com/cuberite/cuberite/blob/master/CONTRIBUTORS">contributors</a> and plugin developers. If you want to reward the developers for their work, you should set up a donation on <a href="https://salt.bountysource.com/teams/cuberite">Bountysource</a> with a credit card, bitcoin or other currency.
</p>
46 changes: 23 additions & 23 deletions book/0 - Introduction/3 - History.html
@@ -1,23 +1,23 @@
<p>
Cuberite was created in late 2010 by <a href="https://github.com/faketruth">FakeTruth</a> with its original name "MCServer", as a replacement for the vanilla server, designed to be better performing and more configurable. It was soon open-sourced and developers started working.
</p>

<p>
In the summer of 2013, the main MCServer repository was moved from Google Code to GitHub, and a new build system was introduced. Several new developers also joined the project around that time, and the project began to increase in members and popularity.
</p>

<p>
As of late 2014, MCServer had a team of more than 10 regular developers, and the codebase had grown to over 125,000 lines (excluding comments, blank lines and external libraries). Many new features were also introduced in 2014:
</p>

<ul>
<li>Chunk Sparsing (ram usage reduction)</li>
<li>New Redstone Simulator</li>
<li>New Water and Lava Simulators</li>
<li>New Generators (and improved speed)</li>
</ul>

<p>
In 2015, many new developers joined the project, and the community decided to adopt the current name of Cuberite.
As of late 2015, Cuberite has over 1000 stars on GitHub.
</p>
<p>
Cuberite was created in late 2010 by <a href="https://github.com/faketruth">FakeTruth</a> with its original name "MCServer", as a replacement for the vanilla server, designed to be better performing and more configurable. It was soon open-sourced and developers started working.
</p>

<p>
In the summer of 2013, the main MCServer repository was moved from Google Code to GitHub, and a new build system was introduced. Several new developers also joined the project around that time, and the project began to increase in members and popularity.
</p>

<p>
As of late 2014, MCServer had a team of more than 10 regular developers, and the codebase had grown to over 125,000 lines (excluding comments, blank lines and external libraries). Many new features were also introduced in 2014:
</p>

<ul>
<li>Chunk Sparsing (ram usage reduction)</li>
<li>New Redstone Simulator</li>
<li>New Water and Lava Simulators</li>
<li>New Generators (and improved speed)</li>
</ul>

<p>
In 2015, many new developers joined the project, and the community decided to adopt the current name of Cuberite.
As of late 2015, Cuberite has over 1000 stars on GitHub.
</p>
58 changes: 29 additions & 29 deletions book/1 - Installing/1 - Pre-Compiled Builds.html
@@ -1,29 +1,29 @@
<p id="buildsurl">
For Windows, Linux, Raspberry Pi or Mac builds, the main download location
is the <a href="http://cuberite.org">official homepage</a>, with the latest
builds available. For developers who want more control over the builds they
download, visit the <a href="https://builds.cuberite.org">buildserver</a>.
</p>

<p>
On Linux or Raspberry Pi, you can simply paste this command into your
terminal to install Cuberite:
</p>

<figure class="codebox">
<pre><code>sh -c "$(wget -O - https://download.cuberite.org)"</code></pre>
</figure>

<p>
Once you have downloaded Cuberite, you can skip straight to
{{1.3 - Running Cuberite}}.
</p>

<p>
Pre-compiled builds are faster to install and easier to use than compiling
the source yourself, and are recommended for beginners. However, for some
unusual hardware for which no pre-compiled build exists it may be necessary
to compile the code yourself. Compiling yourself also has a significant
performance advantage on modern machines. If you know how to use the command
line or want extra speed you should {{1.2 - compile Cuberite yourself}}.
</p>
<p id="buildsurl">
For Windows, Linux, Raspberry Pi or Mac builds, the main download location
is the <a href="http://cuberite.org">official homepage</a>, with the latest
builds available. For developers who want more control over the builds they
download, visit the <a href="https://builds.cuberite.org">buildserver</a>.
</p>

<p>
On Linux or Raspberry Pi, you can simply paste this command into your
terminal to install Cuberite:
</p>

<figure class="codebox">
<pre><code>sh -c "$(wget -O - https://download.cuberite.org)"</code></pre>
</figure>

<p>
Once you have downloaded Cuberite, you can skip straight to
{{1.3 - Running Cuberite}}.
</p>

<p>
Pre-compiled builds are faster to install and easier to use than compiling
the source yourself, and are recommended for beginners. However, for some
unusual hardware for which no pre-compiled build exists it may be necessary
to compile the code yourself. Compiling yourself also has a significant
performance advantage on modern machines. If you know how to use the command
line or want extra speed you should {{1.2 - compile Cuberite yourself}}.
</p>

0 comments on commit 2ce843e

Please sign in to comment.