Fix invalid links reported by linkcheck.
(Introduced the extlinks extension for handling manpage links.)
This commit is contained in:
parent
d2637daa0a
commit
162a2e9a79
|
@ -122,6 +122,7 @@ custom_linkcheck_anchors_ignore_for_url = [
|
||||||
# Add extensions
|
# Add extensions
|
||||||
custom_extensions = [
|
custom_extensions = [
|
||||||
'sphinx.ext.intersphinx',
|
'sphinx.ext.intersphinx',
|
||||||
|
'sphinx.ext.extlinks'
|
||||||
]
|
]
|
||||||
|
|
||||||
# Add files or directories that should be excluded from processing.
|
# Add files or directories that should be excluded from processing.
|
||||||
|
@ -172,3 +173,7 @@ root_doc = 'index'
|
||||||
# can be copied even if they don't contain an EOF line.
|
# can be copied even if they don't contain an EOF line.
|
||||||
copybutton_prompt_text = '$ '
|
copybutton_prompt_text = '$ '
|
||||||
copybutton_only_copy_prompt_lines = False
|
copybutton_only_copy_prompt_lines = False
|
||||||
|
|
||||||
|
extlinks = {
|
||||||
|
'manualpage': ( 'https://manpages.ubuntu.com/manpages/lunar/en/%s', '' )
|
||||||
|
}
|
||||||
|
|
|
@ -5,7 +5,7 @@ Operating the Server installer
|
||||||
|
|
||||||
This document explains how to use the installer in general terms. For a
|
This document explains how to use the installer in general terms. For a
|
||||||
step-by-step guide through the screens of the installer, you can use our
|
step-by-step guide through the screens of the installer, you can use our
|
||||||
`screen-by-screen reference guide <https://discourse.ubuntu.com/t/draft-using-the-server-installer-step-by-step/16690>`_.
|
`screen-by-screen reference guide <https://discourse.ubuntu.com/t/screen-by-screen-installer-guide/16690>`_.
|
||||||
|
|
||||||
Get the installer
|
Get the installer
|
||||||
=================
|
=================
|
||||||
|
|
|
@ -83,7 +83,7 @@ constructive feedback.
|
||||||
development/index
|
development/index
|
||||||
|
|
||||||
.. Links:
|
.. Links:
|
||||||
.. _Code of Conduct: https://ubuntu.com/community/code-of-conduct
|
.. _Code of Conduct: https://ubuntu.com/community/ethos/code-of-conduct
|
||||||
.. _Ubuntu Foundations: https://discourse.ubuntu.com/c/foundations/
|
.. _Ubuntu Foundations: https://discourse.ubuntu.com/c/foundations/
|
||||||
.. _Libera.Chat: https://libera.chat/
|
.. _Libera.Chat: https://libera.chat/
|
||||||
.. _CONTRIBUTING.md: https://github.com/canonical/subiquity/blob/main/CONTRIBUTING.md
|
.. _CONTRIBUTING.md: https://github.com/canonical/subiquity/blob/main/CONTRIBUTING.md
|
||||||
|
|
|
@ -144,8 +144,7 @@ installed will not have a keyboard at all in which case the value used here
|
||||||
does not matter.
|
does not matter.
|
||||||
|
|
||||||
The mapping's keys correspond to settings in the :file:`/etc/default/keyboard`
|
The mapping's keys correspond to settings in the :file:`/etc/default/keyboard`
|
||||||
configuration file. See
|
configuration file. See the :manualpage:`keyboard(5) manual page <man5/keyboard.5.html>`
|
||||||
`its manual page <http://manpages.ubuntu.com/manpages/keyboard.5.html>`_
|
|
||||||
for more details.
|
for more details.
|
||||||
|
|
||||||
The mapping contains keys:
|
The mapping contains keys:
|
||||||
|
@ -635,10 +634,9 @@ password
|
||||||
The password for the new user, encrypted. This is required for use with
|
The password for the new user, encrypted. This is required for use with
|
||||||
``sudo``, even if SSH access is configured.
|
``sudo``, even if SSH access is configured.
|
||||||
|
|
||||||
The crypted password string must conform to what
|
The crypted password string must conform to what the
|
||||||
`passwd <https://manpages.ubuntu.com/manpages/passwd.1.html>`_
|
``passwd`` command requires. See the :manualpage:`passwd(1) manual page <man1/passwd.1.html>`
|
||||||
expects. Depending on the special characters in the password hash, quoting may
|
for details. Quote the password hash to ensure correct treatment of any special characters.
|
||||||
be required, so it's safest to just always include the quotes around the hash.
|
|
||||||
|
|
||||||
Several tools can generate the crypted password, such as ``mkpasswd`` from the
|
Several tools can generate the crypted password, such as ``mkpasswd`` from the
|
||||||
``whois`` package, or ``openssl passwd``.
|
``whois`` package, or ``openssl passwd``.
|
||||||
|
|
|
@ -65,7 +65,7 @@ Create a bootable USB
|
||||||
|
|
||||||
There are many ways to boot the installer but the simplest and most common way
|
There are many ways to boot the installer but the simplest and most common way
|
||||||
is to
|
is to
|
||||||
`create a bootable USB stick <https://ubuntu.com/tutorials/tutorial-create-a-usb-stick-on-ubuntu>`_
|
`create a bootable USB stick <https://ubuntu.com/tutorials/create-a-usb-stick-on-ubuntu>`_
|
||||||
to boot the system to be installed with
|
to boot the system to be installed with
|
||||||
(`tutorials for other operating systems <https://ubuntu.com/search?q=%22create+a+bootable+USB+stick%22>`_
|
(`tutorials for other operating systems <https://ubuntu.com/search?q=%22create+a+bootable+USB+stick%22>`_
|
||||||
are also available).
|
are also available).
|
||||||
|
|
|
@ -15,7 +15,7 @@ This screen selects the language for the installer and the default language
|
||||||
for the installed system.
|
for the installed system.
|
||||||
|
|
||||||
More languages can be displayed if you
|
More languages can be displayed if you
|
||||||
`connect via SSH <https://discourse.ubuntu.com/t/draft-using-the-server-installer/16689#connect-via-ssh>`_.
|
`connect via SSH <https://discourse.ubuntu.com/t/how-to-operate-the-server-installer/16689#connect-via-ssh>`_.
|
||||||
|
|
||||||
Refresh
|
Refresh
|
||||||
=======
|
=======
|
||||||
|
|
Loading…
Reference in New Issue