monkey/docs/README.md

1.4 KiB

Monkey documentation

This folder contains the Monkey Documentation site. The site is based on Hugo and the learn theme.

Directory Structure

The most important directory is content: This is the directory which contains the content files. Read this to understand how pages are organized in that folder.

How to contribute

Requirements

You have to install hugo and a text editor that's good for markdown (vscode and vim are good options).

Add content

Run hugo new folder/page.md. Optionally add --kind chapter if this is a new chapter page. For example, hugo new usage/getting-started.md created the Getting Started page.

Editing content

Edit the markdown file(s). Here's a markdown cheatsheet. If you want to add images, add them to the static/images folder and refer to them by name.

Test the content locally

Run hugo server -D. The server will be available locally at http://localhost:1313/infectionmonkey/docs/. You can change the content and the site will refresh automatically

Build the content

Run hugo. This will create a static site in the public directory. This directory should be ignored by git - make sure you don't add and commit it by mistake!