dcrdocs is source code for the Decred project documentation.
dcrdocs is built with MkDocs - a documentation toolkit written in Python.
In order to develop on dcrdocs you will need Python
installed on your system.
Version 3.9 is recommended because this is the version used by the live site,
however MkDocs does also support versions 3.6 and later.
Python 2 is not supported.
You can verify your installation of Python by checking the output from these two commands:
$ python --version
Python 3.9.5
$ pip --version
pip 21.1.2To install MkDocs and all of the other Python libraries required by dcrdocs:
$ pip install mkdocs && pip install --user -r requirements.txtThis repo contains a single configuration file named mkdocs.yml, and a folder named docs that will contain the documentation source files. MkDocs comes with a built-in dev-server that lets you preview the documentation as you work on it. Make sure you are in the same directory as the mkdocs.yml configuration file, and then start the server by running the mkdocs serve command:
$ mkdocs serve
INFO - Building documentation...
INFO - Cleaning site directory
INFO - Documentation built in 9.09 seconds
INFO - [13:26:55] Serving on http://127.0.0.1:8000/If you are using Windows, you may need to inform python to search sys.path for the mkdocs module:
$ python -m mkdocs serve
INFO - Building documentation...
INFO - Cleaning site directory
INFO - Documentation built in 9.09 seconds
INFO - [13:26:55] Serving on http://127.0.0.1:8000/Open up http://127.0.0.1:8000 in your browser, and you will see the documentation home page being displayed. The dev-server also supports auto-reloading, and will rebuild your documentation whenever anything in the configuration file or the documentation directory changes.
In general, stick to standard Markdown formatting. However, these docs use Material for Mkdocs, so consult their documentation if you need additional formatting tools.
To deploy dcrdocs, first build the documentation:
$ ./bin/build_docs.shThis will build the documentation into a new directory named site.
The version of dcrdocs that you just built only uses static files which are all contained within the site/ directory, so this directory can be hosted using almost any web server software.
dcrdocs can also be built and hosted in a Docker container. Build the container using:
$ ./bin/build.shThe container can then be run with:
$ docker run -d --rm -p <local port>:80 decred/dcrdocs:latestadvanced/manual-cli-install.mdwallets/cli/dcrd-and-dcrwallet-cli-arguments.mdwallets/cli/dcrctl-rpc-commands.mdwallets/cli/cli-installation.mdadvanced/solo-proof-of-stake-voting.mdadvanced/verifying-binaries.mdadvanced/secure-cold-wallet-setup.md
advanced/solo-proof-of-stake-voting.md
wallets/decrediton/decrediton-setup.mdwallets/decrediton/using-decrediton.mdwallets/decrediton/decrediton-troubleshooting.md
lightning-network/dcrlncli/options-and-commands.md
To get help with dcrdocs please create a GitHub issue or join the Decred community using your preferred chat platform.