Quick-start guide

Docpress is available via npm. It requires Node.js 8.0 or higher.

npm install -g docpress

Local installation

You can install Docpress locally in your project. This is optional, but greatly preferred. If Docpress is found in the current project, the docpress command will use the docpress installed in your current project.

npm init  # ...if you don't have package.json
npm install --save-dev --save-exact docpress

Also, Docpress builds your output into _docpress, which you probably don’t want to commit.

echo _docpress >> .gitignore

Writing content

Write your first page. This is usually your project’s README.md. This is a simple Markdown file. Chances are you already have this! You can add more pages later by creating a Table of Contents file (docs/README.md, see Writing more pages).

Pages are written in Markdown–an easy-to-read, easy-to-write plain text format. Files have the extension .md. Learn more about Markdown in GitHub’s Markdown Basics guide.

README.md
My project
==========

This is my project and it is wonderful! Save this file as `README.md`.

Generally this file has your project name, a summary, some badges, a screenshot and maybe author/contributor information and how to contribute as well as licensing information.

Previewing your site

Run the local server via docpress s (short for serve). This will build your site into _docpress/ and run a local file server with LiveReload. You can then point your browser to http://localhost:3000.

docpress s

Building your site

Build the documentation via docpress b (short for build). This will build your site into _docpress/.

docpress b

You should now have a basic Docpress website with one page. Let’s write more. Continue →