diff --git a/doc/conf.py b/doc/conf.py index 5e4636cc..e92959b8 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -13,7 +13,10 @@ author = 'Daniel Barlow' # -- General configuration --------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration -extensions = [] +extensions = [ + 'sphinx.ext.autosectionlabel' +] +autosectionlabel_prefix_document = True templates_path = ['_templates'] exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store'] diff --git a/doc/tutorial.rst b/doc/tutorial.rst index 32a5e3b7..546d332a 100644 --- a/doc/tutorial.rst +++ b/doc/tutorial.rst @@ -306,6 +306,8 @@ machine, which for a test/demo system might involve a second network device in your build system - USB ethernet adapters are cheap - or a bit of messing around unplugging cables.) +For more information about :code:`liminix-rebuild`, see the manual section :ref:`admin:Rebuilding the system`. + Final thoughts ************** @@ -315,11 +317,6 @@ Final thoughts :file:`examples/rotuer,arhcive,extneder.nix` are based on some actual real hosts in my home network. -* These example images are not writable. Later we will explain how to - generate an image that can be changed after installation, and - even use :command:`liminix-rebuild` (analogous to :command:`nixos-rebuild`) - to keep it up to date. - * The technique used here for flashing was chosen mostly because it doesn't need much infrastructure/tooling, but it is a bit of a faff (requires physical access, vendor specific). There are slicker ways