tree: c7b88e724e48310f25c48cb0faf638f361c48465 [path history] [tgz]
  1. custom_theme/
  2. docs/
  3. .gitignore
  4. build.sh
  5. index.php
  6. mkdocs.yml
  7. README.md
  8. requirements.txt
mkdocs/README.md

Hawk website

This repository hosts the MkDocs source code for the Eclipse Hawk website.

Development

To work on the website, set up a Python 3 virtualenv environment and install the dependencies through pip:

virtualenv -p python3 env
pip install -r requirements.txt

The virtualenv environment will remain active until you terminate that console session. If you want to continue working on the website, you will need to reactivate the environment with:

source env/bin/activate

Once the virtualenv environment is activated and the project dependencies have been installed, you can start the built-in development server with:

mkdocs serve

Available extensions

The website has a number of useful Markdown extensions enabled:

Deployment

After a new version of the website is ready and before you push, make sure you build it with:

mkdocs build

The repository has an .htaccess file which will silently redirect all requests to go through the site subfolder produced by MkDocs.