Skip to content

Commit 3cc46f0

Browse files
committed
Update Readme
Signed-off-by: yubiuser <[email protected]>
1 parent 4060b4d commit 3cc46f0

File tree

3 files changed

+8
-16
lines changed

3 files changed

+8
-16
lines changed

.devcontainer/Dockerfile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ RUN apk add --no-cache \
77
py3-pip \
88
tzdata
99

10-
ENV USER node
10+
ENV USER=node
1111
USER ${USER}
1212

1313
# python packages (as zensical) are installed in the user's home directory

.github/workflows/codespell.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,4 +17,4 @@ jobs:
1717
uses: codespell-project/actions-codespell@8f01853be192eb0f849a5c7d721450e7a467c579 #v2.2
1818
with:
1919
ignore_words_file: .codespellignore
20-
skip: ./docs/routers/fritzbox-de.md,./mkdocs.yml,./package.json,./package-lock.json,./.markdownlint.json,./requirements.txt, ./MathJax-es5/*
20+
skip: ./docs/routers/fritzbox-de.md,./zensical.toml,./package.json,./package-lock.json,./.markdownlint.json,./requirements.txt

README.md

Lines changed: 6 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ This repo is the source for the official [Pi-hole documentation](https://docs.pi
1414

1515
### How to contribute
1616

17-
To add a new link on the navigation panel you need to edit the `mkdocs.yml` file in the root of the repo. There is a guide for building the navbar [on the mkdocs wiki](https://www.mkdocs.org/user-guide/configuration/#nav)
17+
To add a new link on the navigation panel you need to edit the `zensical.toml` file in the root of the repo. There is a guide for building the navbar [on the zensical documentation](https://zensical.org/docs/setup/navigation/)
1818

1919
To add a new document or guide.
2020

@@ -26,7 +26,7 @@ To add a new document or guide.
2626

2727
### Testing your changes
2828

29-
When working on this repo, it is advised that you review your changes locally before committing them. The `mkdocs serve` command can be used to live preview your changes (as you type) on your local machine.
29+
When working on this repo, it is advised that you review your changes locally before committing them. The `zensical serve` command can be used to live preview your changes (as you type) on your local machine.
3030

3131
Please make sure you fork the repo and change the clone URL in the example below for your fork:
3232

@@ -51,7 +51,7 @@ Please make sure you fork the repo and change the clone URL in the example below
5151
- Running the docs server:
5252

5353
```bash
54-
mkdocs serve --dev-addr 0.0.0.0:8000
54+
zensical serve --dev-addr 0.0.0.0:8000
5555
```
5656

5757
- Fedora Linux instructions (tested on Fedora Linux 28):
@@ -66,20 +66,12 @@ Please make sure you fork the repo and change the clone URL in the example below
6666
- Running the docs server:
6767

6868
```bash
69-
mkdocs serve --dev-addr 0.0.0.0:8000
69+
zensical serve --dev-addr 0.0.0.0:8000
7070
```
7171

72-
- Docker instructions:
73-
- One-shot run:
72+
- Docker devcontainer instructions:
73+
- We provide a `devcontainer.json` and a dockerfile which will setup the required development environment for an easy deployment. Devcontainers can be used with various editors, e.g. VS Code
7474

75-
```bash
76-
docker run -v `pwd`:/opt/app/ -w /opt/app/ -p 8000:8000 -it nikolaik/python-nodejs:python3.7-nodejs16 \
77-
sh -c "pip install --user -r requirements.txt && \
78-
/root/.local/bin/mkdocs build && \
79-
npm ci && \
80-
npm test && \
81-
/root/.local/bin/mkdocs serve --dev-addr 0.0.0.0:8000"
82-
```
8375

8476
After these commands, the current branch is accessible through your favorite browser at <http://localhost:8000>
8577

0 commit comments

Comments
 (0)