nixos/trezord: convert manual chapter to MD

pennae a553f57c 77ee5a14

Changed files
+43 -23
nixos
modules
services
+17
nixos/modules/services/hardware/trezord.md
···
···
+
# Trezor {#trezor}
+
+
Trezor is an open-source cryptocurrency hardware wallet and security token
+
allowing secure storage of private keys.
+
+
It offers advanced features such U2F two-factor authorization, SSH login
+
through
+
[Trezor SSH agent](https://wiki.trezor.io/Apps:SSH_agent),
+
[GPG](https://wiki.trezor.io/GPG) and a
+
[password manager](https://wiki.trezor.io/Trezor_Password_Manager).
+
For more information, guides and documentation, see <https://wiki.trezor.io>.
+
+
To enable Trezor support, add the following to your {file}`configuration.nix`:
+
+
services.trezord.enable = true;
+
+
This will add all necessary udev rules and start Trezor Bridge.
+2
nixos/modules/services/hardware/trezord.nix
···
### docs
meta = {
doc = ./trezord.xml;
};
···
### docs
meta = {
+
# Don't edit the docbook xml directly, edit the md and generate it:
+
# `pandoc trezord.md -t docbook --top-level-division=chapter --extract-media=media -f markdown-smart --lua-filter ../../../../doc/build-aux/pandoc-filters/myst-reader/roles.lua --lua-filter ../../../../doc/build-aux/pandoc-filters/docbook-writer/rst-roles.lua > trezord.xml`
doc = ./trezord.xml;
};
+24 -23
nixos/modules/services/hardware/trezord.xml
···
-
<chapter xmlns="http://docbook.org/ns/docbook"
-
xmlns:xlink="http://www.w3.org/1999/xlink"
-
xmlns:xi="http://www.w3.org/2001/XInclude"
-
version="5.0"
-
xml:id="trezor">
-
<title>Trezor</title>
-
<para>
-
Trezor is an open-source cryptocurrency hardware wallet and security token
-
allowing secure storage of private keys.
-
</para>
-
<para>
-
It offers advanced features such U2F two-factor authorization, SSH login
-
through
-
<link xlink:href="https://wiki.trezor.io/Apps:SSH_agent">Trezor SSH agent</link>,
-
<link xlink:href="https://wiki.trezor.io/GPG">GPG</link> and a
-
<link xlink:href="https://wiki.trezor.io/Trezor_Password_Manager">password manager</link>.
-
For more information, guides and documentation, see <link xlink:href="https://wiki.trezor.io"/>.
-
</para>
-
<para>
-
To enable Trezor support, add the following to your <filename>configuration.nix</filename>:
-
<programlisting>
services.trezord.enable = true;
</programlisting>
-
This will add all necessary udev rules and start Trezor Bridge.
-
</para>
</chapter>
···
+
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="trezor">
+
<title>Trezor</title>
+
<para>
+
Trezor is an open-source cryptocurrency hardware wallet and security
+
token allowing secure storage of private keys.
+
</para>
+
<para>
+
It offers advanced features such U2F two-factor authorization, SSH
+
login through
+
<link xlink:href="https://wiki.trezor.io/Apps:SSH_agent">Trezor SSH
+
agent</link>,
+
<link xlink:href="https://wiki.trezor.io/GPG">GPG</link> and a
+
<link xlink:href="https://wiki.trezor.io/Trezor_Password_Manager">password
+
manager</link>. For more information, guides and documentation, see
+
<link xlink:href="https://wiki.trezor.io" role="uri">https://wiki.trezor.io</link>.
+
</para>
+
<para>
+
To enable Trezor support, add the following to your
+
<filename>configuration.nix</filename>:
+
</para>
+
<programlisting>
services.trezord.enable = true;
</programlisting>
+
<para>
+
This will add all necessary udev rules and start Trezor Bridge.
+
</para>
</chapter>