mirror of https://github.com/docker/docs.git
Added minor changes to the README.md file:
- Added a note about the nokogiri package dependencies when using Bundler. - Reorganized the whole "Use Jekyll directly" section for better readability.
This commit is contained in:
parent
4667b5f7f2
commit
c193e3c593
40
README.md
40
README.md
|
@ -101,7 +101,7 @@ The following `vnext` branches currently exist:
|
||||||
docs for upcoming features in the [docker/kitematic](https://github.com/docker/kitematic/)
|
docs for upcoming features in the [docker/kitematic](https://github.com/docker/kitematic/)
|
||||||
project
|
project
|
||||||
|
|
||||||
## Per-PR staging on Github
|
## Per-PR staging on GitHub
|
||||||
|
|
||||||
For every PR against `master` and all the long-lived branches, a staged version
|
For every PR against `master` and all the long-lived branches, a staged version
|
||||||
of the site is built using Netlify. If the site builds, you will see
|
of the site is built using Netlify. If the site builds, you will see
|
||||||
|
@ -136,10 +136,40 @@ You have three options:
|
||||||
docker-compose down
|
docker-compose down
|
||||||
```
|
```
|
||||||
|
|
||||||
2. Use Jekyll directly. Clone this repo, [install Ruby 2.3 or higher
|
2. Use Jekyll directly.
|
||||||
(required)](https://www.ruby-lang.org/en/documentation/installation/),
|
|
||||||
[install the GitHub Pages Ruby gem](https://help.github.com/articles/setting-up-your-github-pages-site-locally-with-jekyll/),
|
a. Clone this repo by running:
|
||||||
then run `jekyll serve` from within the directory.
|
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/docker/docker.github.io.git
|
||||||
|
```
|
||||||
|
|
||||||
|
b. Install Ruby 2.3 or later as described in [Installing Ruby]
|
||||||
|
(https://www.ruby-lang.org/en/documentation/installation/).
|
||||||
|
|
||||||
|
c. Install Bundler:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
gem install bundler
|
||||||
|
```
|
||||||
|
d. If you use Ubuntu, install packages required for the Nokogiri HTML
|
||||||
|
parser:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo apt-get install ruby-dev zlib1g-dev liblzma-dev
|
||||||
|
```
|
||||||
|
|
||||||
|
e. Install Jekyll and other required dependencies:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
bundle install
|
||||||
|
```
|
||||||
|
|
||||||
|
>**Note**: You may have to install some packages manually.
|
||||||
|
|
||||||
|
f. Change the directory to `docker.github.io`.
|
||||||
|
|
||||||
|
g. Use the `jekyll serve` command to continuously build the HTML output.
|
||||||
|
|
||||||
The `jekyll serve` process runs in the foreground, and starts a web server
|
The `jekyll serve` process runs in the foreground, and starts a web server
|
||||||
running on http://localhost:4000/ by default. To stop it, use `CTRL+C`.
|
running on http://localhost:4000/ by default. To stop it, use `CTRL+C`.
|
||||||
|
|
Loading…
Reference in New Issue