A User's Manual for Cuberite
HTML Python
Switch branches/tags
Nothing to show
Clone or download
bearbin Merge pull request #91 from cuberite/updatedate
Link to latest commit and proper update date
Latest commit c3d0a99 Aug 31, 2017

README.md

users-manual

A User's Manual for Cuberite

There is an automatically updated version of the manual at 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.