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.19.tar.gz
(6.4 kB
view hashes)
Built Distribution
Close
Hashes for include_file-0.0.19-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 26791bb9696a5d844b2f65f6e6f847afe3119c04cb8f4f5a53fa064ce6a4f75a |
|
MD5 | d10d4c2b9e5c87bb1d9a18962d0be6cc |
|
BLAKE2b-256 | 38d2ecabc6c5270bf66f0d1d9ffaf75c6924d9b11ab77a354c9e20e60190de1d |