@zkochan/pnpm
Version:
A fast implementation of npm install
56 lines (35 loc) • 1.72 kB
Markdown
# Quick-start guide
Docpress is available via [npm](https://www.npmjs.com/package/docpress). It requires [Node.js] 4.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.
```sh
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.
```sh
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 (see [Writing more pages](more-pages.md)).
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.
[Markdown basics]: https://help.github.com/articles/markdown-basics/
##### `README.md`
<!-- {.file-heading} -->
```md
My project
==========
This is my project and it is wonderful! Save this file as `README.md`.
```
## 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
```
[Node.js]: http://nodejs.org/
You should now have a basic Docpress website with one page. Let's write more.
[Continue →](more-pages.md)
<!--{p:.pull-box}-->