Link cleanup, start work on Configuration Guide

Configuration_Guide/glowstone_yml/index.rst

@@ -0,0 +1,11 @@
+glowstone.yml
+=============
+
+The :code:`glowstone.yml` file allows you to edit your server settings.
+
+.. toctree::
+    :maxdepth: 2
+    :caption: Sections
+    :titlesonly:
+
+    server

Configuration_Guide/glowstone_yml/server.rst

@@ -0,0 +1,17 @@
+server
+======
+
++--------------------------------+-------------------+--------------------------------+-------------------------------------------------------------+
+| Key                            | Type              | Default                        | Description                                                 |
++================================+===================+================================+=============================================================+
+| ip                             | string            |                                | Which interface the server should listen on, usually blank. |
++--------------------------------+-------------------+--------------------------------+-------------------------------------------------------------+
+| port                           | integer           | 25565                          | The port the server should listen on.                       |
++--------------------------------+-------------------+--------------------------------+-------------------------------------------------------------+
+| name                           | string            | Glowstone Server               | The server's name, used in queries.                         |
++--------------------------------+-------------------+--------------------------------+-------------------------------------------------------------+
+| log-file                       | string            | logs/log-%D.txt                | Where the log is stored relative to the server folder.      |
++--------------------------------+-------------------+--------------------------------+-------------------------------------------------------------+
+|                                |                   |                                | Whether connecting players are authenticated.               |
+| online-mode                    | true/false        | true                           | Only disable this if you know what you are doing.           |
++--------------------------------+-------------------+--------------------------------+-------------------------------------------------------------+

Configuration_Guide/index.rst

@@ -0,0 +1,21 @@
+Configuration Guide
+###################
+
+The YAML files allow you to edit your server settings.
+They can be found in the :code:`config` directory in your server installation.
+
+After modifying your configuration files, you will need to restart your server to apply the changes.
+
+.. tip::
+
+    If you want the server to simply generate/validate configuration files without starting the server, you can use the
+    :code:`--generate-config` command-line argument.
+
+    Simply add the argument at the end of the :code:`java [...] -jar glowstone.jar` line inside your startup script.
+
+.. toctree::
+    :maxdepth: 2
+    :caption: Contents
+    :titlesonly:
+
+    glowstone_yml/index

FAQ/index.rst

@@ -54,9 +54,7 @@ Failed to bind to address. Maybe it is already in use?
 
 **This error means that you've already got a server running on the port that you've configured.**
 
-More information can be found in the "Server Binding" subsection inside the `First Run`_ section.
-
-.. _`First Run`: ../Getting_Started/first_run.html#bind-fail-error
+More information can be found in the :ref:`Server Binding` subsection inside the First Run section.
 
 Unsupported major.minor version
 -------------------------------

Getting_Started/first_run.rst

@@ -75,7 +75,7 @@ Server Binding
 --------------
 
 Once it is ready, the server will open itself on a TCP port. By default, this is port :code:`25565`, and can be
-changed in the server configuration. For more information, refer to the `Configuration Guide`_ section.
+changed in the server configuration. For more information, refer to the :doc:`../Configuration_Guide/index` section.
 
 .. code-block:: none
 
@@ -86,7 +86,6 @@ changed in the server configuration. For more information, refer to the `Configu
 Once the "Ready for connections." line is output, your server should be reachable by clients.
 
 .. error::
-    :name: bind-fail-error
 
     **Failed to bind to address. Maybe it is already in use?**
 

_static/glowstone.css

@@ -0,0 +1,4 @@
+/* Prevents scrollbar in tables */
+.wy-table-responsive table td, .wy-table-responsive table th {
+    white-space: normal;
+}

conf.py

@@ -40,6 +40,7 @@
 # ones.
 extensions = [
     'sphinx.ext.autodoc',
+    'sphinx.ext.autosectionlabel'
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -157,3 +158,5 @@
 
 
 # -- Extension configuration -------------------------------------------------
+def setup(app):
+    app.add_stylesheet('glowstone.css')

index.rst

@@ -27,3 +27,4 @@ Table of Contents
     Why_Glowstone/index
     Getting_Started/index
     FAQ/index
+    Configuration_Guide/index