Guides and Documentation developed by and for Tilde Black https://tilde.black/docs
Go to file
James Tomasino 5b5013f053 adds samizdat to docs 2020-07-08 23:47:58 +00:00
custom_theme adds samizdat to docs 2020-07-08 23:47:58 +00:00
docs clarify email for signup 2020-07-08 23:31:20 +00:00
.gitignore ignore virtualenv directory 2019-07-30 22:55:27 +00:00
README.md contribution updates 2019-07-30 23:47:05 +00:00
activate adding virtualenv and easy-installer 2019-07-30 22:54:52 +00:00
favicon.ico added favicon to docs 2019-08-01 12:59:13 +00:00
mkdocs.yml adds samizdat to docs 2020-07-08 23:47:58 +00:00
requirements.txt updated theme 2019-07-30 23:04:32 +00:00

README.md

Tilde Black Documentation

This repository holds the outward facing guides built by users of https://tilde.black.

Local Development

Running the docs

  1. You should have python3 pip3 and virtualenv installed on your system.

  2. Fork this repository & clone it to your system.

  3. Change to the repository directory and run source ./activate to install all the dependencies and activate your virtual environment for python.

  4. Finally, run:

    $ mkdocs serve

This will launch a local running version of the documentation on https://localhost:8000. As you make changes to the documentation your changes will appear in your local server.

To quit your virtual environment just run the command "deactivate" in your shell.

Submitting changes

If you would like to contribute to these guides you do not need an account on tilde.black, but you may benefit from discussion in the private forums on that platform. To contribute, clone this repository, make any desired changes, and submit a pull-request.

If you are a member of tilde.black you can create an ssh key on the system, an account on tildegit.org, and maintain your anonymity by performing the pull-request with that account.

Finally, if you would like to send a patch via email or even just content in markdown via email, you can send that content to fox.