Edit README.md

- Use ordered list for instructions
- Other formatting changes
pull/570/head
pierwill 2019-10-30 09:01:05 -07:00
parent e8941ae6c9
commit ba63fa57a5
1 changed files with 31 additions and 30 deletions

View File

@ -6,44 +6,45 @@
This repository contains the InfluxDB 2.x documentation published at [docs.influxdata.com](https://docs.influxdata.com).
## Contributing
We welcome and encourage community contributions. For information about contributing to the InfluxData documentation, see [Contribution guidelines](CONTRIBUTING.md).
We welcome and encourage community contributions.
For information about contributing to the InfluxData documentation, see [Contribution guidelines](CONTRIBUTING.md).
## Reporting a Vulnerability
InfluxData takes security and our users' trust very seriously.
If you believe you have found a security issue in any of our open source projects,
please responsibly disclose it by contacting security@influxdata.com.
More details about security vulnerability reporting,
including our GPG key, can be found here. https://www.influxdata.com/how-to-report-security-vulnerabilities/
InfluxData takes security and our users' trust very seriously.
If you believe you have found a security issue in any of our open source projects,
please responsibly disclose it by contacting security@influxdata.com.
More details about security vulnerability reporting,
including our GPG key, can be found at https://www.influxdata.com/how-to-report-security-vulnerabilities/.
## Run the docs locally
The InfluxData documentation uses [Hugo](https://gohugo.io/), a static site
generator built in Go.
## Running the docs locally
### Clone this repository
[Clone this repository](https://help.github.com/articles/cloning-a-repository/)
to your local machine.
1. [**Clone this repository**](https://help.github.com/articles/cloning-a-repository/) to your local machine.
### Install Hugo
See the Hugo documentation for information about how to
[download and install Hugo](https://gohugo.io/getting-started/installing/).
2. **Install Hugo**
### Install NodeJS & Asset Pipeline Tools
This project uses tools written in NodeJS to build and process stylesheets and javascript.
In order for assets to build correctly, [install NodeJS](https://nodejs.org/en/download/)
and run the following command to install the necessary tools:
The InfluxData documentation uses [Hugo](https://gohugo.io/), a static site generator built in Go.
See the Hugo documentation for information about how to [download and install Hugo](https://gohugo.io/getting-started/installing/).
```sh
npm i -g postcss-cli autoprefixer
```
3. **Install NodeJS & Asset Pipeline Tools**
### Start the hugo server
Hugo provides a local development server that generates the HTML pages, builds
the static assets, and serves them at `localhost:1313`.
This project uses tools written in NodeJS to build and process stylesheets and javascript.
In order for assets to build correctly, [install NodeJS](https://nodejs.org/en/download/)
and run the following command to install the necessary tools:
Start the hugo server with:
```
npm i -g postcss-cli autoprefixer
```
```bash
hugo server
```
4. **Start the Hugo server**
View the docs at [localhost:1313](http://localhost:1313).
Hugo provides a local development server that generates the HTML pages, builds
the static assets, and serves them at `localhost:1313`.
Start the Hugo server from the repository:
```
$ cd docs-v2/
$ hugo server
```
View the docs at [localhost:1313](http://localhost:1313).