Skip to content
Decred Development Documentation
Shell Dockerfile
Branch: master
Clone or download

Latest commit

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/workflows Update deps. (#63) Feb 7, 2020
bin init Aug 13, 2019
conf nginx: add gzip types and set charset to utf-8 (#59) Dec 13, 2019
docs simnet: update minimum blocks to coinbase mature (#60) Jan 8, 2020
.dockerignore init Aug 13, 2019
.gitignore Update to mkdocs 1.1.0 (#65) Mar 30, 2020
Dockerfile Update deps. (#63) Feb 7, 2020
LICENSE init Aug 13, 2019
README.md Update to mkdocs 1.1.0 (#65) Mar 30, 2020
mkdocs.yml Adds wallet guide (#50) Oct 26, 2019
requirements.txt Update to mkdocs 1.1.0 (#65) Mar 30, 2020

README.md

dcrdevdocs

Build Status ISC License

dcrdevdocs is source code for the Decred Developers documentation.

dcrdevdocs is built with MkDocs - a documentation toolkit written in Python.

Development

Install Python

In order to develop on dcrdocs you will need Python installed on your system. Version 3.8 is recommended because this is the version used by the live site, however MkDocs does also support versions 3.5 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.8.2
$ pip --version
pip 20.0.2

Install dependencies

To install MkDocs and all of the other Python libraries required by dcrdevdocs:

$ pip install mkdocs && pip install --user -r requirements.txt

Getting started

This 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
[I 160402 15:50:43 server:271] Serving on http://127.0.0.1:8000
[I 160402 15:50:43 handlers:58] Start watching changes
[I 160402 15:50:43 handlers:60] Start detecting changes

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
[I 190207 18:05:35 server:298] Serving on http://127.0.0.1:8000
[I 190207 18:05:35 handlers:59] Start watching changes
[I 190207 18:05:35 handlers:61] Start detecting changes

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.

Deploying

To deploy dcrdevdocs, first build the documentation:

$ ./bin/build_docs.sh

This will build the documentation into a new directory named site.

The version of dcrdevdocs 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.

Docker

dcrdevdocs can also be built and hosted in a Docker container. Build the container using:

$ ./bin/build.sh

The container can then be run with:

$ docker run -d --rm -p <local port>:80 decred/dcrdevdocs:latest

Pages to review upon testnet reset

  • environments/testnet.md

Getting help

To get help with dcrdevdocs please create a GitHub issue or the join the Decred community using your preferred chat platform.

You can’t perform that action at this time.