2019-03-30 02:40:11 +00:00
|
|
|
# gVisor Website
|
|
|
|
|
|
|
|
This repository holds the content for the gVisor website. It uses
|
|
|
|
[hugo](https://gohugo.io/) to generate the website and
|
|
|
|
[Docsy](https://github.com/google/docsy) as the theme.
|
|
|
|
|
2019-12-06 14:14:33 +00:00
|
|
|
## Using Github
|
2019-03-30 02:40:11 +00:00
|
|
|
|
2019-12-06 14:14:33 +00:00
|
|
|
The easiest way to contribute to the documentation is to use the "Edit this
|
|
|
|
page" link on any documentation page to edit the page content directly via
|
|
|
|
GitHub and submit a pull request. This should generally be done for changes to
|
|
|
|
a single page.
|
2019-03-30 02:40:11 +00:00
|
|
|
|
2019-12-06 14:14:33 +00:00
|
|
|
## Using Git
|
2019-03-30 02:40:11 +00:00
|
|
|
|
2019-04-03 06:32:50 +00:00
|
|
|
You can submit pull requests by making changes in a Git branch. See more
|
|
|
|
information on GitHub pull requests
|
|
|
|
[here](https://help.github.com/en/articles/about-pull-requests).
|
|
|
|
|
|
|
|
Documentation is located in the [content/docs/](content/docs/) directory.
|
|
|
|
Documentation is written in markdown with hugo extensions. Please read more
|
|
|
|
about [content management](https://gohugo.io/categories/content-management) in
|
|
|
|
the hugo documentation.
|
2019-03-30 02:40:11 +00:00
|
|
|
|
2019-12-06 14:14:33 +00:00
|
|
|
### Requirements
|
2019-03-30 02:40:11 +00:00
|
|
|
|
2019-12-06 14:14:33 +00:00
|
|
|
Building the website requires [Docker](https://www.docker.com/). Please
|
|
|
|
[install](https://docs.docker.com/install/) it before building.
|
2019-03-30 02:40:11 +00:00
|
|
|
|
2019-12-06 14:14:33 +00:00
|
|
|
### Building
|
2019-03-30 02:40:11 +00:00
|
|
|
|
2019-12-06 14:14:33 +00:00
|
|
|
If you want to simply build the website, you can do that using `make`. This
|
|
|
|
will output the App Engine application code, configuration, and html and CSS
|
|
|
|
into the `public/` directory.
|
2019-03-30 02:40:11 +00:00
|
|
|
|
|
|
|
```
|
2019-04-03 06:32:50 +00:00
|
|
|
make
|
2019-03-30 02:40:11 +00:00
|
|
|
```
|
|
|
|
|
2019-12-06 14:14:33 +00:00
|
|
|
### Testing
|
|
|
|
|
|
|
|
You can use the hugo web server for testing documentation or style changes.
|
|
|
|
This will start a webserver that will rebuild the site when you make content
|
|
|
|
changes:
|
2019-03-30 02:40:11 +00:00
|
|
|
|
|
|
|
```
|
2019-12-06 14:14:33 +00:00
|
|
|
make devserver
|
2019-03-30 02:40:11 +00:00
|
|
|
```
|
|
|
|
|
2019-04-03 06:32:50 +00:00
|
|
|
Access the site at http://localhost:8080
|
2019-04-14 22:51:22 +00:00
|
|
|
|
2019-12-06 14:14:33 +00:00
|
|
|
If you need to test all functionality including redirects you can start the App
|
|
|
|
Engine app locally. However, you will need to restart the app when making
|
|
|
|
content changes:
|
2019-04-14 22:51:22 +00:00
|
|
|
|
|
|
|
```
|
2019-12-06 14:14:33 +00:00
|
|
|
make server
|
2019-04-14 22:51:22 +00:00
|
|
|
```
|