Replace {% include 'file.txt' %} with actual file contents
Project description
Include File
- While using Gitbook, I faced some challenges below
- Some information (ex: setting up git command) might come up in multiple documentation
- Try Global Include
- Organize include contents more intuitively
- Try Stem Include
- Need table of contents page of entire gitbook
- Try Global Include
Github CI
- This pipeline will push to deploy branch
# .github/workflows/main.yml
name: Deploy to deploy branch with include_file
on:
push:
branches: ["main"]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Set up Python 3.9
uses: actions/setup-python@v2
with:
python-version: "3.9"
- name: Install dependencies
run: |
python -m pip install --upgrade pip
pip install include_file
- name: Include File
run: |
python -m include_file -u $GITHUB_ACTOR -y SUMMARY.md -d deploy -t README.md --stem
# For deployment add following lines
- uses: EndBug/add-and-commit@v7
with:
message: "Committed by seanhwangg/include_file"
pull_strategy: NO-PULL
branch: deploy
push: origin deploy --force -u
Flags
-
user
- -u: github user id used for link ([ex] seanhwangg)
-
glob
- -g: Which glob files to include ([ex] "**/*", **/*.md)
-
path
- -p: Where to look for include file ([ex] ./.include-file/)
-
stem
- -s: Use stem of markdown to overwrite path ([ex] False)
- includes for
REAMD.md
are stored inREADME/include.txt
-
validate
- -v: Whether to fail CI in case of include error ([ex] True)
Gitbook Only Flags
Note: These are completely optional for Gitbook users
-
deploy_branch
- -d: Change deploy_branch of gitbook ([ex] "deploy")
-
url_path
- -url: Change url of includes ([ex] https://seanhwangg.gitbook.io/)
-
table_of_contents
- -toc: Create table of contents with URL ([ex] "", "table_of_contents.md")
-
images_overwrite
- -images: Overwrite default
images
([ex] images)
- -images: Overwrite default
-
include_overwrite
- -include: Overwrite default
include
([ex] include)
- -include: Overwrite default
-
link_overwrite
- -link: Overwrite default
link
([ex] link)
- -link: Overwrite default
-
repo_overwrite
- -repo: Overwrite default
repo
([ex] repo)
- -repo: Overwrite default
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
include-file-0.0.20.tar.gz
(6.5 kB
view hashes)
Built Distribution
Close
Hashes for include_file-0.0.20-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 058e433e6835a82cda680cb89aa33df11a370668241bf93873644bf176f20b44 |
|
MD5 | 7cca5bb2c918cd67c40e29d493b68408 |
|
BLAKE2b-256 | 95d8b041489c897a8005e73c7a90265f4438aafc9c60bf8fce942ca631b77ffb |