From 51dc8d4c01f90d22d958d2778aa3152a5094055c Mon Sep 17 00:00:00 2001
From: Abdulbasit sadiq <76534194+Dramoka@users.noreply.github.com>
Date: Wed, 30 Dec 2020 03:23:51 +0100
Subject: [PATCH] Initial commit
---
.devcontainer.json | 12 +
.gitattributes | 2 +
.github/ISSUE_TEMPLATE/bug.md | 20 +
.github/ISSUE_TEMPLATE/feature_request.md | 20 +
.github/ISSUE_TEMPLATE/upgrade.md | 10 +
.github/workflows/chatops.yaml | 195 +++
.github/workflows/check_cdns.yaml | 13 +
.github/workflows/check_config.yaml | 78 +
.github/workflows/ci.yaml | 58 +
.github/workflows/docker-nbdev.yaml | 8 +
.github/workflows/docker.yaml | 33 +
.github/workflows/gh-page.yaml | 17 +
.github/workflows/issue_reminder.yaml | 26 +
.github/workflows/setup.yaml | 105 ++
.github/workflows/upgrade.yaml | 275 ++++
.gitignore | 14 +
CNAME | 1 +
Gemfile | 43 +
Gemfile.lock | 154 ++
LICENSE | 201 +++
Makefile | 53 +
README.md | 553 +++++++
_action_files/Dockerfile | 9 +
_action_files/__init__.py | 0
_action_files/action.yml | 17 +
_action_files/action_entrypoint.sh | 48 +
_action_files/check_js.sh | 25 +
_action_files/fast_template.py | 29 +
_action_files/fastpages-jekyll.Dockerfile | 7 +
_action_files/fastpages.tpl | 22 +
_action_files/hide.tpl | 44 +
_action_files/nb2post.py | 22 +
_action_files/parse_netlify.py | 7 +
_action_files/pr_comment.sh | 39 +
_action_files/settings.ini | 43 +
_action_files/word2post.py | 8 +
_action_files/word2post.sh | 33 +
_action_files/word_front_matter.txt | 3 +
_config.yml | 122 ++
_fastpages_docs/CONTRIBUTING.md | 63 +
_fastpages_docs/DEVELOPMENT.md | 102 ++
_fastpages_docs/NOTEBOOK_FOOTNOTES.md | 30 +
_fastpages_docs/README_TEMPLATE.md | 29 +
_fastpages_docs/TROUBLESHOOTING.md | 66 +
_fastpages_docs/UPGRADE.md | 71 +
_fastpages_docs/_checkbox.png | Bin 0 -> 21148 bytes
_fastpages_docs/_manual_setup.md | 41 +
_fastpages_docs/_paginate.png | Bin 0 -> 6990 bytes
_fastpages_docs/_post_tags.png | Bin 0 -> 21294 bytes
_fastpages_docs/_setup_pr_template.md | 41 +
_fastpages_docs/_show_image_true.png | Bin 0 -> 82874 bytes
_fastpages_docs/_upgrade_pr.md | 14 +
_fastpages_docs/annotate.png | Bin 0 -> 26346 bytes
_fastpages_docs/enable_actions.png | Bin 0 -> 42110 bytes
_fastpages_docs/fastapges-setup.gif | Bin 0 -> 5927801 bytes
_fastpages_docs/highlight_dracula.png | Bin 0 -> 74027 bytes
_fastpages_docs/highlight_original.png | Bin 0 -> 66383 bytes
_fastpages_docs/upgrade_step1.png | Bin 0 -> 34335 bytes
_fastpages_docs/upgrade_step2.png | Bin 0 -> 182730 bytes
_fastpages_docs/upgrade_step3.png | Bin 0 -> 158877 bytes
_fastpages_docs/version.txt | 1 +
_includes/alert.html | 4 +
_includes/custom-head.html | 63 +
_includes/favicons.html | 1 +
_includes/google-analytics.html | 6 +
_includes/head.html | 15 +
_includes/image-r | 11 +
_includes/image.html | 8 +
_includes/important.html | 4 +
_includes/info.html | 4 +
_includes/note.html | 4 +
_includes/notebook_binder_link.html | 5 +
_includes/notebook_colab_link.html | 5 +
_includes/notebook_github_link.html | 9 +
_includes/post_list.html | 9 +
_includes/post_list_image_card.html | 16 +
_includes/reading_time.html | 8 +
_includes/screenshot | 7 +
_includes/tip.html | 4 +
_includes/toc.html | 20 +
_includes/twitter.html | 8 +
_includes/utterances.html | 9 +
_includes/video.html | 3 +
_includes/warning.html | 4 +
_includes/youtube.html | 9 +
_layouts/categories.html | 9 +
_layouts/home.html | 82 +
_layouts/notebook.html | 5 +
_layouts/post.html | 67 +
_notebooks/2020-02-20-test.ipynb | 847 ++++++++++
.../2020-02-21-introducing-fastpages.ipynb | 573 +++++++
_notebooks/2020-09-01-fastcore.ipynb | 1366 +++++++++++++++++
_notebooks/2020-11-17-linkcheck.ipynb | 470 ++++++
_notebooks/README.md | 14 +
_notebooks/fastcore_imgs/bwtm.jpg | Bin 0 -> 16710 bytes
_notebooks/fastcore_imgs/td.png | Bin 0 -> 148691 bytes
.../fastlinkcheck_images/fastlinkcheck.png | Bin 0 -> 55088 bytes
_notebooks/my_icons/fastai_logo.png | Bin 0 -> 7125 bytes
_pages/404.html | 25 +
_pages/about.md | 11 +
_pages/search.html | 18 +
_pages/tags.html | 36 +
_plugins/footnote-detail.rb | 9 +
_plugins/footnote.rb | 15 +
_posts/2020-01-14-test-markdown-post.md | 103 ++
_posts/2020-03-06-fastpages-actions.md | 282 ++++
_posts/2020-12-10-codespaces.md | 114 ++
_posts/README.md | 15 +
_sass/minima/custom-styles.scss | 11 +
_sass/minima/custom-variables.scss | 9 +
_sass/minima/fastpages-dracula-highlight.scss | 222 +++
_sass/minima/fastpages-styles.scss | 258 ++++
...020-01-01-Microsoft-Word-Example-Post.docx | Bin 0 -> 407563 bytes
_word/README.md | 21 +
action.yml | 17 +
assets/badges/binder.svg | 1 +
assets/badges/colab.svg | 1 +
assets/badges/github.svg | 1 +
assets/js/search-data.json | 32 +
assets/js/search.js | 300 ++++
assets/js/vendor/lunr.min.js | 6 +
docker-compose.yml | 44 +
images/chart-preview.png | Bin 0 -> 198493 bytes
images/copied_from_nb/README.md | 3 +
images/diagram.png | Bin 0 -> 42576 bytes
.../fastpages_posts/actions/actions_logo.png | Bin 0 -> 17486 bytes
images/fastpages_posts/actions/pr_1.png | Bin 0 -> 367199 bytes
images/fastpages_posts/actions/pr_2.png | Bin 0 -> 249181 bytes
.../fastpages_posts/codespaces/codespaces.png | Bin 0 -> 47373 bytes
images/favicon.ico | Bin 0 -> 2807 bytes
images/logo.png | Bin 0 -> 7125 bytes
index.html | 15 +
132 files changed, 8065 insertions(+)
create mode 100644 .devcontainer.json
create mode 100644 .gitattributes
create mode 100644 .github/ISSUE_TEMPLATE/bug.md
create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md
create mode 100644 .github/ISSUE_TEMPLATE/upgrade.md
create mode 100755 .github/workflows/chatops.yaml
create mode 100644 .github/workflows/check_cdns.yaml
create mode 100644 .github/workflows/check_config.yaml
create mode 100755 .github/workflows/ci.yaml
create mode 100644 .github/workflows/docker-nbdev.yaml
create mode 100755 .github/workflows/docker.yaml
create mode 100644 .github/workflows/gh-page.yaml
create mode 100644 .github/workflows/issue_reminder.yaml
create mode 100755 .github/workflows/setup.yaml
create mode 100755 .github/workflows/upgrade.yaml
create mode 100644 .gitignore
create mode 100644 CNAME
create mode 100755 Gemfile
create mode 100755 Gemfile.lock
create mode 100644 LICENSE
create mode 100755 Makefile
create mode 100755 README.md
create mode 100755 _action_files/Dockerfile
create mode 100755 _action_files/__init__.py
create mode 100644 _action_files/action.yml
create mode 100755 _action_files/action_entrypoint.sh
create mode 100755 _action_files/check_js.sh
create mode 100755 _action_files/fast_template.py
create mode 100755 _action_files/fastpages-jekyll.Dockerfile
create mode 100644 _action_files/fastpages.tpl
create mode 100644 _action_files/hide.tpl
create mode 100755 _action_files/nb2post.py
create mode 100644 _action_files/parse_netlify.py
create mode 100755 _action_files/pr_comment.sh
create mode 100644 _action_files/settings.ini
create mode 100755 _action_files/word2post.py
create mode 100755 _action_files/word2post.sh
create mode 100644 _action_files/word_front_matter.txt
create mode 100644 _config.yml
create mode 100644 _fastpages_docs/CONTRIBUTING.md
create mode 100644 _fastpages_docs/DEVELOPMENT.md
create mode 100644 _fastpages_docs/NOTEBOOK_FOOTNOTES.md
create mode 100644 _fastpages_docs/README_TEMPLATE.md
create mode 100644 _fastpages_docs/TROUBLESHOOTING.md
create mode 100644 _fastpages_docs/UPGRADE.md
create mode 100644 _fastpages_docs/_checkbox.png
create mode 100644 _fastpages_docs/_manual_setup.md
create mode 100644 _fastpages_docs/_paginate.png
create mode 100644 _fastpages_docs/_post_tags.png
create mode 100644 _fastpages_docs/_setup_pr_template.md
create mode 100644 _fastpages_docs/_show_image_true.png
create mode 100644 _fastpages_docs/_upgrade_pr.md
create mode 100644 _fastpages_docs/annotate.png
create mode 100644 _fastpages_docs/enable_actions.png
create mode 100644 _fastpages_docs/fastapges-setup.gif
create mode 100644 _fastpages_docs/highlight_dracula.png
create mode 100644 _fastpages_docs/highlight_original.png
create mode 100644 _fastpages_docs/upgrade_step1.png
create mode 100644 _fastpages_docs/upgrade_step2.png
create mode 100644 _fastpages_docs/upgrade_step3.png
create mode 100755 _fastpages_docs/version.txt
create mode 100644 _includes/alert.html
create mode 100755 _includes/custom-head.html
create mode 100644 _includes/favicons.html
create mode 100644 _includes/google-analytics.html
create mode 100755 _includes/head.html
create mode 100644 _includes/image-r
create mode 100644 _includes/image.html
create mode 100644 _includes/important.html
create mode 100644 _includes/info.html
create mode 100644 _includes/note.html
create mode 100644 _includes/notebook_binder_link.html
create mode 100644 _includes/notebook_colab_link.html
create mode 100644 _includes/notebook_github_link.html
create mode 100644 _includes/post_list.html
create mode 100644 _includes/post_list_image_card.html
create mode 100644 _includes/reading_time.html
create mode 100644 _includes/screenshot
create mode 100644 _includes/tip.html
create mode 100644 _includes/toc.html
create mode 100644 _includes/twitter.html
create mode 100644 _includes/utterances.html
create mode 100644 _includes/video.html
create mode 100644 _includes/warning.html
create mode 100644 _includes/youtube.html
create mode 100644 _layouts/categories.html
create mode 100644 _layouts/home.html
create mode 100644 _layouts/notebook.html
create mode 100644 _layouts/post.html
create mode 100644 _notebooks/2020-02-20-test.ipynb
create mode 100644 _notebooks/2020-02-21-introducing-fastpages.ipynb
create mode 100755 _notebooks/2020-09-01-fastcore.ipynb
create mode 100755 _notebooks/2020-11-17-linkcheck.ipynb
create mode 100644 _notebooks/README.md
create mode 100644 _notebooks/fastcore_imgs/bwtm.jpg
create mode 100644 _notebooks/fastcore_imgs/td.png
create mode 100755 _notebooks/fastlinkcheck_images/fastlinkcheck.png
create mode 100644 _notebooks/my_icons/fastai_logo.png
create mode 100644 _pages/404.html
create mode 100644 _pages/about.md
create mode 100644 _pages/search.html
create mode 100644 _pages/tags.html
create mode 100644 _plugins/footnote-detail.rb
create mode 100644 _plugins/footnote.rb
create mode 100755 _posts/2020-01-14-test-markdown-post.md
create mode 100755 _posts/2020-03-06-fastpages-actions.md
create mode 100755 _posts/2020-12-10-codespaces.md
create mode 100644 _posts/README.md
create mode 100644 _sass/minima/custom-styles.scss
create mode 100644 _sass/minima/custom-variables.scss
create mode 100755 _sass/minima/fastpages-dracula-highlight.scss
create mode 100755 _sass/minima/fastpages-styles.scss
create mode 100644 _word/2020-01-01-Microsoft-Word-Example-Post.docx
create mode 100644 _word/README.md
create mode 100644 action.yml
create mode 100644 assets/badges/binder.svg
create mode 100644 assets/badges/colab.svg
create mode 100644 assets/badges/github.svg
create mode 100644 assets/js/search-data.json
create mode 100644 assets/js/search.js
create mode 100644 assets/js/vendor/lunr.min.js
create mode 100755 docker-compose.yml
create mode 100644 images/chart-preview.png
create mode 100644 images/copied_from_nb/README.md
create mode 100644 images/diagram.png
create mode 100755 images/fastpages_posts/actions/actions_logo.png
create mode 100755 images/fastpages_posts/actions/pr_1.png
create mode 100755 images/fastpages_posts/actions/pr_2.png
create mode 100755 images/fastpages_posts/codespaces/codespaces.png
create mode 100644 images/favicon.ico
create mode 100644 images/logo.png
create mode 100644 index.html
diff --git a/.devcontainer.json b/.devcontainer.json
new file mode 100644
index 0000000..4c0bf09
--- /dev/null
+++ b/.devcontainer.json
@@ -0,0 +1,12 @@
+{
+ "name": "fastpages-codespaces",
+ "dockerComposeFile": "docker-compose.yml",
+ "service": "watcher",
+ "mounts": [ "source=/var/run/docker.sock,target=/var/run/docker.sock,type=bind" ],
+ "forwardPorts": [4000, 8080],
+ "appPort": [4000, 8080],
+ "extensions": ["ms-python.python",
+ "ms-azuretools.vscode-docker"],
+ "runServices": ["converter", "notebook", "jekyll", "watcher"]
+}
+
diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..09bc62c
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,2 @@
+# Set the default behavior, in case people don't have core.autocrlf set.
+* text=auto
\ No newline at end of file
diff --git a/.github/ISSUE_TEMPLATE/bug.md b/.github/ISSUE_TEMPLATE/bug.md
new file mode 100644
index 0000000..cacde65
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug.md
@@ -0,0 +1,20 @@
+---
+name: Bug
+about: Use this template for filing bugs
+title: ""
+labels: bug
+assignees: ''
+
+---
+
+## Required Prerequisites for filing a bug
+
+### You must follow ALL the steps in the [troubleshooting guide](https://github.com/fastai/fastpages/blob/master/_fastpages_docs/TROUBLESHOOTING.md). Not doing so may result in automatic closure of the issue.
+
+
+## Required information
+
+1. Steps to reproduce the problem
+2. A link to the notebook or markdown file where the error is occurring
+3. If the error is happening in GitHub Actions, a link to the specific error along with how you are able to reproduce this error. You must provide this **in addition to the link to the notebook or markdown file**.
+4. A screenshot / dump of relevant logs or error messages you are receiving from your local development environment. Instructions of running a local development server is provided in the [development guide](https://github.com/fastai/fastpages/blob/master/_fastpages_docs/DEVELOPMENT.md).
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
new file mode 100644
index 0000000..11fc491
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.
diff --git a/.github/ISSUE_TEMPLATE/upgrade.md b/.github/ISSUE_TEMPLATE/upgrade.md
new file mode 100644
index 0000000..6e59c30
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/upgrade.md
@@ -0,0 +1,10 @@
+---
+name: "[fastpages] Automated Upgrade"
+about: "Trigger a PR for upgrading fastpages"
+title: "[fastpages] Automated Upgrade"
+labels: fastpages-automation
+assignees: ''
+
+---
+
+Opening this issue will trigger GitHub Actions to fetch the lastest version of [fastpages](https://github.com/fastai/fastpages). More information will be provided in forthcoming comments below.
diff --git a/.github/workflows/chatops.yaml b/.github/workflows/chatops.yaml
new file mode 100755
index 0000000..4974b2e
--- /dev/null
+++ b/.github/workflows/chatops.yaml
@@ -0,0 +1,195 @@
+name: Chatops
+on: [issue_comment]
+
+jobs:
+ trigger-chatops:
+ if: (github.event.issue.pull_request != null) && contains(github.event.comment.body, '/preview') && (github.repository == 'fastai/fastpages')
+ env:
+ NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
+ NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}
+ CHECK_RUN_NAME: "Draft-Site-Build"
+ runs-on: ubuntu-latest
+ steps:
+
+ - name: see payload
+ run: |
+ echo "FULL PAYLOAD:\n${PAYLOAD}\n"
+ echo "PR_PAYLOAD PAYLOAD:\n${PR_PAYLOAD}"
+ env:
+ PAYLOAD: ${{ toJSON(github.event) }}
+ PR_PAYLOAD: ${{ github.event.pull_request }}
+
+ - name: verify env exists
+ id: get_status
+ run: |
+ if [ -z ${NETLIFY_AUTH_TOKEN} ]; then echo "::set-output name=status::public"; else echo "::set-output name=status::private"; fi
+
+ - name: make comment on PR if env does not exist
+ if: steps.get_status.outputs.status == 'public'
+ run: |
+ ./_action_files/pr_comment.sh "Was not able to generate site preview due to absent credentials."
+ env:
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ ISSUE_NUMBER: ${{ github.event.issue.number }}
+
+ - name: Fetch context about the PR that has been commented on
+ id: chatops
+ uses: machine-learning-apps/actions-chatops@master
+ with:
+ TRIGGER_PHRASE: "/preview"
+ env: # you must supply GITHUB_TOKEN
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+ - name: Set up Python
+ uses: actions/setup-python@v1
+ with:
+ python-version: 3.6
+
+ - name: install requests
+ run: pip3 install requests
+
+ - name: add check run
+ id: create_check
+ if: steps.get_status.outputs.status == 'private'
+ shell: python
+ run: |
+ import os, requests
+
+ sha = os.getenv('SHA')
+ token = os.getenv('GITHUB_TOKEN')
+ nwo = os.getenv('GITHUB_REPOSITORY')
+ name = os.getenv('CHECK_RUN_NAME')
+
+ url = f'https://api.github.com/repos/{nwo}/check-runs'
+
+ headers = {'authorization': f'token {token}',
+ 'accept': 'application/vnd.github.antiope-preview+json'}
+
+ payload = {
+ 'name': f'{name}',
+ 'head_sha': f'{sha}',
+ 'status': 'in_progress',
+ 'output':{
+ 'title': f'Building preview of site for {sha}.',
+ 'summary': ' ',
+ 'text': ' '
+ },
+ }
+ response = requests.post(url=url, headers=headers, json=payload)
+ print(response)
+ id = response.json()['id']
+ print(f"::set-output name=id::{id}")
+ env:
+ SHA: ${{ steps.chatops.outputs.SHA }}
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+ - name: add label
+ if: steps.get_status.outputs.status == 'private'
+ run: |
+ import os, requests
+ nwo = os.getenv('GITHUB_REPOSITORY')
+ token = os.getenv('GITHUB_TOKEN')
+ pr_num = os.getenv('PR_NUM')
+ headers = {'Accept': 'application/vnd.github.symmetra-preview+json',
+ 'Authorization': f'token {token}'}
+ url = f"https://api.github.com/repos/{nwo}/issues/{pr_num}/labels"
+ data = {"labels": ["draft build pending"]}
+ result = requests.post(url=url, headers=headers, json=data)
+ # assert response.status_code == 201, f"Received status code of {response.status_code}"
+ print(result)
+ shell: python
+ env:
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ PR_NUM: ${{ steps.chatops.outputs.PULL_REQUEST_NUMBER }}
+ GITHUB_REPOSITORY: $GITHUB_REPOSITORY
+
+ - name: Copy The PR's Branch Repository Contents
+ uses: actions/checkout@main
+ if: steps.get_status.outputs.status == 'private'
+ with:
+ ref: ${{ steps.chatops.outputs.SHA }}
+
+ - name: convert notebooks and word docs to posts
+ uses: ./ # use the code in this repo to instead of fastai/fastpages@master
+
+ - name: setup directories for Jekyll build
+ if: steps.get_status.outputs.status == 'private'
+ run: |
+ rm -rf _site
+ sudo chmod -R 777 .
+
+ - name: Jekyll build with baseurl as root for netifly
+ if: steps.get_status.outputs.status == 'private'
+ uses: docker://fastai/fastpages-jekyll
+ with:
+ args: bash -c "jekyll build"
+
+ - name: deploy to netlify
+ if: steps.get_status.outputs.status == 'private'
+ id: py
+ run: |
+ sudo npm install netlify-cli -g
+ netlify deploy --dir _site | tee _netlify_logs.txt
+ cat _netlify_logs.txt | python _action_files/parse_netlify.py
+
+ - name: make comment on PR
+ if: steps.get_status.outputs.status == 'private'
+ run: |
+ MSG="A preview build of this branch has been generated for SHA: $SHA and can be viewed **live** at: ${URL}\n\nThe current fastpages site built from master can be viewed for comparison [here](https://fastpages.fast.ai/)"
+ echo "$MSG"
+ ./_action_files/pr_comment.sh "${MSG}"
+ env:
+ URL: ${{ steps.py.outputs.draft_url }}
+ SHA: ${{ steps.chatops.outputs.SHA }}
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ ISSUE_NUMBER: ${{ github.event.issue.number }}
+
+ - name: remove label
+ if: always()
+ run: |
+ import os, requests
+ nwo = os.getenv('GITHUB_REPOSITORY')
+ token = os.getenv('GITHUB_TOKEN')
+ pr_num = os.getenv('PR_NUM')
+ headers = {'Accept': 'application/vnd.github.symmetra-preview+json',
+ 'Authorization': f'token {token}'}
+ url = f"https://api.github.com/repos/{nwo}/issues/{pr_num}/labels/draft%20build%20pending"
+ result = requests.delete(url=url, headers=headers)
+ print(result)
+ shell: python
+ env:
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ PR_NUM: ${{ steps.chatops.outputs.PULL_REQUEST_NUMBER }}
+ GITHUB_REPOSITORY: $GITHUB_REPOSITORY
+
+ # defensively clear check run each time
+ - name: clear check run
+ if: always()
+ continue-on-error: true
+ shell: python
+ run: |
+ import os, requests
+
+ sha = os.getenv('SHA')
+ conclusion = os.getenv('WORKFLOW_CONCLUSION').lower()
+ token = os.getenv('GITHUB_TOKEN')
+ nwo = os.getenv('GITHUB_REPOSITORY')
+ check_run_id = os.getenv('CHECK_RUN_ID')
+ if not check_run_id:
+ quit()
+
+ url = f'https://api.github.com/repos/{nwo}/check-runs/{check_run_id}'
+ headers = {'authorization': f'token {token}',
+ 'accept': 'application/vnd.github.antiope-preview+json'}
+
+ data = {
+ 'conclusion': f'{conclusion}',
+ }
+ response = requests.patch(url=url, headers=headers, json=data)
+ print(response)
+ env:
+ SHA: ${{ steps.chatops.outputs.SHA }}
+ WORKFLOW_CONCLUSION: ${{ job.status }}
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ CHECK_RUN_ID: ${{ steps.create_check.outputs.id }}
+
diff --git a/.github/workflows/check_cdns.yaml b/.github/workflows/check_cdns.yaml
new file mode 100644
index 0000000..f1c954a
--- /dev/null
+++ b/.github/workflows/check_cdns.yaml
@@ -0,0 +1,13 @@
+name: Check CDN
+on:
+# push:
+# schedule:
+# - cron: '1 7,14,21 * * *'
+ workflow_dispatch:
+
+jobs:
+ run:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@main
+ - run: ./_action_files/check_js.sh
diff --git a/.github/workflows/check_config.yaml b/.github/workflows/check_config.yaml
new file mode 100644
index 0000000..f889409
--- /dev/null
+++ b/.github/workflows/check_config.yaml
@@ -0,0 +1,78 @@
+name: Check Configurations
+on: push
+
+jobs:
+ check-config:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@main
+
+ - name: Set up Python
+ uses: actions/setup-python@v1
+ with:
+ python-version: 3.7
+
+ - name: install dependencies
+ run: pip3 install pyyaml
+
+ - name: check baseurl
+ id: baseurl
+ run: |
+ import yaml
+ from pathlib import Path
+ from configparser import ConfigParser
+ settings = ConfigParser()
+
+ config_path = Path('_config.yml')
+ settings_path = Path('_action_files/settings.ini')
+
+ assert config_path.exists(), 'Did not find _config.yml in the current directory!'
+ assert settings_path.exists(), 'Did not find _action_files/settings.ini in the current directory!'
+
+ settings.read(settings_path)
+ with open('_config.yml') as f:
+ config = yaml.safe_load(f)
+
+ errmsg = f"The value set for baseurl in _action_files/settings.ini and _config.yml are not identical. Please fix and try again."
+ assert config['baseurl'] == settings['DEFAULT']['baseurl'], errmsg
+ shell: python
+
+ - name: Create issue if baseurl rule is violated
+ if: steps.baseurl.outcome == 'failure'
+ uses: actions/github-script@0.6.0
+ with:
+ github-token: ${{secrets.GITHUB_TOKEN}}
+ script: |
+ var err = process.env.ERROR_STRING;
+ var run_id = process.env.RUN_ID;
+ github.issues.create({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ title: "Error with repository configuration: baseurl",
+ body: `${err}\n See run [${run_id}](https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${run_id}) for more details.`
+ })
+ env:
+ ERROR_STRING: "You have not configured your baseurl correctly, please read the instructions in _config.yml carefully."
+ RUN_ID: ${{ github.run_id }}
+
+ - name: check for User Pages
+ id: userpage
+ run: |
+ import os
+ nwo = os.getenv('GITHUB_REPOSITORY')
+ errmsg = "fastpages does not support User Pages or repo names that end with github.io, please see https://forums.fast.ai/t/fastpages-replacing-main-username-github-io-page-w-fastpages/64316/3 for more details."
+ assert ".github.io" not in nwo, errmsg
+ shell: python
+
+ - name: Create Issue if User Pages rule is violated
+ if: steps.userpage.outcome == 'failure'
+ uses: actions/github-script@0.6.0
+ with:
+ github-token: ${{secrets.GITHUB_TOKEN}}
+ script: |
+ github.issues.create({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ title: "Error with repository configuration: repo name",
+ body: 'fastpages does not support User Pages or repo names that end with github.io, please see https://forums.fast.ai/t/fastpages-replacing-main-username-github-io-page-w-fastpages/64316/3 for more details.'
+ })
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
new file mode 100755
index 0000000..5eb953b
--- /dev/null
+++ b/.github/workflows/ci.yaml
@@ -0,0 +1,58 @@
+name: CI
+on:
+ push:
+ branches:
+ - master # need to filter here so we only deploy when there is a push to master
+ # no filters on pull requests, so intentionally left blank
+ pull_request:
+ workflow_dispatch:
+
+jobs:
+ build-site:
+ if: ( github.event.commits[0].message != 'Initial commit' ) || github.run_number > 1
+ runs-on: ubuntu-latest
+ steps:
+
+ - name: Check if secret exists
+ if: github.event_name == 'push'
+ run: |
+ if [ -z "$deploy_key" ]
+ then
+ echo "You do not have a secret named SSH_DEPLOY_KEY. This means you did not follow the setup instructions carefully. Please try setting up your repo again with the right secrets."
+ exit 1;
+ fi
+ env:
+ deploy_key: ${{ secrets.SSH_DEPLOY_KEY }}
+
+
+ - name: Copy Repository Contents
+ uses: actions/checkout@main
+ with:
+ persist-credentials: false
+
+ - name: convert notebooks and word docs to posts
+ uses: ./_action_files
+
+ - name: setup directories for Jekyll build
+ run: |
+ rm -rf _site
+ sudo chmod -R 777 .
+
+ - name: Jekyll build
+ uses: docker://fastai/fastpages-jekyll
+ with:
+ args: bash -c "jekyll build -V --strict_front_matter --trace"
+ env:
+ JEKYLL_ENV: 'production'
+
+ - name: copy CNAME file into _site if CNAME exists
+ run: |
+ sudo chmod -R 777 _site/
+ cp CNAME _site/ 2>/dev/null || :
+
+ - name: Deploy
+ if: github.event_name == 'push'
+ uses: peaceiris/actions-gh-pages@v3
+ with:
+ deploy_key: ${{ secrets.SSH_DEPLOY_KEY }}
+ publish_dir: ./_site
diff --git a/.github/workflows/docker-nbdev.yaml b/.github/workflows/docker-nbdev.yaml
new file mode 100644
index 0000000..9849cb3
--- /dev/null
+++ b/.github/workflows/docker-nbdev.yaml
@@ -0,0 +1,8 @@
+name: deprecated
+on: workflow_dispatch
+
+jobs:
+ nothing:
+ runs-on: ubuntu-latest
+ steps:
+ - run: exit 1;
diff --git a/.github/workflows/docker.yaml b/.github/workflows/docker.yaml
new file mode 100755
index 0000000..a2b2075
--- /dev/null
+++ b/.github/workflows/docker.yaml
@@ -0,0 +1,33 @@
+name: Build-Docker
+on:
+ push:
+ paths:
+ - Gemfile*
+ branches:
+ - master
+ pull_request:
+ paths:
+ - Gemfile*
+
+jobs:
+ jekyll-fastpages:
+ if: github.repository == 'fastai/fastpages'
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@main
+
+ - name: setup directories for Jekyll build
+ run: sudo chmod -R 777 .
+
+ - name: build container
+ run: |
+ docker build -t fastai/fastpages-jekyll -f _action_files/fastpages-jekyll.Dockerfile .
+
+ - name: push container
+ if: github.event == 'push'
+ run: |
+ echo ${PASSWORD} | docker login -u $USERNAME --password-stdin
+ docker push fastai/fastpages-jekyll
+ env:
+ USERNAME: ${{ secrets.DOCKER_USERNAME }}
+ PASSWORD: ${{ secrets.DOCKER_PASSWORD }}
diff --git a/.github/workflows/gh-page.yaml b/.github/workflows/gh-page.yaml
new file mode 100644
index 0000000..3fe4340
--- /dev/null
+++ b/.github/workflows/gh-page.yaml
@@ -0,0 +1,17 @@
+name: GH-Pages Status
+on:
+ page_build
+
+jobs:
+ see-page-build-payload:
+ runs-on: ubuntu-latest
+ steps:
+ - name: check status
+ run: |
+ import os
+ status, errormsg = os.getenv('STATUS'), os.getenv('ERROR')
+ assert status == 'built', 'There was an error building the page on GitHub pages.\n\nStatus: {}\n\nError messsage: {}'.format(status, errormsg)
+ shell: python
+ env:
+ STATUS: ${{ github.event.build.status }}
+ ERROR: ${{ github.event.build.error.message }}
diff --git a/.github/workflows/issue_reminder.yaml b/.github/workflows/issue_reminder.yaml
new file mode 100644
index 0000000..4d3683a
--- /dev/null
+++ b/.github/workflows/issue_reminder.yaml
@@ -0,0 +1,26 @@
+
+name: Issue Reminder
+on:
+ issues:
+ types: [opened]
+
+jobs:
+ issue_comment:
+ if: |
+ (github.repository == 'fastai/fastpages')
+ runs-on: ubuntu-latest
+ steps:
+
+ - name: Comment on issue
+ uses: actions/github-script@0.6.0
+ with:
+ github-token: ${{secrets.GITHUB_TOKEN}}
+ script: |
+ var url = 'https://github.com/fastai/fastpages/blob/master/_fastpages_docs/TROUBLESHOOTING.md'
+ var msg = `Thank you for opening an issue. If this issue is related to a bug, please follow the steps and provide the information outlined in the [Troubleshooting Guide](${url}). Failure to follow these instructions may result in automatic closing of this issue.`
+ github.issues.createComment({
+ issue_number: context.issue.number,
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ body: msg
+ })
diff --git a/.github/workflows/setup.yaml b/.github/workflows/setup.yaml
new file mode 100755
index 0000000..230c83c
--- /dev/null
+++ b/.github/workflows/setup.yaml
@@ -0,0 +1,105 @@
+name: Setup
+on: push
+
+jobs:
+ setup:
+ if: (github.event.commits[0].message == 'Initial commit') && (github.run_number == 1)
+ runs-on: ubuntu-latest
+ steps:
+
+ - name: Set up Python
+ uses: actions/setup-python@v1
+ with:
+ python-version: 3.6
+
+ - name: Copy Repository Contents
+ uses: actions/checkout@v2
+
+ - name: modify files
+ run: |
+ import re, os
+ from pathlib import Path
+ from configparser import ConfigParser
+ config = ConfigParser()
+
+ nwo = os.getenv('GITHUB_REPOSITORY')
+ username, repo_name = nwo.split('/')
+ readme_template_path = Path('_fastpages_docs/README_TEMPLATE.md')
+ readme_path = Path('README.md')
+ config_path = Path('_config.yml')
+ pr_msg_path = Path('_fastpages_docs/_setup_pr_template.md')
+ settings = Path('_action_files/settings.ini')
+
+ assert readme_template_path.exists(), 'Did not find _fastpages_docs/README_TEMPLATE.md in the current directory!'
+ assert readme_path.exists(), 'Did not find README.md in the current directory!'
+ assert config_path.exists(), 'Did not find _config.yml in the current directory!'
+ assert pr_msg_path.exists(), 'Did not find _fastpages_docs/_setup_pr_template.md in the current directory!'
+ assert settings.exists(), 'Did not find _action_files/settings.ini in the current directory!'
+
+ # edit settings.ini file to inject baseurl
+ config.read(settings)
+ config['DEFAULT']['baseurl'] = f'/{repo_name}'
+ with open('_action_files/settings.ini', 'w') as configfile:
+ config.write(configfile)
+
+ # replace content of README with template
+ readme = readme_template_path.read_text().replace('{_username_}', username).replace('{_repo_name_}', repo_name)
+ readme_path.write_text(readme)
+
+ # update _config.yml
+ cfg = config_path.read_text()
+ cfg = re.sub(r'^(github_username: )(fastai)', fr'\g<1>{username}', cfg, flags=re.MULTILINE)
+ cfg = re.sub(r'^(baseurl: )("")', r'\1"/{}"'.format(repo_name), cfg, flags=re.MULTILINE)
+ cfg = re.sub(r'^(github_repo: ")(fastpages)', r'\1{}'.format(repo_name), cfg, flags=re.MULTILINE)
+ cfg = re.sub(r'^(url: "https://)(fastpages.fast.ai)(")', fr'\g<1>{username}.github.io\3', cfg, flags=re.MULTILINE)
+ cfg = re.sub('UA-57531313-5', '', cfg, flags=re.MULTILINE)
+ config_path.write_text(cfg)
+
+ # prepare the pr message
+ pr = pr_msg_path.read_text().replace('{_username_}', username).replace('{_repo_name_}', repo_name)
+ pr_msg_path.write_text(pr)
+ shell: python
+
+ - name: commit changes
+ run: |
+ git config --global user.email "${GH_EMAIL}"
+ git config --global user.name "${GH_USERNAME}"
+ git checkout -B fastpages-automated-setup
+ git rm CNAME action.yml
+ git rm _notebooks/2020-02-21-introducing-fastpages.ipynb
+ git rm _notebooks/2020-09-01-fastcore.ipynb || true
+ git rm _notebooks/2020-11-17-linkcheck.ipynb || true
+ git rm -rf _notebooks/fastcore_imgs
+ git rm -rf _notebooks/fastlinkcheck_images
+ git rm _posts/2020-03-06-fastpages-actions.md
+ git rm _posts/*codespaces.md || true
+ git rm -rf images/fastpages_posts
+ git rm .github/workflows/chatops.yaml
+ git rm .github/workflows/docker.yaml
+ git rm .github/workflows/issue_reminder.yaml
+ git rm .github/workflows/setup.yaml
+ git rm .github/ISSUE_TEMPLATE/bug.md
+ git rm .github/ISSUE_TEMPLATE/feature_request.md
+ git rm _word/*.docx
+ git add _config.yml README.md _fastpages_docs/ _action_files/settings.ini
+ git commit -m'setup repo'
+ git push -f --set-upstream origin fastpages-automated-setup
+ env:
+ GH_EMAIL: ${{ github.event.commits[0].author.email }}
+ GH_USERNAME: ${{ github.event.commits[0].author.username }}
+
+ - name: Open a PR
+ uses: actions/github-script@0.5.0
+ with:
+ github-token: ${{secrets.GITHUB_TOKEN}}
+ script: |
+ var fs = require('fs');
+ var contents = fs.readFileSync('_fastpages_docs/_setup_pr_template.md', 'utf8');
+ github.pulls.create({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ title: 'Initial Setup',
+ head: 'fastpages-automated-setup',
+ base: 'master',
+ body: `${contents}`
+ })
diff --git a/.github/workflows/upgrade.yaml b/.github/workflows/upgrade.yaml
new file mode 100755
index 0000000..a2a1cd3
--- /dev/null
+++ b/.github/workflows/upgrade.yaml
@@ -0,0 +1,275 @@
+name: Upgrade fastpages
+on:
+ issues:
+ types: [opened]
+
+jobs:
+ check_credentials:
+ if: |
+ (github.repository != 'fastai/fastpages') &&
+ (github.event.issue.title == '[fastpages] Automated Upgrade')
+ runs-on: ubuntu-latest
+ steps:
+
+ - name: see payload
+ run: |
+ echo "FULL PAYLOAD:\n${PAYLOAD}\n"
+ echo "PR_PAYLOAD PAYLOAD:\n${PR_PAYLOAD}"
+ env:
+ PAYLOAD: ${{ toJSON(github.event) }}
+ PR_PAYLOAD: ${{ github.event.pull_request }}
+
+ - name: Comment on issue if sufficient access does not exist
+ if: |
+ (github.event.issue.author_association != 'OWNER') &&
+ (github.event.issue.author_association != 'COLLABORATOR') &&
+ (github.event.issue.author_association != 'MEMBER')
+ uses: actions/github-script@0.6.0
+ with:
+ github-token: ${{secrets.GITHUB_TOKEN}}
+ script: |
+ var permission_level = process.env.permission_level;
+ var url = 'https://help.github.com/en/github/setting-up-and-managing-your-github-user-account/permission-levels-for-a-user-account-repository#collaborator-access-on-a-repository-owned-by-a-user-account'
+ var msg = `You must have the [permission level](${url}) of either an **OWNER**, **COLLABORATOR** or **MEMBER** to instantiate an upgrade request. Your permission level is ${permission_level}`
+ github.issues.createComment({
+ issue_number: context.issue.number,
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ body: msg
+ })
+ github.issues.update({
+ issue_number: context.issue.number,
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ state: 'closed'
+ })
+ throw msg;
+ env:
+ permission_level: ${{ github.event.issue.author_association }}
+
+ upgrade:
+ needs: [check_credentials]
+ if: |
+ (github.repository != 'fastai/fastpages') &&
+ (github.event.issue.title == '[fastpages] Automated Upgrade') &&
+ (github.event.issue.author_association == 'OWNER' || github.event.issue.author_association == 'COLLABORATOR' || github.event.issue.author_association == 'MEMBER')
+ runs-on: ubuntu-latest
+ steps:
+
+ - name: Set up Python
+ uses: actions/setup-python@v1
+ with:
+ python-version: 3.7
+
+ - name: checkout latest fastpages
+ uses: actions/checkout@v2
+ with:
+ repository: 'fastai/fastpages'
+ path: 'new_files'
+ persist-credentials: false
+
+ - name: copy this repo's contents
+ uses: actions/checkout@v2
+ with:
+ path: 'current_files'
+ persist-credentials: false
+
+ - name: compare versions
+ id: check_version
+ run: |
+ from pathlib import Path
+ new_version = Path('new_files/_fastpages_docs/version.txt')
+ old_version = Path('current_files/_fastpages_docs/version.txt')
+
+ if old_version.exists():
+ old_num = old_version.read_text().strip()
+ new_num = new_version.read_text().strip()
+ print(f'Old version: {old_num}')
+ print(f'New version: {new_num}')
+ if old_num == new_num:
+ print('::set-output name=vbump::false')
+ else:
+ print('::set-output name=vbump::true')
+ else:
+ print('::set-output name=vbump::true')
+ shell: python
+
+ - name: copy new files
+ if: steps.check_version.outputs.vbump == 'true'
+ run: |
+ # remove files you don't want to copy from current version of fastpages
+ cd new_files
+ rm -rf _posts _notebooks _word images
+ rm *.md CNAME action.yml _config.yml index.html LICENSE
+ rm _pages/*.md
+ rm .github/workflows/chatops.yaml
+ rm .github/workflows/docker.yaml
+ rm .github/ISSUE_TEMPLATE/bug.md .github/ISSUE_TEMPLATE/feature_request.md
+
+ # copy new files from fastpages into your repo
+ for file in $(ls | egrep -v "(assets|_sass)"); do
+ if [[ -f "$file" ]] || [[ -d "$file" ]]
+ then
+ echo "copying $file";
+ cp -r $file ../current_files;
+ fi
+ done
+
+ # copy custom-variables.scss if doesn't exist
+ if [ ! -f "../current_files/_sass/minima/custom-variables.scss" ]; then
+ cp _sass/minima/custom-variables.scss ../current_files/_sass/minima/
+ fi
+
+ # copy select files in assets and _sass
+ cp -r assets/js ../current_files/assets
+ cp -r assets/badges ../current_files/assets
+ cp _sass/minima/fastpages-styles.scss ../current_files/_sass/minima/
+ cp _sass/minima/fastpages-dracula-highlight.scss ../current_files/_sass/minima/
+
+ # copy action workflows
+ cp -r .github ../current_files
+
+ # install dependencies
+ pip3 install pyyaml
+
+ - name: sync baseurl
+ if: steps.check_version.outputs.vbump == 'true'
+ run: |
+ import re, os, yaml
+ from pathlib import Path
+ from configparser import ConfigParser
+ settings = ConfigParser()
+
+ # specify location of config files
+ nwo = os.getenv('GITHUB_REPOSITORY')
+ username, repo_name = nwo.split('/')
+ settings_path = Path('current_files/_action_files/settings.ini')
+ config_path = Path('current_files/_config.yml')
+ setup_pr_path = Path('current_files/_fastpages_docs/_setup_pr_template.md')
+ upgrade_pr_path = Path('current_files/_fastpages_docs/_upgrade_pr.md')
+
+ assert settings_path.exists(), 'Did not find _action_files/settings.ini in your repository!'
+ assert config_path.exists(), 'Did not find _config.yml in your repository!'
+ assert setup_pr_path.exists(), 'Did not find_fastpages_docs/_setup_pr_template.md in the current directory!'
+ assert upgrade_pr_path.exists(), 'Did not find _fastpages_docs/_upgrade_pr.md in your repository!'
+
+ # read data from config files
+ settings.read(settings_path)
+ with open(config_path, 'r') as cfg:
+ config = yaml.load(cfg)
+
+ # sync value for baseurl b/w config.yml and settings.ini
+ settings['DEFAULT']['baseurl'] = config['baseurl']
+ with open(settings_path, 'w') as stg:
+ settings.write(stg)
+
+ # update PR templates
+ setup_pr = setup_pr_path.read_text().replace('{_username_}', username).replace('{_repo_name_}', repo_name)
+ setup_pr_path.write_text(setup_pr)
+ upgrade_pr = upgrade_pr_path.read_text().replace('{_username_}', username).replace('{_repo_name_}', repo_name)
+ upgrade_pr_path.write_text(upgrade_pr)
+ shell: python
+
+ - uses: webfactory/ssh-agent@v0.4.1
+ if: steps.check_version.outputs.vbump == 'true'
+ with:
+ ssh-private-key: ${{ secrets.SSH_DEPLOY_KEY }}
+
+ - name: push changes to branch
+ if: steps.check_version.outputs.vbump == 'true'
+ run: |
+ # commit changes
+ cd current_files
+ git config --global user.email "${GH_USERNAME}@users.noreply.github.com"
+ git config --global user.name "${GH_USERNAME}"
+ git remote remove origin
+ git remote add origin "git@github.com:${GITHUB_REPOSITORY}.git"
+
+ git add _action_files/settings.ini
+ git checkout -b fastpages-automated-upgrade
+ git add -A
+ git commit -m'upgrade fastpages'
+ git push -f --set-upstream origin fastpages-automated-upgrade master
+ env:
+ GH_USERNAME: ${{ github.event.issue.user.login }}
+
+ - name: Open a PR
+ if: steps.check_version.outputs.vbump == 'true'
+ id: pr
+ uses: actions/github-script@0.6.0
+ with:
+ github-token: ${{secrets.GITHUB_TOKEN}}
+ script: |
+ var fs = require('fs');
+ var contents = fs.readFileSync('current_files/_fastpages_docs/_upgrade_pr.md', 'utf8');
+ github.pulls.create({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ title: '[fastpages] Update repo with changes from fastpages',
+ head: 'fastpages-automated-upgrade',
+ base: 'master',
+ body: `${contents}`
+ })
+ .then(result => console.log(`::set-output name=pr_num::${result.data.number}`))
+
+ - name: Comment on issue if failure
+ if: failure() && (steps.check_version.outputs.vbump == 'true')
+ uses: actions/github-script@0.6.0
+ with:
+ github-token: ${{secrets.GITHUB_TOKEN}}
+ script: |
+ var pr_num = process.env.PR_NUM;
+ var repo = process.env.REPO
+ github.issues.createComment({
+ issue_number: context.issue.number,
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ body: `An error occurred when attempting to open a PR to update fastpages. See the [Actions tab of your repo](https://github.com/${repo}/actions) for more details.`
+ })
+ env:
+ PR_NUM: ${{ steps.pr.outputs.pr_num }}
+ REPO: ${{ github.repository }}
+
+ - name: Comment on issue
+ if: steps.check_version.outputs.vbump == 'true'
+ uses: actions/github-script@0.6.0
+ with:
+ github-token: ${{secrets.GITHUB_TOKEN}}
+ script: |
+ var pr_num = process.env.PR_NUM;
+ var repo = process.env.REPO
+ github.issues.createComment({
+ issue_number: context.issue.number,
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ body: `Opened PR https://github.com/${repo}/pull/${pr_num} to assist with updating fastpages.`
+ })
+ env:
+ PR_NUM: ${{ steps.pr.outputs.pr_num }}
+ REPO: ${{ github.repository }}
+
+ - name: Comment on issue if version has not changed
+ if: steps.check_version.outputs.vbump == 'false'
+ uses: actions/github-script@0.6.0
+ with:
+ github-token: ${{secrets.GITHUB_TOKEN}}
+ script: |
+ github.issues.createComment({
+ issue_number: context.issue.number,
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ body: `Your version of fastpages is up to date. There is nothing to change.`
+ })
+
+ - name: Close Issue
+ if: always()
+ uses: actions/github-script@0.6.0
+ with:
+ github-token: ${{secrets.GITHUB_TOKEN}}
+ script: |
+ github.issues.update({
+ issue_number: context.issue.number,
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ state: 'closed'
+ })
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..6cdd784
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,14 @@
+*.swp
+~*
+*~
+_site
+.sass-cache
+.jekyll-cache
+.jekyll-metadata
+*.xml
+vendor
+_notebooks/.ipynb_checkpoints
+# Local Netlify folder
+.netlify
+.tweet-cache
+__pycache__
diff --git a/CNAME b/CNAME
new file mode 100644
index 0000000..18a648f
--- /dev/null
+++ b/CNAME
@@ -0,0 +1 @@
+fastpages.fast.ai
diff --git a/Gemfile b/Gemfile
new file mode 100755
index 0000000..e3aacc5
--- /dev/null
+++ b/Gemfile
@@ -0,0 +1,43 @@
+source "https://rubygems.org"
+# Hello! This is where you manage which Jekyll version is used to run.
+# When you want to use a different version, change it below, save the
+# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
+#
+# bundle exec jekyll serve
+#
+# This will help ensure the proper Jekyll version is running.
+# Happy Jekylling!
+gem "jekyll", "~> 4.1.0"
+# This is the default theme for new Jekyll sites. You may change this to anything you like.
+gem "minima"
+# To upgrade, run `bundle update github-pages`.
+# gem "github-pages", group: :jekyll_plugins
+# If you have any plugins, put them here!
+group :jekyll_plugins do
+ gem "jekyll-feed", "~> 0.12"
+ gem 'jekyll-octicons'
+ gem 'jekyll-remote-theme'
+ gem "jekyll-twitter-plugin"
+ gem 'jekyll-relative-links'
+ gem 'jekyll-seo-tag'
+ gem 'jekyll-toc'
+ gem 'jekyll-gist'
+ gem 'jekyll-paginate'
+ gem 'jekyll-sitemap'
+end
+
+gem "kramdown-math-katex"
+gem "jemoji"
+
+# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
+# and associated library.
+install_if -> { RUBY_PLATFORM =~ %r!mingw|mswin|java! } do
+ gem "tzinfo", "~> 1.2"
+ gem "tzinfo-data"
+end
+
+# Performance-booster for watching directories on Windows
+gem "wdm", "~> 0.1.1", :install_if => Gem.win_platform?
+
+gem "faraday", "< 1.0"
+
diff --git a/Gemfile.lock b/Gemfile.lock
new file mode 100755
index 0000000..b8aa71f
--- /dev/null
+++ b/Gemfile.lock
@@ -0,0 +1,154 @@
+GEM
+ remote: https://rubygems.org/
+ specs:
+ activesupport (6.0.3.3)
+ concurrent-ruby (~> 1.0, >= 1.0.2)
+ i18n (>= 0.7, < 2)
+ minitest (~> 5.1)
+ tzinfo (~> 1.1)
+ zeitwerk (~> 2.2, >= 2.2.2)
+ addressable (2.7.0)
+ public_suffix (>= 2.0.2, < 5.0)
+ colorator (1.1.0)
+ concurrent-ruby (1.1.7)
+ em-websocket (0.5.1)
+ eventmachine (>= 0.12.9)
+ http_parser.rb (~> 0.6.0)
+ eventmachine (1.2.7)
+ execjs (2.7.0)
+ faraday (0.17.3)
+ multipart-post (>= 1.2, < 3)
+ ffi (1.13.1)
+ forwardable-extended (2.6.0)
+ gemoji (3.0.1)
+ html-pipeline (2.14.0)
+ activesupport (>= 2)
+ nokogiri (>= 1.4)
+ http_parser.rb (0.6.0)
+ i18n (1.8.5)
+ concurrent-ruby (~> 1.0)
+ jekyll (4.1.1)
+ addressable (~> 2.4)
+ colorator (~> 1.0)
+ em-websocket (~> 0.5)
+ i18n (~> 1.0)
+ jekyll-sass-converter (~> 2.0)
+ jekyll-watch (~> 2.0)
+ kramdown (~> 2.1)
+ kramdown-parser-gfm (~> 1.0)
+ liquid (~> 4.0)
+ mercenary (~> 0.4.0)
+ pathutil (~> 0.9)
+ rouge (~> 3.0)
+ safe_yaml (~> 1.0)
+ terminal-table (~> 1.8)
+ jekyll-feed (0.15.0)
+ jekyll (>= 3.7, < 5.0)
+ jekyll-gist (1.5.0)
+ octokit (~> 4.2)
+ jekyll-octicons (11.0.0)
+ jekyll (>= 3.6, < 5.0)
+ octicons (= 11.0.0)
+ jekyll-paginate (1.1.0)
+ jekyll-relative-links (0.6.1)
+ jekyll (>= 3.3, < 5.0)
+ jekyll-remote-theme (0.4.2)
+ addressable (~> 2.0)
+ jekyll (>= 3.5, < 5.0)
+ jekyll-sass-converter (>= 1.0, <= 3.0.0, != 2.0.0)
+ rubyzip (>= 1.3.0, < 3.0)
+ jekyll-sass-converter (2.1.0)
+ sassc (> 2.0.1, < 3.0)
+ jekyll-seo-tag (2.6.1)
+ jekyll (>= 3.3, < 5.0)
+ jekyll-sitemap (1.4.0)
+ jekyll (>= 3.7, < 5.0)
+ jekyll-toc (0.14.0)
+ jekyll (>= 3.8)
+ nokogiri (~> 1.10)
+ jekyll-twitter-plugin (2.1.0)
+ jekyll-watch (2.2.1)
+ listen (~> 3.0)
+ jemoji (0.12.0)
+ gemoji (~> 3.0)
+ html-pipeline (~> 2.2)
+ jekyll (>= 3.0, < 5.0)
+ katex (0.6.0)
+ execjs (~> 2.7)
+ kramdown (2.3.0)
+ rexml
+ kramdown-math-katex (1.0.1)
+ katex (~> 0.4)
+ kramdown (~> 2.0)
+ kramdown-parser-gfm (1.1.0)
+ kramdown (~> 2.0)
+ liquid (4.0.3)
+ listen (3.2.1)
+ rb-fsevent (~> 0.10, >= 0.10.3)
+ rb-inotify (~> 0.9, >= 0.9.10)
+ mercenary (0.4.0)
+ mini_portile2 (2.4.0)
+ minima (2.5.1)
+ jekyll (>= 3.5, < 5.0)
+ jekyll-feed (~> 0.9)
+ jekyll-seo-tag (~> 2.1)
+ minitest (5.14.2)
+ multipart-post (2.1.1)
+ nokogiri (1.10.10)
+ mini_portile2 (~> 2.4.0)
+ octicons (11.0.0)
+ nokogiri (>= 1.6.3.1)
+ octokit (4.18.0)
+ faraday (>= 0.9)
+ sawyer (~> 0.8.0, >= 0.5.3)
+ pathutil (0.16.2)
+ forwardable-extended (~> 2.6)
+ public_suffix (4.0.6)
+ rb-fsevent (0.10.4)
+ rb-inotify (0.10.1)
+ ffi (~> 1.0)
+ rexml (3.2.4)
+ rouge (3.23.0)
+ rubyzip (2.3.0)
+ safe_yaml (1.0.5)
+ sassc (2.4.0)
+ ffi (~> 1.9)
+ sawyer (0.8.2)
+ addressable (>= 2.3.5)
+ faraday (> 0.8, < 2.0)
+ terminal-table (1.8.0)
+ unicode-display_width (~> 1.1, >= 1.1.1)
+ thread_safe (0.3.6)
+ tzinfo (1.2.7)
+ thread_safe (~> 0.1)
+ tzinfo-data (1.2020.1)
+ tzinfo (>= 1.0.0)
+ unicode-display_width (1.7.0)
+ wdm (0.1.1)
+ zeitwerk (2.4.0)
+
+PLATFORMS
+ ruby
+
+DEPENDENCIES
+ faraday (< 1.0)
+ jekyll (~> 4.1.0)
+ jekyll-feed (~> 0.12)
+ jekyll-gist
+ jekyll-octicons
+ jekyll-paginate
+ jekyll-relative-links
+ jekyll-remote-theme
+ jekyll-seo-tag
+ jekyll-sitemap
+ jekyll-toc
+ jekyll-twitter-plugin
+ jemoji
+ kramdown-math-katex
+ minima
+ tzinfo (~> 1.2)
+ tzinfo-data
+ wdm (~> 0.1.1)
+
+BUNDLED WITH
+ 2.1.4
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..5c1d0d4
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,201 @@
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright 2020 onwards, fast.ai, Inc
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
diff --git a/Makefile b/Makefile
new file mode 100755
index 0000000..60f5db9
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,53 @@
+help:
+ cat Makefile
+
+# start (or restart) the services
+server: .FORCE
+ docker-compose down --remove-orphans || true;
+ docker-compose up
+
+# start (or restart) the services in detached mode
+server-detached: .FORCE
+ docker-compose down || true;
+ docker-compose up -d
+
+# build or rebuild the services WITHOUT cache
+build: .FORCE
+ chmod 777 Gemfile.lock
+ docker-compose stop || true; docker-compose rm || true;
+ docker build --no-cache -t fastai/fastpages-jekyll -f _action_files/fastpages-jekyll.Dockerfile .
+ docker-compose build --force-rm --no-cache
+
+# rebuild the services WITH cache
+quick-build: .FORCE
+ docker-compose stop || true;
+ docker build -t fastai/fastpages-jekyll -f _action_files/fastpages-jekyll.Dockerfile .
+ docker-compose build
+
+# convert word & nb without Jekyll services
+convert: .FORCE
+ docker-compose up converter
+
+# stop all containers
+stop: .FORCE
+ docker-compose stop
+ docker ps | grep fastpages | awk '{print $1}' | xargs docker stop
+
+# remove all containers
+remove: .FORCE
+ docker-compose stop || true; docker-compose rm || true;
+
+# get shell inside the notebook converter service (Must already be running)
+bash-nb: .FORCE
+ docker-compose exec watcher /bin/bash
+
+# get shell inside jekyll service (Must already be running)
+bash-jekyll: .FORCE
+ docker-compose exec jekyll /bin/bash
+
+# restart just the Jekyll server
+restart-jekyll: .FORCE
+ docker-compose restart jekyll
+
+.FORCE:
+ chmod -R u+rw .
diff --git a/README.md b/README.md
new file mode 100755
index 0000000..303c834
--- /dev/null
+++ b/README.md
@@ -0,0 +1,553 @@
+[//]: # (BADGES SECTION: change `fastai` with your GitHub username and `fastpages` with the name of your repo)
+
+
+
+[](https://github.com/fastai/nbdev)
+[](https://fastpages.fast.ai/)
+
+[//]: # (END OF BADGES SECTION)
+
+# Welcome To `fastpages`
+
+> An easy to use blogging platform, with support for Jupyter notebooks, Word docs, and Markdown.
+
+
+
+`fastpages` uses [GitHub Actions](https://github.com/features/actions) to simplify the process of creating [Jekyll blog posts](https://jekyllrb.com/) on [GitHub Pages](https://pages.github.com/) from a variety of input formats.
+
+### `fastpages` provides the following features:
+
+- Create posts containing code, outputs of code (which can be interactive), formatted text, etc directly from [Jupyter Notebooks](https://jupyter.org/); Notebook posts support features such as:
+ - Interactive visualizations made with [Altair](https://altair-viz.github.io/) remain interactive.
+ - Hide or show cell input and output.
+ - Collapsable code cells that are either open or closed by default.
+ - Define the Title, Summary and other metadata via a special markdown cells
+ - Ability to add links to [Colab](https://colab.research.google.com/) and GitHub automatically.
+- Support for comments, supported natively through GitHub Issues.
+- Built-in search.
+- Support for customizing the styling of your site.
+- Embed Twitter cards and YouTube videos.
+- Categorization of blog posts by user-supplied tags for discoverability.
+- Create and edit [Markdown](https://guides.github.com/features/mastering-markdown/) posts.
+- Create posts, including formatting and images, directly from Microsoft Word documents.
+- Write posts on your local machine and [preview them with live reload](#running-the-blog-on-your-local-machine).
+
+See below for a more detailed list of features.
+
+
+**[See the demo site](https://fastpages.fast.ai/)**
+
+---
+
+
+
+- [Welcome To `fastpages`](#welcome-to-fastpages)
+ - [`fastpages` provides the following features:](#fastpages-provides-the-following-features)
+ - [Setup Instructions](#setup-instructions)
+ - [Customizing Blog Posts With Front Matter](#customizing-blog-posts-with-front-matter)
+ - [Configure Title & Summary](#configure-title--summary)
+ - [Table of Contents](#table-of-contents)
+ - [Colab, Binder and GitHub Badges](#colab-binder-and-github-badges)
+ - [Categories](#categories)
+ - [Enabling Comments](#enabling-comments)
+ - [Setting an Image For Social Media](#setting-an-image-for-social-media)
+ - [Hiding A Blog Post](#hiding-a-blog-post)
+ - [Pinning A Blog Post](#pinning-a-blog-post)
+ - [Toggle Search Visibility](#toggle-search-visibility)
+ - [Site Wide Configuration Options](#site-wide-configuration-options)
+ - [Adjusting Page Width](#adjusting-page-width)
+ - [Annotations and Highlighting With hypothes.is](#annotations-and-highlighting-with-hypothes.is)
+ - [Subscribing with RSS](#subscribing-with-rss)
+ - [Syntax Highlighting](#syntax-highlighting)
+ - [Dark Mode](#dark-mode)
+ - [Adding Citations via BibTeX](#adding-citations-via-bibtex)
+ - [Writing Blog Posts With Jupyter](#writing-blog-posts-with-jupyter)
+ - [Hide Input/Output Cells](#hide-inputoutput-cells)
+ - [Collapsable Code Cells](#collapsable-code-cells)
+ - [Embedded Twitter and YouTube Content](#embedded-twitter-and-youtube-content)
+ - [Adding Footnotes](#adding-footnotes)
+ - [Automatically Convert Notebooks To Blog Posts](#automatically-convert-notebooks-to-blog-posts)
+ - [Writing Blog Posts With Markdown](#writing-blog-posts-with-markdown)
+ - [Writing Blog Posts With Microsoft Word](#writing-blog-posts-with-microsoft-word)
+ - [Specifying front-matter for Word documents](#specifying-front-matter-for-word-documents)
+- [Running the blog on your local machine](#running-the-blog-on-your-local-machine)
+- [Using The GitHub Action & Your Own Custom Blog](#using-the-github-action--your-own-custom-blog)
+ - [Optional Inputs](#optional-inputs)
+- [Contributing To Fastpages](#contributing-to-fastpages)
+- [Upgrading Fastpages](#upgrading-fastpages)
+- [FAQ](#faq)
+- [Customizing Fastpages](#customizing-fastpages)
+- [Troubleshooting fastpages](#troubleshooting-fastpages)
+
+
+
+
+## Setup Instructions
+
+1. Generate a copy of this repo by clicking [on this link](https://github.com/fastai/fastpages/generate). Make sure to sign in to your account, or you will see a 404 error. Name your repo anything you like **except** {your-username}.github.io.
+
+2. **GitHub Actions will automatically open a PR** on your new repository ~ 30 seconds after the copy is created. Follow the instructions in that PR to continue.
+
+>If you are not seeing a PR, please make sure you have third party actions enabled in your organization: **Settings -> Actions -> Actions Permissions -> Enable local and third party Actions for this repository**
+
+For a live walk-through of the setup steps (with some additional tips) see this [video tutorial of setting up a fastpages blog](https://youtu.be/L0boq3zqazI) by Abdul Majed.
+
+## Customizing Blog Posts With Front Matter
+
+[Front matter](https://jekyllrb.com/docs/front-matter/) allows you to toggle various options on/off for each blog post, as well as pass metadata to various features of fastpages.
+
+In a notebook, front matter is defined as a markdown cell at the beginning of the notebook with the following contents:
+
+ ```markdown
+ # "Title"
+ > "Awesome summary"
+
+ - toc: false
+ - branch: master
+ - badges: true
+ - comments: true
+ - categories: [fastpages, jupyter]
+ - image: images/some_folder/your_image.png
+ - hide: false
+ - search_exclude: true
+ - metadata_key1: metadata_value1
+ - metadata_key2: metadata_value2
+ ```
+
+Similarly, in a markdown document the same front matter would be defined like this at the beginning of the document:
+
+ ```yaml
+ ---
+ title: "My Title"
+ description: "Awesome description"
+ layout: post
+ toc: false
+ comments: true
+ image: images/some_folder/your_image.png
+ hide: false
+ search_exclude: true
+ categories: [fastpages, jupyter]
+ metadata_key1: metadata_value1
+ metadata_key2: metadata_value2
+ ---
+ ```
+
+Additional metadata is optional and allows you to set custom [front matter](https://jekyllrb.com/docs/front-matter/).
+
+Note that anything defined in front matter must be valid YAML. **Failure to provide valid YAML could result in your page not rendering** in your blog. For example, if you want a colon in your title you must escape it with double quotes like this:
+
+` - title: "Deep learning: A tutorial"`
+
+See this [tutorial on YAML](https://rollout.io/blog/yaml-tutorial-everything-you-need-get-started/) for more information.
+
+### Configure Title & Summary
+ - Replace `Title`, with your desired title, and `Awesome summary` with your desired summary.
+
+**Note:** It is recommended to enclose these values in double quotes, so that you can escape colons and other characters that may break the YAML parser.
+
+### Table of Contents
+ - `fast_template` will automatically generate a table of contents for you based on [markdown headers](https://guides.github.com/features/mastering-markdown/)! You can toggle this feature on or off by setting `toc:` to either `true` or `false`.
+
+### Colab, Binder and GitHub Badges
+
+This option works for **notebooks only**
+
+ - The `branch` field is used to optionally render a link your notebook to Colab and GitHub in your blog post post. It'll default to `master` if you don't specify it in the notebook.
+ - If you do not want to show Colab / GitHub badges on your blog post (perhaps because your repo is private and the links would be broken) set `badges` to `false`. This defaults to `true`
+ - By default, when you omit this parameter from your front matter, or you set `badges: true`, **all three badges (GitHub, Binder, Colab)** will appear by default. You can adjust these defaults in with the `default_badges` parameter in [Site Wide Configuration Options](#site-wide-configuration-options).
+ - If only want to hide a badge on an individual post, you can set the front matter `hide_{github,colab,binder}_badge: true`. For example, if you wanted to hide the Binder badge for an individual notebook but you want the other badges to show up, you can set this in your front matter:
+
+ ```yaml
+ - badges: true
+ - hide_binder_badge: true
+ ```
+ - **Note about Binder**: Binder allows you to customize the dependencies and other aspects of the Jupyter Notebook environment for your readers. The easiest way is to add a `requirements.txt` file with common packages you use for all your notebooks at the root of your repository, you can learn more [on the official Binder docs](https://mybinder.readthedocs.io/en/latest/introduction.html).
+
+### Categories
+ - You can have a comma seperated list inside square brackets of categories for a blog post, which will make the post visible on the tags page of your blog's site. For example:
+
+ In a notebook:
+
+ ```
+ # "My Title"
+ - categories: [fastpages, jupyter]
+ ```
+
+ In a markdown document:
+
+ ```
+ ---
+ title: "My Title"
+ categories: [fastpages, jupyter]
+ ---
+ ```
+
+ You can see a preview of what this looks like [here](https://fastpages.fast.ai/categories/).
+
+
+ - You can toggle the display of tags on/off by setting `show_tags` to `true` or `false` in `_config.yml`:
+
+```yaml
+# Set this to true to display tags on each post
+show_tags: true
+```
+
+### Enabling Comments
+
+Commenting on blog posts is powered by [Utterances](https://github.com/utterance/utterances), an open-source and ad-free way of implementing comments. All comments are stored in issues on your blog's GitHub repo. You can turn this on setting `comments` to `true`. This defaults to `false`.
+
+To enable comments with [Utterances](https://github.com/utterance/utterances) you will need to do the following:
+
+ - Make sure the repo is public, otherwise your readers will not be able to view the issues/comments.
+ - Make sure the [utterances app](https://github.com/apps/utterances) is installed on the repo, otherwise users will not be able to post comments.
+ - If your repo is a fork, navigate to it's settings tab and confirm the issues feature is turned on.
+
+### Setting an Image For Social Media
+
+On social media sites like Twitter, an image preview can be automatically shown with your URL. Specifying the front matter `image` provides this metadata to social media sites to render this image for you. You can set this value as follows:
+
+`- image: images/diagram.png`
+
+Note: for this setting **you can only reference image files and folders in the `/images` folder of your repo.**
+
+### Hiding A Blog Post
+
+You may want to prevent a blog post from being listed on the home page, but still have a public url that you can preview or share discreetly. You can hide a blog post from the home page by setting the front matter `hide` to `true`. This is set to `false` by default.
+
+It is recommended that you use [permalinks](https://jekyllrb.com/docs/permalinks/) in order to generate a predictable url for hidden blog posts. You can also set the front matter `search_exclude` to `false` if you don't want users to find your hidden post in a search.
+
+### Pinning A Blog Post
+
+By default, posts are sorted by date on your homepage. However, you may want one or more blog posts to always appear at the very top of your homepage. In other words, you may want certain posts to be "pinned" or "sticky". To accomplish this, specify the `sticky_rank` front matter in the order you would like your sticky posts to appear. Blog posts that do not set this parameter are sorted in the default way by date after the sticky posts.
+
+For example, consider these three markdown posts (also works for notebooks).
+
+`2020-01-01-Post-One.md`
+```yaml
+---
+title: Post One
+sticky_rank: 1
+---
+```
+
+`2020-02-01-Post-Two.md`
+```yaml
+---
+title: Post Two
+sticky_rank: 2
+---
+```
+
+`2020-04-01-Post-Three.md`
+```yaml
+---
+title: Post Three
+---
+```
+
+However, since `sticky_rank` is specified, blog posts will **first be sorted by sticky_rank in ascending order, then by date in descending order**, so the order of these posts will appear like so:
+
+- Post One
+- Post Two
+- Post Three
+
+_Without `sticky_rank` the above posts would actually be sorted in reverse order due to the dates associated with each post._
+
+_Note: pinning also works for notebooks:_
+
+```
+# "My cool blog post"
+> "Description of blog post"
+
+- sticky_rank: 2
+```
+
+### Toggle Search Visibility
+
+fastpages comes with built in keyword search powered by [lunr.js](https://lunrjs.com/). You can prevent a blog post or page from appearing in search results by setting the front matter `search_exclude` to `false`. This is set to `true` by default.
+
+
+## Site Wide Configuration Options
+
+**It is recommended that everyone personalizes their blogging site by setting site-wide configration options**. These options can be found in `/_config.yml`. Below is a description of various options that are available.
+
+- `title`: this is the title that appears on the upper left hand corner on the header of all your pages.
+- `description`: this description will show up in various places when a preview for your site is generated (for example, on social media).
+- `github_username`: this allows your site to display a link to your GitHub page in the footer.
+- `github_repo`: this allows your site to render links back to your repository for various features such as links to GitHub and Colab for notebooks.
+- `url`: This does not need to be changed unless you have a custom domain. **Note: leave out the trailing / from this value.**
+- `baseurl`: See the comments in `/_config.yml` for instructions ( "Special Instructions for baseurl" on setting this value properly. If you do not have a custom domain, then you can likely ignore this option.
+- `email`: this is currently unused. Ignore.
+- `twitter_username`: creates a link in your footer to your twitter page.
+- `use_math`: Set this to `true` to get LaTeX math equation support. This is off by default as it otherwhise loads javascript into each page that may not be used.
+- `show_description`: This shows a description under the title of your blog posts on your homepage that contains a list of your blog posts. Set to `true` by default.
+- `google_analytics`: Optionally use a [Google Analytics](http://www.google.com/analytics/) ID for tracking if desired.
+- `show_image`: If set to true, this uses the `image` parameter in the front matter of your blog posts to render a preview of your blogs as shown below. This is set to `false` by default.
+ When show_image is set to `true` your homepage will look like this:
+
+ 
+
+- `show_tags`: You can toggle the display of tags on your blog posts on or off by setting this value to `false`. This is set to `true` by default, which which renders the following links for tags on your blog posts like this:
+
+ 
+
+- `pagination`: This is the maximum number of posts to show on each page of your home page. Any posts exceeding this amount will be paginated onto another page. This is set to `15` by default. When this is triggered, you will see pagination at the bottom of your home page appear like this:
+
+ 
+
+ Note: if you are using an older version of fastpages, **you cannot use the automated upgrade process** to get pagination. Instead you must follow these steps:
+
+ 1. Rename your index.md file to index.html
+ > mv index.md index.html
+ 2. Replace the `Gemfile` and `Gemfile.lock` in the root of your repo with the files in this repo.
+ 3. Edit your `_config.yml` as follows (look at [_config.yml](_config.yml) for an example):
+ ```yaml
+ gems:
+ - jekyll-paginate
+
+ paginate: 10
+ paginate_path: /page:num/
+ ```
+
+ _Alternatively, you can copy all of your posts over to a newly created repository created from the fastpages template._
+
+- `default_badges`: By default GitHub, Binder, and Colab badges will show up on notebook blog posts. You can adjust these defaults by setting the appropriate value in `default_badges` to false. For example, if you wanted to turn Binder badges off by default, you would change `default_badges` to this:
+
+ ```yaml
+ default_badges:
+ github: true
+ binder: false
+ colab: true
+ ```
+
+- `html_escape`: this allows you to toggle escaping of HTML in various components of blog posts on or off. At this moment, you can only toggle this for the `description` field in your posts.
+This is set to `false` by default.
+
+## Adjusting Page Width
+
+You can adjust the page width of fastpages on various devices by editing [/_sass/minima/custom-variables.scss](_sass/minima/custom-variables.scss).
+
+These are the default values, which can be adjusted to suit your preferences:
+
+```scss
+// width of the content area
+// can be set as "px" or "%"
+$content-width: 1000px;
+$on-palm: 800px;
+$on-laptop: 1000px;
+$on-medium: 1000px;
+$on-large: 1200px;
+```
+
+## Annotations and Highlighting With hypothes.is
+
+[hypothes.is](https://web.hypothes.is/) is an open platform that provides a way to annotate and higlight pages, which can be either public or private. When this feature is enabled, readers of your blog will be presented with the following tooltip when highlighting text:
+
+
+
+**This is disabled by default in fastpages.** You can enable or disable this in your [_config.yml](_config.yml) file by setting `annotations` to `true` or `false`:
+
+```yaml
+# Set this to true to turn on annotations with hypothes.is
+annotations: false
+```
+
+> You can customize hypothes.is by reading [these configuration options](http://h.readthedocs.io/projects/client/en/latest/publishers/config/). It is also a good idea to read [these docs](https://web.hypothes.is/for-publishers/#embedding) if you want to do more with hypothes.is. However, before trying to customize this feature you should read the [customizing fastpages](#customizing-fastpages) section for important caveats.
+
+## Subscribing with RSS
+
+You can direct your readers to subscribe with [RSS feeds](https://en.wikipedia.org/wiki/RSS). There are many RSS subscription services available on the internet. Some examples include:
+
+1. [Feedrabbit](https://feedrabbit.com/)
+2. [Blogtrottr](https://blogtrottr.com/)
+
+## Syntax Highlighting
+
+`fastpages` overrides the default syntax highlighting of minima with the [Dracula theme](https://draculatheme.com/).
+
+- The default highlighting in fastpages looks like this:
+
+ 
+
+- However, you can make the syntax highlighting to look like this, if you choose:
+
+ 
+
+ If you wish to revert to the light theme above, you can remove the below line in [_sass/minima/custom-styles.scss](_sass/minima/custom-styles.scss)
+
+ ```scss
+ @import "minima/fastpages-dracula-highlight";
+ ```
+- If you don't like either of these themes, you can add your own CSS in [`_sass/minima/custom-styles.scss`](_sass/minima/custom-styles.scss). See [customizing fastpages](#customizing-fastpages) for more details.
+
+## Dark Mode
+
+[This blog post](https://prudhvirampey.com/blog/colours/jekyll/css/fastpages/2020/10/30/hello-dark-mode.html) describes how to enable Dark Mode for fastpages.
+
+## Adding Citations via BibTeX
+
+Users who prefer to use the citation system BibTeX may do so; it requires enabling the [jekyll-scholar](https://github.com/inukshuk/jekyll-scholar) plugin. Please see [Citations in Fastpages via BibTeX and jekyll-scholar](https://drscotthawley.github.io/devblog4/2020/07/01/Citations-Via-Bibtex.html) for instructions on implementing this.
+
+## Writing Blog Posts With Jupyter
+
+### Hide Input/Output Cells
+
+Place the comment `#hide` at the beginning of a code cell and it wil **hide both the input and the output** of that cell.
+
+A `#hide_input` comment at the top of any cell will **only hide the input**.
+
+Furthermore, the `hide input` [Jupyter Extension](https://jupyter-contrib-nbextensions.readthedocs.io/en/latest/nbextensions/hide_input/readme.html) can be used to hide cell inputs or outputs, which will be respected by fastpages.
+
+### Collapsable Code Cells
+
+You may want some code to be hidden in a collapsed element that the user can expand, rather than completely hiding the code from the reader.
+
+- To include code in a collapsable cell that **is collapsed by default**, place the comment `#collapse` at the top of the code cell.
+- To include code in a collapsable cell that **is open by default**, place the comment `#collapse_show` or `#collapse-show` at the top of the code cell.
+- To include the output under a collapsable element that is closed by default, place the comment `#collapse_output` or `#collapse-output` at the top of the code cell.
+
+### Embedded Twitter and YouTube Content
+In a markdown cell in your notebook, use the following markdown shortcuts to embed Twitter cards and YouTube Videos.
+
+
+ ```markdown
+ > youtube: https://youtu.be/your-link
+ > twitter: https://twitter.com/some-link
+ ```
+### Adding Footnotes
+
+Adding footnotes in notebooks is a bit different than markdown. Please see the [Detailed Guide To Footnotes in Notebooks](https://github.com/fastai/fastpages/blob/master/_fastpages_docs/NOTEBOOK_FOOTNOTES.md).
+
+### Automatically Convert Notebooks To Blog Posts
+
+1. Save your notebook with the naming convention `YYYY-MM-DD-*.` into the `/_notebooks` or `/_word` folder of this repo, respectively. For example `2020-01-28-My-First-Post.ipynb`. This [naming convention is required by Jekyll](https://jekyllrb.com/docs/posts/) to render your blog post.
+ - Be careful to name your file correctly! It is easy to forget the last dash in `YYYY-MM-DD-`. Furthermore, the character immediately following the dash should only be an alphabetical letter. Examples of valid filenames are:
+
+ ```shell
+ 2020-01-28-My-First-Post.ipynb
+ 2012-09-12-how-to-write-a-blog.ipynb
+ ```
+
+ - If you fail to name your file correctly, `fastpages` will automatically attempt to fix the problem by prepending the last modified date of your file to your generated blog post, however, it is recommended that you name your files properly yourself for more transparency.
+
+
+2. [Commit and push](https://help.github.com/en/github/managing-files-in-a-repository/adding-a-file-to-a-repository-using-the-command-line) your file(s) to GitHub in your repository's master branch.
+
+3. GitHub will automatically convert your files to blog posts. **It will take ~5 minutes for the conversion process to take place**. You can click on the Actions tab of your repo to view the logs of this process. There will be two workflows that are triggered with each push you make to your master branch: (1) "CI" and (2) "GH Pages Status". Both workflows must complete with a green checkmark for your latest commit before your site is updated.
+
+4. If you wish, you can preview how your blog will look locally before commiting to GitHub. See [this section](#running-the-blog-on-your-local-machine) for a detailed guide on running the preview locally.
+
+
+## Writing Blog Posts With Markdown
+
+If you are writing your blog post in markdown, save your `.md` file into the `/_posts` folder with the same naming convention (`YYYY-MM-DD-*.md`) specified for notebooks.
+
+## Writing Blog Posts With Microsoft Word
+
+Save your Microsoft Word documents into the `/_word` folder with the same naming convention (`YYYY-MM-DD-*.docx`) specified for notebooks.
+
+_Note:_ [alt text](https://support.office.com/en-us/article/add-alternative-text-to-a-shape-picture-chart-smartart-graphic-or-other-object-44989b2a-903c-4d9a-b742-6a75b451c669) in Word documents are not yet supported by fastpages, and will break links to images.
+
+### Specifying front-matter for Word documents
+
+`fastpages` does not have a robust way to specify [front matter](https://jekyllrb.com/docs/front-matter/) for Word documents. At the moment, you can only specify front matter globally for all Word documents by editing [_action_files/word_front_matter.txt](_action_files/word_front_matter.txt).
+
+To specify unique front matter per Word document, you will need to convert Word to markdown files manually. You can follow the steps in this [blog post](https://www.fast.ai/2020/01/18/gitblog/), which walk you through how to use [pandoc](https://pandoc.org/installing.html) to do the conversion. Note: If you wish to customize your Word generated blog post in markdown, make sure you delete your Word document from the _word directory so your markdown file doesn’t get overwritten!
+
+_If your primary method of writing blog posts is Word documents, and you plan on always manually editing markdown files converted from Word, you are probably better off using [fast_template](https://github.com/fastai/fast_template) instead of fastpages._
+
+# Running the blog on your local machine
+
+See the [development guide](_fastpages_docs/DEVELOPMENT.md).
+
+
+# Using The GitHub Action & Your Own Custom Blog
+
+The `fastpages` action allows you to convert notebooks from `/_notebooks` and word documents from `/_word` directories in your repo into [Jekyll](https://jekyllrb.com/) compliant blog post markdown files located in `/_posts`. **Note: This directory structure is currently inflexible** for this Action, as it is designed to be used with Jekyll.
+
+If you already have sufficient familiarity with [Jekyll](https://jekyllrb.com/) and wish to use this automation in your own theme, you can use this GitHub Action by referencing `fastai/fastpages@master` as follows:
+
+```yaml
+...
+
+uses: fastai/fastpages@master
+
+...
+```
+An illustrative example of what a complete workflow may look like:
+
+
+
+```yaml
+jobs:
+ build-site:
+ runs-on: ubuntu-latest
+ ...
+
+ - name: convert notebooks and word docs to posts
+ uses: fastai/fastpages@master
+
+ ...
+
+ - name: Jekyll build
+ uses: docker://jekyll/jekyll
+ with:
+ args: jekyll build
+
+ - name: Deploy
+ uses: peaceiris/actions-gh-pages@v3
+ if: github.event_name == 'push'
+ with:
+ deploy_key: ${{ secrets.SSH_DEPLOY_KEY }}
+ publish_branch: gh-pages
+ publish_dir: ./_site
+```
+
+Note that this Action **does not have any required inputs, and has no output variables**.
+
+### Optional Inputs
+
+ - `BOOL_SAVE_MARKDOWN`: Either 'true' or 'false'. Whether or not to commit converted markdown files from notebooks and word documents into the _posts directory in your repo. This is useful for debugging. _default: false_
+ - `SSH_DEPLOY_KEY`: a ssh deploy key is required if BOOL_SAVE_MARKDOWN = 'true'
+
+See the API spec for this action in [action.yml](action.yml)
+
+Detailed instructions on how to customize this blog are beyond the scope of this README. ( We invite someone from the community to contribute a blog post on how to do this in this repo! )
+
+# Contributing To Fastpages
+
+Please see the [contributing guide](_fastpages_docs/CONTRIBUTING.md).
+
+# Upgrading Fastpages
+
+Please see the [upgrading guide](_fastpages_docs/UPGRADE.md).
+
+# FAQ
+
+- **Q:** Where are the markdown files in `_posts/` that are generated from my Jupyter notebooks or word documents? **A:** The GitHub Actions workflow in this repo converts your notebook and word documents to markdown on the fly before building your site, but never commits these intermediate markdown files to this repo. This is in order to save you from the annoyance of your local environment being constantly out of sync with your repository. You can optionally see these intermediate markdown files by setting the `BOOL_SAVE_MARKDOWN` and `SSH_DEPLOY_KEY` inputs to the fastpages action in your `.github/workflows/ci.yaml` file as follows:
+
+```yaml
+ ...
+
+ - name: convert notebooks and word docs to posts
+ uses: fastai/fastpages@master
+ with:
+ BOOL_SAVE_MARKDOWN: true
+ SSH_DEPLOY_KEY: ${{ secrets.SSH_DEPLOY_KEY }}
+
+ ...
+```
+
+- **Q:** Can I use `fastpages` for Jekyll docs sites or for things that are not Jekyll blog posts? **A:** At the moment, `fastpages` is a highly opinionated solution that works only for Jekyll blog posts. If you want to write documentation for your module or library with Jupyter notebooks, we suggest you use [fastai/nbdev](https://github.com/fastai/nbdev) which is expressly built for this purpose.
+
+- **Q:** What is the difference between [fast_template](https://github.com/fastai/fast_template) and fastpages? Which one should I use? **A:** Because `fastpages` is more flexible and extensible, we recommend using it where possible. `fast_template` may be a better option for getting folks blogging who have no technical expertise at all, and will only be creating posts using Github's integrated online editor.
+
+# Customizing Fastpages
+
+fastpages builds upon the [minima theme](https://github.com/jekyll/minima). If you want to customize the styling or layout of fastpages, you can find instructions [in minima's README](https://github.com/jekyll/minima/blob/master/README.md). It is a good idea to read the full contents of the README to understand the directory structure. Furthermore, it is a good idea to have a basic understanding of Jekyll before customizing your theme. For those new to Jekyll, [the official docs](https://jekyllrb.com/docs/) are a good place to start. Concretely, you can override css in fastpages in `_sass/minima/custom-styles.scss`. *NOTE that minima's "skins" feature is currently incompatible with fastpages' css settings.*
+
+**If you choose to make customizations to fastpages** It is possible that customizations you make could collide with current or future versions of fastpages and we recommend doing so only if you feel sufficiently comfortable with HTML and CSS.
+
+# Troubleshooting fastpages
+
+Please see the [troubleshooting guide](https://github.com/fastai/fastpages/blob/master/_fastpages_docs/TROUBLESHOOTING.md).
diff --git a/_action_files/Dockerfile b/_action_files/Dockerfile
new file mode 100755
index 0000000..b5bcf32
--- /dev/null
+++ b/_action_files/Dockerfile
@@ -0,0 +1,9 @@
+FROM fastai/jekyll:2020-09-12
+
+WORKDIR /fastpages
+COPY . .
+RUN chmod u+x action_entrypoint.sh
+RUN chmod u+x word2post.sh
+RUN dos2unix /fastpages/*.sh
+
+CMD [ "/fastpages/action_entrypoint.sh" ]
diff --git a/_action_files/__init__.py b/_action_files/__init__.py
new file mode 100755
index 0000000..e69de29
diff --git a/_action_files/action.yml b/_action_files/action.yml
new file mode 100644
index 0000000..9f240fe
--- /dev/null
+++ b/_action_files/action.yml
@@ -0,0 +1,17 @@
+name: 'fastpages: An easy to use blogging platform with support for Jupyter Notebooks.'
+description: Converts Jupyter notebooks and Word docs into Jekyll blog posts.
+author: Hamel Husain
+inputs:
+ BOOL_SAVE_MARKDOWN:
+ description: Either 'true' or 'false'. Whether or not to commit converted markdown files from notebooks and word documents into the _posts directory in your repo. This is useful for debugging.
+ required: false
+ default: false
+ SSH_DEPLOY_KEY:
+ description: a ssh deploy key is required if BOOL_SAVE_MARKDOWN = 'true'
+ required: false
+branding:
+ color: 'blue'
+ icon: 'book'
+runs:
+ using: 'docker'
+ image: 'Dockerfile'
diff --git a/_action_files/action_entrypoint.sh b/_action_files/action_entrypoint.sh
new file mode 100755
index 0000000..4850484
--- /dev/null
+++ b/_action_files/action_entrypoint.sh
@@ -0,0 +1,48 @@
+#!/bin/bash
+set -e
+
+# setup ssh: allow key to be used without a prompt and start ssh agent
+export GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no"
+eval "$(ssh-agent -s)"
+
+######## Run notebook/word converter ########
+# word converter using pandoc
+/fastpages/word2post.sh
+# notebook converter using nbdev
+cp /fastpages/settings.ini .
+python /fastpages/nb2post.py
+
+
+######## Optionally save files and build GitHub Pages ########
+if [[ "$INPUT_BOOL_SAVE_MARKDOWN" == "true" ]];then
+
+ if [ -z "$INPUT_SSH_DEPLOY_KEY" ];then
+ echo "You must set the SSH_DEPLOY_KEY input if BOOL_SAVE_MARKDOWN is set to true.";
+ exit 1;
+ fi
+
+ # Get user's email from commit history
+ if [[ "$GITHUB_EVENT_NAME" == "push" ]];then
+ USER_EMAIL=$(jq '.commits | .[0] | .author.email' < "$GITHUB_EVENT_PATH")
+ else
+ USER_EMAIL="actions@github.com"
+ fi
+
+ # Setup Git credentials if we are planning to change the data in the repo
+ git config --global user.name "$GITHUB_ACTOR"
+ git config --global user.email "$USER_EMAIL"
+ git remote add fastpages-origin "git@github.com:$GITHUB_REPOSITORY.git"
+ echo "${INPUT_SSH_DEPLOY_KEY}" > _mykey
+ chmod 400 _mykey
+ ssh-add _mykey
+
+ # Optionally save intermediate markdown
+ if [[ "$INPUT_BOOL_SAVE_MARKDOWN" == "true" ]]; then
+ git pull fastpages-origin "${GITHUB_REF}" --ff-only
+ git add _posts
+ git commit -m "[Bot] Update $INPUT_FORMAT blog posts" --allow-empty
+ git push fastpages-origin HEAD:"$GITHUB_REF"
+ fi
+fi
+
+
diff --git a/_action_files/check_js.sh b/_action_files/check_js.sh
new file mode 100755
index 0000000..61c9936
--- /dev/null
+++ b/_action_files/check_js.sh
@@ -0,0 +1,25 @@
+#!/bin/bash
+# The purpose of this script is to check parity between official hosted third party js libraries, and alternative CDNs used on this site.
+
+function compare {
+ printf "=================\ncomparing:\n%s vs. %s\n" "$1" "$2"
+ wget "$1" -O f1 &> /dev/null
+ wget "$2" -O f2 &> /dev/null
+ if ! cmp f1 f2;
+ then
+ printf "Files are NOT the same!\n"
+ exit 1;
+ else
+ printf "Files are the same.\n"
+ fi
+ }
+
+compare "https://unpkg.com/@primer/css/dist/primer.css" "https://cdnjs.cloudflare.com/ajax/libs/Primer/15.2.0/primer.css"
+#compare "https://hypothes.is/embed.js" "https://cdn.jsdelivr.net/npm/hypothesis/build/boot.js"
+compare "https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/contrib/auto-render.min.js" "https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.12.0/contrib/auto-render.min.js"
+compare "https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/katex.min.css" "https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.12.0/katex.min.css"
+compare "https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/katex.min.js" "https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.12.0/katex.min.js"
+compare "https://cdn.jsdelivr.net/npm/mathjax@2.7.5/MathJax.js" "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js"
+
+# Remove files created for comparison
+rm f1 f2
diff --git a/_action_files/fast_template.py b/_action_files/fast_template.py
new file mode 100755
index 0000000..935e2ff
--- /dev/null
+++ b/_action_files/fast_template.py
@@ -0,0 +1,29 @@
+from datetime import datetime
+import re, os
+from pathlib import Path
+from typing import Tuple, Set
+
+# Check for YYYY-MM-DD
+_re_blog_date = re.compile(r'([12]\d{3}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])-)')
+# Check for leading dashses or numbers
+_re_numdash = re.compile(r'(^[-\d]+)')
+
+def rename_for_jekyll(nb_path: Path, warnings: Set[Tuple[str, str]]=None) -> str:
+ """
+ Return a Path's filename string appended with its modified time in YYYY-MM-DD format.
+ """
+ assert nb_path.exists(), f'{nb_path} could not be found.'
+
+ # Checks if filename is compliant with Jekyll blog posts
+ if _re_blog_date.match(nb_path.name): return nb_path.with_suffix('.md').name.replace(' ', '-')
+
+ else:
+ clean_name = _re_numdash.sub('', nb_path.with_suffix('.md').name).replace(' ', '-')
+
+ # Gets the file's last modified time and and append YYYY-MM-DD- to the beginning of the filename
+ mdate = os.path.getmtime(nb_path) - 86400 # subtract one day b/c dates in the future break Jekyll
+ dtnm = datetime.fromtimestamp(mdate).strftime("%Y-%m-%d-") + clean_name
+ assert _re_blog_date.match(dtnm), f'{dtnm} is not a valid name, filename must be pre-pended with YYYY-MM-DD-'
+ # push this into a set b/c _nb2htmlfname gets called multiple times per conversion
+ if warnings: warnings.add((nb_path, dtnm))
+ return dtnm
diff --git a/_action_files/fastpages-jekyll.Dockerfile b/_action_files/fastpages-jekyll.Dockerfile
new file mode 100755
index 0000000..3e10794
--- /dev/null
+++ b/_action_files/fastpages-jekyll.Dockerfile
@@ -0,0 +1,7 @@
+# Defines https://hub.docker.com/repository/docker/fastai/fastpages-jekyll
+FROM jekyll/jekyll:4.1.0
+
+COPY . .
+RUN chmod -R 777 .
+RUN gem install bundler
+RUN jekyll build
diff --git a/_action_files/fastpages.tpl b/_action_files/fastpages.tpl
new file mode 100644
index 0000000..14077e5
--- /dev/null
+++ b/_action_files/fastpages.tpl
@@ -0,0 +1,22 @@
+{%- extends 'hide.tpl' -%}
+{%- block body -%}
+{%- set internals = ["metadata", "output_extension", "inlining",
+ "raw_mimetypes", "global_content_filter"] -%}
+---
+{%- for k in resources |reject("in", internals) %}
+{% if k == "summary" and "description" not in resources %}description{% else %}{{ k }}{% endif %}: {{ resources[k] }}
+{%- endfor %}
+layout: notebook
+---
+
+
+
+
+ {{ super() }}
+
+{%- endblock body %}
\ No newline at end of file
diff --git a/_action_files/hide.tpl b/_action_files/hide.tpl
new file mode 100644
index 0000000..39ac80f
--- /dev/null
+++ b/_action_files/hide.tpl
@@ -0,0 +1,44 @@
+{%- extends 'basic.tpl' -%}
+
+{% block codecell %}
+ {{ "{% raw %}" }}
+ {{ super() }}
+ {{ "{% endraw %}" }}
+{% endblock codecell %}
+
+{% block input_group -%}
+{%- if cell.metadata.collapse_show -%}
+
+
+ {{ super() }}
+
+{%- elif cell.metadata.collapse_hide -%}
+
+
+ {{ super() }}
+
+{%- elif cell.metadata.hide_input or nb.metadata.hide_input -%}
+{%- else -%}
+ {{ super() }}
+{%- endif -%}
+{% endblock input_group %}
+
+{% block output_group -%}
+{%- if cell.metadata.collapse_output -%}
+
+
+ {{ super() }}
+
+{%- elif cell.metadata.hide_output -%}
+{%- else -%}
+ {{ super() }}
+{%- endif -%}
+{% endblock output_group %}
+
+{% block output_area_prompt %}
+{%- if cell.metadata.hide_input or nb.metadata.hide_input -%}
+
+{%- else -%}
+ {{ super() }}
+{%- endif -%}
+{% endblock output_area_prompt %}
\ No newline at end of file
diff --git a/_action_files/nb2post.py b/_action_files/nb2post.py
new file mode 100755
index 0000000..6edfdae
--- /dev/null
+++ b/_action_files/nb2post.py
@@ -0,0 +1,22 @@
+"""Converts Jupyter Notebooks to Jekyll compliant blog posts"""
+from datetime import datetime
+import re, os, logging
+from nbdev import export2html
+from nbdev.export2html import Config, Path, _to_html, _re_block_notes
+from fast_template import rename_for_jekyll
+
+warnings = set()
+
+# Modify the naming process such that destination files get named properly for Jekyll _posts
+def _nb2htmlfname(nb_path, dest=None):
+ fname = rename_for_jekyll(nb_path, warnings=warnings)
+ if dest is None: dest = Config().doc_path
+ return Path(dest)/fname
+
+# TODO: Open a GitHub Issue in addition to printing warnings
+for original, new in warnings:
+ print(f'{original} has been renamed to {new} to be complaint with Jekyll naming conventions.\n')
+
+## apply monkey patches
+export2html._nb2htmlfname = _nb2htmlfname
+export2html.notebook2html(fname='_notebooks/*.ipynb', dest='_posts/', template_file='/fastpages/fastpages.tpl', execute=False)
diff --git a/_action_files/parse_netlify.py b/_action_files/parse_netlify.py
new file mode 100644
index 0000000..28e3527
--- /dev/null
+++ b/_action_files/parse_netlify.py
@@ -0,0 +1,7 @@
+import sys, re
+logs = sys.stdin.read()
+
+draft_url = re.findall(r'Website Draft URL: .*(https://.*)', logs)[0]
+assert draft_url, 'Was not able to find Draft URL in the logs:\n{}'.format(logs)
+print("::set-output name=draft_url::{}".format(draft_url))
+
diff --git a/_action_files/pr_comment.sh b/_action_files/pr_comment.sh
new file mode 100755
index 0000000..e17fb38
--- /dev/null
+++ b/_action_files/pr_comment.sh
@@ -0,0 +1,39 @@
+#!/bin/sh
+
+# Make a comment on a PR.
+# Usage:
+# > pr_comment.sh <>
+
+set -e
+
+# This is populated by our secret from the Workflow file.
+if [[ -z "${GITHUB_TOKEN}" ]]; then
+ echo "Set the GITHUB_TOKEN env variable."
+ exit 1
+fi
+
+if [[ -z "${ISSUE_NUMBER}" ]]; then
+ echo "Set the ISSUE_NUMBER env variable."
+ exit 1
+fi
+
+if [ -z "$1" ]
+ then
+ echo "No MESSAGE argument supplied. Usage: issue_comment.sh "
+ exit 1
+fi
+
+MESSAGE=$1
+
+## Set Vars
+URI=https://api.github.com
+API_VERSION=v3
+API_HEADER="Accept: application/vnd.github.${API_VERSION}+json"
+AUTH_HEADER="Authorization: token ${GITHUB_TOKEN}"
+
+# Create a comment with APIv3 # POST /repos/:owner/:repo/issues/:issue_number/comments
+curl -XPOST -sSL \
+ -d "{\"body\": \"$MESSAGE\"}" \
+ -H "${AUTH_HEADER}" \
+ -H "${API_HEADER}" \
+ "${URI}/repos/${GITHUB_REPOSITORY}/issues/${ISSUE_NUMBER}/comments"
diff --git a/_action_files/settings.ini b/_action_files/settings.ini
new file mode 100644
index 0000000..415570d
--- /dev/null
+++ b/_action_files/settings.ini
@@ -0,0 +1,43 @@
+[DEFAULT]
+lib_name = nbdev
+user = fastai
+branch = master
+version = 0.2.10
+description = Writing a library entirely in notebooks
+keywords = jupyter notebook
+author = Sylvain Gugger and Jeremy Howard
+author_email = info@fast.ai
+baseurl =
+title = nbdev
+copyright = fast.ai
+license = apache2
+status = 2
+min_python = 3.6
+audience = Developers
+language = English
+requirements = nbformat>=4.4.0 nbconvert>=5.6.1 pyyaml fastscript packaging
+console_scripts = nbdev_build_lib=nbdev.cli:nbdev_build_lib
+ nbdev_update_lib=nbdev.cli:nbdev_update_lib
+ nbdev_diff_nbs=nbdev.cli:nbdev_diff_nbs
+ nbdev_test_nbs=nbdev.cli:nbdev_test_nbs
+ nbdev_build_docs=nbdev.cli:nbdev_build_docs
+ nbdev_nb2md=nbdev.cli:nbdev_nb2md
+ nbdev_trust_nbs=nbdev.cli:nbdev_trust_nbs
+ nbdev_clean_nbs=nbdev.clean:nbdev_clean_nbs
+ nbdev_read_nbs=nbdev.cli:nbdev_read_nbs
+ nbdev_fix_merge=nbdev.cli:nbdev_fix_merge
+ nbdev_install_git_hooks=nbdev.cli:nbdev_install_git_hooks
+ nbdev_bump_version=nbdev.cli:nbdev_bump_version
+ nbdev_new=nbdev.cli:nbdev_new
+ nbdev_detach=nbdev.cli:nbdev_detach
+nbs_path = nbs
+doc_path = images/copied_from_nb
+doc_host = https://nbdev.fast.ai
+doc_baseurl = %(baseurl)s/images/copied_from_nb/
+git_url = https://github.com/fastai/nbdev/tree/master/
+lib_path = nbdev
+tst_flags = fastai2
+custom_sidebar = False
+cell_spacing = 1
+monospace_docstrings = False
+jekyll_styles = note,warning,tip,important,youtube,twitter
diff --git a/_action_files/word2post.py b/_action_files/word2post.py
new file mode 100755
index 0000000..f152d6d
--- /dev/null
+++ b/_action_files/word2post.py
@@ -0,0 +1,8 @@
+import sys
+from pathlib import Path
+from fast_template import rename_for_jekyll
+
+if __name__ == '__main__':
+ file_path = Path(sys.argv[1])
+ new_name = rename_for_jekyll(file_path)
+ print(new_name)
diff --git a/_action_files/word2post.sh b/_action_files/word2post.sh
new file mode 100755
index 0000000..54260b7
--- /dev/null
+++ b/_action_files/word2post.sh
@@ -0,0 +1,33 @@
+#!/bin/sh
+
+# This sets the environment variable when testing locally and not in a GitHub Action
+if [ -z "$GITHUB_ACTIONS" ]; then
+ GITHUB_WORKSPACE='/data'
+ echo "=== Running Locally: All assets expected to be in the directory /data ==="
+fi
+
+# Loops through directory of *.docx files and converts to markdown
+# markdown files are saved in _posts, media assets are saved in assets/img//media
+for FILENAME in "${GITHUB_WORKSPACE}"/_word/*.docx; do
+ [ -e "$FILENAME" ] || continue # skip when glob doesn't match
+ NAME=${FILENAME##*/} # Get filename without the directory
+ NEW_NAME=$(python3 "/fastpages/word2post.py" "${FILENAME}") # clean filename to be Jekyll compliant for posts
+ BASE_NEW_NAME=${NEW_NAME%.md} # Strip the file extension
+
+ if [ -z "$NEW_NAME" ]; then
+ echo "Unable To Rename: ${FILENAME} to a Jekyll complaint filename for blog posts"
+ exit 1
+ fi
+
+ echo "Converting: ${NAME} ---to--- ${NEW_NAME}"
+ cd ${GITHUB_WORKSPACE} || { echo "Failed to change to Github workspace directory"; exit 1; }
+ pandoc --from docx --to gfm --output "${GITHUB_WORKSPACE}/_posts/${NEW_NAME}" --columns 9999 \
+ --extract-media="assets/img/${BASE_NEW_NAME}" --standalone "${FILENAME}"
+
+ # Inject correction to image links in markdown
+ sed -i.bak 's/!\[\](assets/!\[\]({{ site.url }}{{ site.baseurl }}\/assets/g' "_posts/${NEW_NAME}"
+ # Remove intermediate files
+ rm _posts/*.bak 2> /dev/null || true
+
+ cat "${GITHUB_WORKSPACE}/_action_files/word_front_matter.txt" "_posts/${NEW_NAME}" > temp && mv temp "_posts/${NEW_NAME}"
+done
diff --git a/_action_files/word_front_matter.txt b/_action_files/word_front_matter.txt
new file mode 100644
index 0000000..f733c79
--- /dev/null
+++ b/_action_files/word_front_matter.txt
@@ -0,0 +1,3 @@
+---
+layout: post
+---
diff --git a/_config.yml b/_config.yml
new file mode 100644
index 0000000..d1b943a
--- /dev/null
+++ b/_config.yml
@@ -0,0 +1,122 @@
+# Welcome to Jekyll!
+#
+# This config file is meant for settings that affect your whole blog.
+#
+# If you need help with YAML syntax, here are some quick references for you:
+# https://learn-the-web.algonquindesign.ca/topics/markdown-yaml-cheat-sheet/#yaml
+# https://learnxinyminutes.com/docs/yaml/
+
+title: fastpages
+description: An easy to use blogging platform with support for Jupyter Notebooks.
+github_username: fastai
+# you can comment the below line out if your repo name is not different than your baseurl
+github_repo: "fastpages"
+
+# OPTIONAL: override baseurl and url if using a custom domain
+# Note: leave out the trailing / from this value.
+url: "https://fastpages.fast.ai" # the base hostname & protocol for your site, e.g. http://example.com
+
+###########################################################
+######### Special Instructions for baseurl ###############
+#
+#### Scenario One: If you do not have a Custom Domain #####
+# - if you are not using a custom domain, the baseurl *must* be set to your repo name
+#
+#### Scenario Two: If you have a Custom Domain #####
+# 1. If your domain does NOT have a subpath, this leave this value as ""
+# 2. If your domain does have a subpath, you must preceed the value with a / and NOT have a / at the end.
+# For example:
+# "" is valid
+# "/blog" is valid
+# "/blog/site/" is invalid ( / at the end)
+# "/blog/site" is valid
+# "blog/site" is invalid ( because doesn't begin with a /)
+#
+# 3. You must replace the parameter `baseurl` in _action_files/settings.ini with the same value as you set here but WITHOUT QUOTES.
+#
+baseurl: "" # the subpath of your site, e.g. "/blog".
+
+# Github and twitter are optional:
+minima:
+ social_links:
+ twitter: fastdotai
+ github: fastai
+
+# Set this to true to get LaTeX math equation support
+use_math:
+
+# Set this to true to display the summary of your blog post under your title on the Home page.
+show_description: true
+
+# Set this to true to display image previews on home page, if they exist
+show_image: false
+
+# Set this to true to turn on annotations with hypothes.is (https://web.hypothes.is/)
+annotations: false
+
+# Set this to true to display tags on each post
+show_tags: true
+
+# Add your Google Analytics ID here if you have one and want to use it
+google_analytics: UA-57531313-5
+
+exclude:
+ - docker-compose.yml
+ - action.yml
+ - Makefile
+
+# this setting allows you to keep pages organized in the _pages folder
+include:
+ - _pages
+
+# This specifies what badges are turned on by default for notebook posts.
+default_badges:
+ github: true
+ binder: true
+ colab: true
+
+# Escape HTML in post descriptions
+html_escape:
+ description: false
+
+# Everything below here should be left alone. Modifications may break fastpages
+future: true
+theme: minima
+plugins:
+ - jekyll-feed
+ - jekyll-gist
+ - jekyll-octicons
+ - jekyll-toc
+ - jekyll-twitter-plugin
+ - jekyll-relative-links
+ - jekyll-seo-tag
+ - jekyll-remote-theme
+ - jekyll-paginate
+ - jekyll-sitemap
+ - jemoji
+
+# See https://jekyllrb.com/docs/pagination/
+# For pagination to work, you cannot have index.md at the root of your repo, instead you must rename this file to index.html
+paginate: 15
+paginate_path: /page:num/
+
+remote_theme: jekyll/minima
+
+titles_from_headings:
+ enabled: true
+ strip_title: true
+ collections: true
+
+highlighter: rouge
+markdown: kramdown
+kramdown:
+ math_engine: katex
+ input: GFM
+ auto_ids: true
+ hard_wrap: false
+ syntax_highlighter: rouge
+
+# to limit size of xml as it can grow quite large.
+feed:
+ posts_limit: 5 #default posts_limit: 10
+ excerpt_only: true
diff --git a/_fastpages_docs/CONTRIBUTING.md b/_fastpages_docs/CONTRIBUTING.md
new file mode 100644
index 0000000..beeb719
--- /dev/null
+++ b/_fastpages_docs/CONTRIBUTING.md
@@ -0,0 +1,63 @@
+_Adapted from [fastai/nbdev/CONTRIBUTING.md](https://github.com/fastai/nbdev/blob/master/CONTRIBUTING.md)_
+
+# How to contribute to fastpages
+
+First, thanks a lot for wanting to help! Some things to keep in mind:
+
+- The jupyter to blog post conversion functionality relies on [fastai/nbdev](https://github.com/fastai/nbdev). For idiosyncratic uses of nbdev that only apply to blogs that would require a large refactor to nbdev, it might be acceptable to apply a [monkey patch](https://stackoverflow.com/questions/5626193/what-is-monkey-patching) in `fastpages`. However, it is encouraged to contribute to `nbdev` where possible if there is a change that could unlock a new feature. If you are unsure, please open an issue in this repo to discuss.
+
+
+## Note for new contributors from Jeremy
+
+It can be tempting to jump into a new project by questioning the stylistic decisions that have been made, such as naming, formatting, and so forth. This can be especially so for python programmers contributing to this project, which is unusual in following a number of conventions that are common in other programming communities, but not in Python. However, please don’t do this, for (amongst others) the following reasons:
+
+- Contributing to [Parkinson’s law of triviality](https://www.wikiwand.com/en/Law_of_triviality) has negative consequences for a project. Let’s focus on deep learning!
+- It’s exhausting to repeat the same discussion over and over again, especially when it’s been well documented already. When you have a question about the project, please check the pages in the docs website linked here.
+- You’re likely to get a warmer welcome from the community if you start out by contributing something that’s been requested on the forum, since you’ll be solving someone’s current problem.
+- If you start out by just telling us your point of view, rather than studying the background behind the decisions that have been made, you’re unlikely to be contributing anything new or useful.
+- I’ve been writing code for nearly 40 years now, across dozens of languages, and other folks involved have quite a bit of experience too - the approaches used are based on significant experience and research. Whilst there’s always room for improvement, it’s much more likely you’ll be making a positive contribution if you spend a few weeks studying and working within the current framework before suggesting wholesale changes.
+
+
+## Did you find a bug?
+
+* Nobody is perfect, especially not us. But first, please double-check the bug doesn't come from something on your side. The [forum](http://forums.fast.ai/) is a tremendous source for help, and we'd advise to use it as a first step. Be sure to include as much code as you can so that other people can easily help you.
+* Then, ensure the bug was not already reported by searching on GitHub under [Issues](https://github.com/fastai/fastpages/issues).
+* If you're unable to find an open issue addressing the problem, [open a new one](https://github.com/fastai/fastpages/issues/new). Be sure to include a title and clear description, as much relevant information as possible, and a code sample or an executable test case demonstrating the expected behavior that is not occurring.
+* Be sure to add the complete error messages.
+
+#### Did you write a patch that fixes a bug?
+
+* Open a new GitHub pull request with the patch.
+* Ensure that your PR includes a test that fails without your patch, and pass with it.
+* Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.
+* Before submitting, please be sure you abide by our [coding style](https://docs.fast.ai/dev/style.html) (where appropriate) and [the guide on abbreviations](https://docs.fast.ai/dev/abbr.html) and clean-up your code accordingly.
+
+## Do you intend to add a new feature or change an existing one?
+
+* You can suggest your change on the [fastai forum](http://forums.fast.ai/) to see if others are interested or want to help.
+* Once your approach has been discussed and confirmed on the forum, you are welcome to push a PR, including a complete description of the new feature and an example of how it's used. Be sure to document your code in the notebook.
+* Ensure that your code includes tests that exercise not only your feature, but also any other code that might be impacted.
+
+## PR submission guidelines
+
+Some general rules of thumb that will make your life easier.
+
+* Test locally before opening a pull request. See [the development guide](_fastpages_docs/DEVELOPMENT.md) for instructions on how to run fastpages on your local machine.
+* When you do open a pull request, please request a draft build of your PR by making a **comment with the magic command `/preview` in the pull request.** This will allow reviewers to see a live-preview of your changes without having to clone your branch.
+ * You can do this multiple times, if necessary, to rebuild your preview due to changes. But please do not abuse this and test locally before doing this.
+
+* Keep each PR focused. While it's more convenient, do not combine several unrelated fixes together. Create as many branches as needing to keep each PR focused.
+* Do not mix style changes/fixes with "functional" changes. It's very difficult to review such PRs and it most likely get rejected.
+* Do not add/remove vertical whitespace. Preserve the original style of the file you edit as much as you can.
+* Do not turn an already submitted PR into your development playground. If after you submitted PR, you discovered that more work is needed - close the PR, do the required work and then submit a new PR. Otherwise each of your commits requires attention from maintainers of the project.
+* If, however, you submitted a PR and received a request for changes, you should proceed with commits inside that PR, so that the maintainer can see the incremental fixes and won't need to review the whole PR again. In the exception case where you realize it'll take many many commits to complete the requests, then it's probably best to close the PR, do the work and then submit it again. Use common sense where you'd choose one way over another.
+* When you open a pull request, you can generate a live preview build of how the blog site will look by making a comment in the PR that contains this command: `/preview`. GitHub will build your site and drop a temporary link for everyone to review. You can do this as multiple times if necessary, however, as mentioned previously do not turn an already submitted PR into a development playground.
+
+## Do you have questions about the source code?
+
+* Please ask it on the [fastai forum](http://forums.fast.ai/) (after searching someone didn't ask the same one before with a quick search). We'd rather have the maximum of discussions there so that the largest number can benefit from it.
+
+## Do you want to contribute to the documentation?
+
+* PRs are welcome for this. For any confusion about the documentation, please feel free to open an issue on this repo.
+
diff --git a/_fastpages_docs/DEVELOPMENT.md b/_fastpages_docs/DEVELOPMENT.md
new file mode 100644
index 0000000..1d08b73
--- /dev/null
+++ b/_fastpages_docs/DEVELOPMENT.md
@@ -0,0 +1,102 @@
+# Development Guide
+ - [Seeing All Options From the Terminal](#seeing-all-commands-in-the-terminal)
+ - [Basic usage: viewing your blog](#basic-usage-viewing-your-blog)
+ - [Converting the pages locally](#converting-the-pages-locally)
+ - [Visual Studio Code integration](#visual-studio-code-integration)
+ - [Advanced usage](#advanced-usage)
+ - [Rebuild all the containers](#rebuild-all-the-containers)
+ - [Removing all the containers](#removing-all-the-containers)
+ - [Attaching a shell to a container](#attaching-a-shell-to-a-container)
+ - [Running a Jupyter Server](#running-a-jupyter-server)
+
+You can run your fastpages blog on your local machine, and view any changes you make to your posts, including Jupyter Notebooks and Word documents, live.
+The live preview requires that you have Docker installed on your machine. [Follow the instructions on this page if you need to install Docker.](https://www.docker.com/products/docker-desktop)
+
+## Seeing All Commands In The Terminal
+
+There are many different `docker-compose` commands that are necessary to manage the lifecycle of the fastpages Docker containers. To make this easier, we aliased common commands in a [Makefile](https://www.gnu.org/software/make/manual/html_node/Introduction.html).
+
+You can quickly see all available commands by running this command in the root of your repository:
+
+`make`
+
+## Basic usage: viewing your blog
+
+All of the commands in this block assume that you're in your blog root directory.
+To run the blog with live preview:
+
+```bash
+make server
+```
+
+When you run this command for the first time, it'll build the required Docker images, and the process might take a couple minutes.
+
+This command will build all the necessary containers and run the following services:
+1. A service that monitors any changes in `./_notebooks/*.ipynb/` and `./_word/*.docx;*.doc` and rebuild the blog on change.
+2. A Jekyll server on https://127.0.0.1:4000 — use this to preview your blog.
+
+The services will output to your terminal. If you close the terminal or hit `Ctrl-C`, the services will stop.
+If you want to run the services in the background:
+
+```bash
+# run all services in the background
+make server-detached
+
+# stop the services
+make stop
+```
+
+If you need to restart just the Jekyll server, and it's running in the background — you can do `make restart-jekyll`.
+
+_Note that the blog won't autoreload on change, you'll have to refresh your browser manually._
+
+**If containers won't start**: try `make build` first, this would rebuild all the containers from scratch, This might fix the majority of update problems.
+
+## Converting the pages locally
+
+If you just want to convert your notebooks and word documents to `.md` posts in `_posts`, this command will do it for you:
+
+```bash
+make convert
+```
+
+You can launch just the jekyll server with `make server`.
+
+## Visual Studio Code integration
+
+If you're using VSCode with the Docker extension, you can run these containers from the sidebar: `fastpages_watcher_1` and `fastpages_jekyll_1`.
+The containers will only show up in the list after you run or build them for the first time. So if they're not in the list — try `make build` in the console.
+
+## Advanced usage
+
+### Rebuild all the containers
+If you changed files in `_action_files` directory, you might need to rebuild the containers manually, without cache.
+
+```bash
+make build
+```
+
+### Removing all the containers
+Want to start from scratch and remove all the containers?
+
+```
+make remove
+```
+
+### Attaching a shell to a container
+You can attach a terminal to a running service:
+
+```bash
+
+# If the container is already running:
+
+# attach to a bash shell in the jekyll service
+make bash-jekyll
+
+# attach to a bash shell in the watcher service.
+make bash-nb
+```
+
+_Note: you can use `docker-compose run` instead of `make bash-nb` or `make bash-jekyll` to start a service and then attach to it.
+Or you can run all your services in the background, `make server-detached`, and then use `make bash-nb` or `make bash-jekyll` as in the examples above._
+
diff --git a/_fastpages_docs/NOTEBOOK_FOOTNOTES.md b/_fastpages_docs/NOTEBOOK_FOOTNOTES.md
new file mode 100644
index 0000000..1cd8150
--- /dev/null
+++ b/_fastpages_docs/NOTEBOOK_FOOTNOTES.md
@@ -0,0 +1,30 @@
+# Detailed Guide To Footnotes in Notebooks
+
+Notebook -> HTML Footnotes don't work the same as Markdown. There isn't a good solution, so made these Jekyll plugins as a workaround
+
+```
+This adds a linked superscript {% fn 15 %}
+
+{{ "This is the actual footnote" | fndetail: 15 }}
+```
+
+
+
+You can have links, but then you have to use **single quotes** to escape the link.
+```
+This adds a linked superscript {% fn 20 %}
+
+{{ 'This is the actual footnote with a [link](www.github.com) as well!' | fndetail: 20 }}
+```
+
+
+However, what if you want a single quote in your footnote? There is not an easy way to escape that. Fortunately, you can use the special HTML character `'` (you must keep the semicolon!). For example, you can include a single quote like this:
+
+
+```
+This adds a linked superscript {% fn 20 %}
+
+{{ 'This is the actual footnote; with a [link](www.github.com) as well! and a single quote ' too!' | fndetail: 20 }}
+```
+
+
diff --git a/_fastpages_docs/README_TEMPLATE.md b/_fastpages_docs/README_TEMPLATE.md
new file mode 100644
index 0000000..d373fd6
--- /dev/null
+++ b/_fastpages_docs/README_TEMPLATE.md
@@ -0,0 +1,29 @@
+[//]: # (This template replaces README.md when someone creates a new repo with the fastpages template.)
+
+
+
+[](https://github.com/fastai/fastpages)
+
+https://{_username_}.github.io/{_repo_name_}/
+
+# My Blog
+
+
+_powered by [fastpages](https://github.com/fastai/fastpages)_
+
+
+## What To Do Next?
+
+Great! You have setup your repo. Now its time to start writing content. Some helpful links:
+
+- [Writing Blogs With Jupyter](https://github.com/fastai/fastpages#writing-blog-posts-with-jupyter)
+
+- [Writing Blogs With Markdown](https://github.com/fastai/fastpages#writing-blog-posts-with-markdown)
+
+- [Writing Blog Posts With Word](https://github.com/fastai/fastpages#writing-blog-posts-with-microsoft-word)
+
+- [(Optional) Preview Your Blog Locally](_fastpages_docs/DEVELOPMENT.md)
+
+Note: you may want to remove example blog posts from the `_posts`, `_notebooks` or `_word` folders (but leave them empty, don't delete these folders) if you don't want these blog posts to appear on your site.
+
+Please use the [nbdev & blogging channel](https://forums.fast.ai/c/fastai-users/nbdev/48) in the fastai forums for any questions or feature requests.
diff --git a/_fastpages_docs/TROUBLESHOOTING.md b/_fastpages_docs/TROUBLESHOOTING.md
new file mode 100644
index 0000000..80df35e
--- /dev/null
+++ b/_fastpages_docs/TROUBLESHOOTING.md
@@ -0,0 +1,66 @@
+# Filing Bugs & Troubleshooting
+
+These are required prerequisites before filing an issue on GitHub or on the [fastai forums](https://forums.fast.ai/)
+
+## Step 1: Attempt To Upgrade fastpages
+
+See the [Upgrading guide](https://github.com/fastai/fastpages/blob/master/_fastpages_docs/UPGRADE.md).
+
+**In addition to upgrading**, if developing locally, refresh your Docker containers with the following commands from the root of your repo:
+
+`make remove` followed by `make build`
+
+## Step 2: Search Relevant Places For Similar Issues
+
+- [ ] Search the [fastai forums](https://forums.fast.ai/) for similar problems.
+- [ ] Search issues on the [fastpages repo](https://github.com/fastai/fastpages/) for a similar problems?
+- [ ] Read the [README of the repo](https://github.com/fastai/fastpages/blob/master/README.md) carefully
+
+
+## Step 3: Observe Build Logs When Developing Locally
+
+- [ ] Run the [fastpages blog server locally](DEVELOPMENT.md)
+ - Pay attention to the emitted logs when you save your notebooks or files. Often, you will see errors here that will give you important clues.
+- [ ] When developing locally, you will notice that Jupyter notebooks are converted to corresponding markdown files in the `_posts` folder. Take a look at the problematic blog posts and see if you can spot the offending HTML or markdown in that code.
+- Use your browser's developer tools to see if there are any errors. Common errors are (1) not able to find images because they have not been saved into the right folder, (2) javascript or other errors.
+- If you receive a Jekyll build error or a Liquid error, search for this error on Stack Overflow to provide more insight on the problem.
+
+## Step 4: See if there are errors in the build process of GitHub Actions.
+
+- [ ] In your GitHub repository, you will have a tab called **Actions**. To find build errors, click on the `Event` dropdown list and select `push`. Browse through tthe logs to see if you can find an error. If you receive an error, read the error message and try to debug.
+
+## Step 5: Once you have performed all the above steps, post your issue in the fastai forums or a GitHub Issue.
+
+- [ ] Use the [nbdev & blogging category](https://forums.fast.ai/c/fastai-users/nbdev/48) to specify your problem if posting on the fastpages forums.
+- [ ] If you cannot find a similar issue create a new thread instead of commenting on an unrelated one.
+- When reporting a bug, provide this information:
+
+ 1. Steps to reproduce the problem
+ 2. **A link to the notebook or markdown file** where the error is occuring
+ 3. If the error is happening in GitHub Actions, a link to the specific error along with how you are able to reproduce this error. You must provide this **in addition to the link to the notebook or markdown file**.
+ 4. A screenshot / dump of relevant logs or error messages you are receiving from your local development environment. the local development server as indicated in the [development guide](https://github.com/fastai/fastpages/blob/master/_fastpages_docs/DEVELOPMENT.md).
+
+
+**You must provide ALL of the above information**.
+
+# Frequent Errors
+
+1. Malformed front matter. Note that anything defined in front matter must be valid YAML. **Failure to provide valid YAML could result in your page not rendering** in your blog. For example, if you want a colon in your title you must escape it with double quotes like this:
+
+ ` - title: "Deep learning: A tutorial"`
+
+ or in a notebook
+
+ `# "Deep learning: A tutorial"`
+
+ See this [tutorial on YAML](https://rollout.io/blog/yaml-tutorial-everything-you-need-get-started/) for more information.
+
+ **Colons, tilda, asteriks and other characters may cause your front matter to break and for your posts to not render.** If you violoate these conventions you often get an error that looks something like this:
+
+ ```bash
+ Error: YAML Exception reading ... (): mapping values are not allowed
+ ```
+
+2. Can you customize the styling or theme of fastpages? **A**: See [Customizing Fastpages](https://github.com/fastai/fastpages#customizing-fastpages)
+
+See the [FAQ](https://github.com/fastai/fastpages#faq) for frequently asked questions.
diff --git a/_fastpages_docs/UPGRADE.md b/_fastpages_docs/UPGRADE.md
new file mode 100644
index 0000000..55cdb4b
--- /dev/null
+++ b/_fastpages_docs/UPGRADE.md
@@ -0,0 +1,71 @@
+# Upgrading fastpages
+
+
+
+- [Automated Upgrade](#automated-upgrade)
+ - [Step 1: Open An Issue With The Upgrade Template.](#step-1-open-an-issue-with-the-upgrade-template)
+ - [Step 2: Click `Submit new issue`](#step-2-click-submit-new-issue)
+ - [Step 3: A Link to Pull Request Will Appear](#step-3-a-link-to-pull-request-will-appear)
+ - [Step 4: Review & Merge PR](#step-4-review-merge-pr)
+- [Manual Upgrade](#manual-upgrade)
+ - [Easy Way (Recommended)](#easy-way-recommended)
+ - [Advanced](#advanced)
+- [Additional Resources](#additional-resources)
+
+
+There are two ways to upgrade fastpages. One is an automated way that assumes you have made no changes to the HTML of your site. Alternatively, you may [upgrade manually](#manual-upgrade) and determine which changes to accept or reject. For most people we recommend upgrading fastpages automatically.
+
+## Automated Upgrade
+
+ - This method is appropriate for those who have not customized the HTML of their site.
+ - **If you are unsure, try the Automated approach and review which files are changed in the automated PR** to see if this appropriate for you.
+
+### Step 1: Open An Issue With The Upgrade Template.
+
+- Open a new issue in your repository, and push the "Get Started" button for the `[fastpages] Automated Upgrade` Issue template, which looks like this:
+ - **IF YOU DON'T SEE THIS**: you have an older version of fastpages and you **must [manually upgrade](#manual-upgrade) once** to get this new functionality.
+
+ 
+
+### Step 2: Click `Submit new issue`
+
+- Be careful not to change anything before clicking the button.
+
+ 
+
+### Step 3: A Link to Pull Request Will Appear
+
+- This issue will trigger GitHub to open a PR making changes to your repository for the upgrade to take palce. A comment with the link to the PR will be made in the issue, and will look like this:
+
+ 
+
+ It is possible that you might receive an error message instead of this command. You can follow the instructions in the comment to troubleshoot the issue. Common reasons for receiving an error are:
+
+ - You are up to date, therefore no upgrade is possible. You will see an error that there is "nothing to commit".
+ - You already have a PR from a prevoius upgrade open that you never merged.
+
+ Please [ask on the forums](https://forums.fast.ai/) if you have encounter another problem that is unclear.
+
+### Step 4: Review & Merge PR
+
+- Ensure that you read the instructions in the PR carefully. Furthermore, carefully review which files will be changed to determine if this interferes with any customizations you have mades to your site. When ready, select `Merge pull request`.
+- If the PR is making undesired changes to files you can use the manual upgrade approach instead.
+
+## Manual Upgrade
+
+### Easy Way (Recommended)
+
+Create a new repo with the current `fastpages` template by following the [setup instructions](https://github.com/fastai/fastpages#setup-instructions) in the README, and copy all of your blog posts from `_notebooks`, `_word`, and `_posts` into the new template. This is very similar to what the automated process is doing.
+
+### Advanced
+
+- This method is appropriate for those who made customizations to the HTML of fastpages.
+- You must proceed with caution, as new versions of fastpages may not be compatible with your customizations.
+- You can use git to perform the upgrade by [following this approach](https://stackoverflow.com/questions/56577184/github-pull-changes-from-a-template-repository/56577320) instead. A step-by-step companion to this stack overflow post with screenshots is [written up here](https://github.com/fastai/fastpages/issues/163#issuecomment-593766189).
+- Be careful to not duplicate files, as files in fastpages have been reorganized several times.
+
+
+## Additional Resources
+
+- [This Actions workflow](/.github/workflows/upgrade.yaml) defines the automated upgrade process.
+- You can get more help with upgrading in the [fastai forums - nbdev & blogging category](https://forums.fast.ai/c/fastai-users/nbdev/48).
diff --git a/_fastpages_docs/_checkbox.png b/_fastpages_docs/_checkbox.png
new file mode 100644
index 0000000000000000000000000000000000000000..19b5b2c787774025f671e2ac8bed45284f409883
GIT binary patch
literal 21148
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
literal 0
HcmV?d00001
diff --git a/_fastpages_docs/_manual_setup.md b/_fastpages_docs/_manual_setup.md
new file mode 100644
index 0000000..5d3e5ef
--- /dev/null
+++ b/_fastpages_docs/_manual_setup.md
@@ -0,0 +1,41 @@
+# Manual Setup Instructions
+
+These are the setup steps that are automated by [setup.yaml](.github/workflows/setup.yaml)
+
+1. Click the [](https://github.com/fastai/fastpages/generate) button to create a copy of this repo in your account.
+
+2. [Follow these instructions to create an ssh-deploy key](https://developer.github.com/v3/guides/managing-deploy-keys/#deploy-keys). Make sure you **select Allow write access** when adding this key to your GitHub account.
+
+3. [Follow these instructions to upload your deploy key](https://help.github.com/en/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets) as an encrypted secret on GitHub. Make sure you name your key `SSH_DEPLOY_KEY`. Note: The deploy key secret is your **private key** (NOT the public key).
+
+4. [Create a branch](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository#creating-a-branch) named `gh-pages`.
+
+5. Change the badges on this README to point to **your** repository instead of `fastai/fastpages`. Badges are organized in a section at the beginning of this README. For example, you should replace `fastai` and `fastpages` in the below url:
+
+ ``
+
+ to
+
+ ``
+
+6. Change `baseurl:` in `_config.yaml` to the name of your repository. For example, instead of
+
+ `baseurl: "/fastpages"`
+
+ this should be
+
+ `baseurl: "/your-repo-name"`
+
+7. Similarly, change the `url:` parameter in `_config.yaml` to the url your blog will be served on. For example, instead of
+
+ `url: "https://fastpages.fast.ai/"`
+
+ this should be
+
+ `url: "https://.github.io"`
+
+8. Read through `_config.yaml` carefully as there may be other options that must be set. The comments in this file will provide instructions.
+
+9. Delete the `CNAME` file from the root of your `master` branch (or change it if you are using a custom domain)
+
+10. Go to your [repository settings and enable GitHub Pages](https://help.github.com/en/enterprise/2.13/user/articles/configuring-a-publishing-source-for-github-pages) with the `gh-pages` branch you created earlier.
\ No newline at end of file
diff --git a/_fastpages_docs/_paginate.png b/_fastpages_docs/_paginate.png
new file mode 100644
index 0000000000000000000000000000000000000000..c5fbfc75f53854338b0e1d33f2d0fb95b4e0dc7e
GIT binary patch
literal 6990
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
literal 0
HcmV?d00001
diff --git a/_fastpages_docs/_post_tags.png b/_fastpages_docs/_post_tags.png
new file mode 100644
index 0000000000000000000000000000000000000000..4c948b62026ee9a19ce0afe8b3c9b57fc1f7c0aa
GIT binary patch
literal 21294
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
literal 0
HcmV?d00001
diff --git a/_fastpages_docs/_setup_pr_template.md b/_fastpages_docs/_setup_pr_template.md
new file mode 100644
index 0000000..8d49f65
--- /dev/null
+++ b/_fastpages_docs/_setup_pr_template.md
@@ -0,0 +1,41 @@
+Hello :wave: @{_username_}! Thank you for using fastpages!
+
+## Before you merge this PR
+
+1. Create an ssh key-pair. Open this utility. Select: `RSA` and `4096` and leave `Passphrase` blank. Click the blue button `Generate-SSH-Keys`.
+
+2. Navigate to this link and click `New repository secret`. Copy and paste the **Private Key** into the `Value` field. This includes the "---BEGIN RSA PRIVATE KEY---" and "--END RSA PRIVATE KEY---" portions. **In the `Name` field, name the secret `SSH_DEPLOY_KEY`.**
+
+3. Navigate to this link and click the `Add deploy key` button. Paste your **Public Key** from step 1 into the `Key` box. In the `Title`, name the key anything you want, for example `fastpages-key`. Finally, **make sure you click the checkbox next to `Allow write access`** (pictured below), and click `Add key` to save the key.
+
+
+
+
+### What to Expect After Merging This PR
+
+- GitHub Actions will build your site, which will take 2-3 minutes to complete. **This will happen anytime you push changes to the master branch of your repository.** You can monitor the logs of this if you like on the [Actions tab of your repo](https://github.com/{_username_}/{_repo_name_}/actions).
+- Your GH-Pages Status badge on your README will eventually appear and be green, indicating your first sucessfull build.
+- You can monitor the status of your site in the GitHub Pages section of your [repository settings](https://github.com/{_username_}/{_repo_name_}/settings).
+
+If you are not using a custom domain, your website will appear at:
+
+#### https://{_username_}.github.io/{_repo_name_}
+
+
+## Optional: Using a Custom Domain
+
+1. After merging this PR, add a file named `CNAME` at the root of your repo. For example, the `fastpages` blog is hosted at `https://fastpages.fast.ai`, which means [our CNAME](https://github.com/fastai/fastpages/blob/master/CNAME) contains the following contents:
+
+
+ >`fastpages.fast.ai`
+
+
+2. Change the `url` and `baseurl` parameters in your `/_config.yml` file to reflect your custom domain.
+
+
+ Wondering how to setup a custom domain? See [this article](https://dev.to/trentyang/how-to-setup-google-domain-for-github-pages-1p58). You must add a CNAME file to the root of your master branch for the intructions in the article to work correctly.
+
+
+## Questions
+
+Please use the [nbdev & blogging channel](https://forums.fast.ai/c/fastai-users/nbdev/48) in the fastai forums for any questions or feature requests.
diff --git a/_fastpages_docs/_show_image_true.png b/_fastpages_docs/_show_image_true.png
new file mode 100644
index 0000000000000000000000000000000000000000..b6c0a7cd28d0df6ece72d233e66a460701b6c385
GIT binary patch
literal 82874
zcmeFYWmH^E^Djzp4Hh7{1xb)W65KVoyF-8wWYED~g9Ji?1q%@*xZB|FL4vymmjMPD
z;Oyl2pZDQCcdfhD{dPZ`S+i&N^lq)HuCA{7?YHWx@_5)3*hol7cnU9NG?9>y*MZ9%
z6CKED4~G;YAz}B~NlU9MNK4bHyMk@(9ITO$UcOCA!O+&)CJMUq9ha60LK?$r!WzS(
zVVL9;Q_
zamnjZ%ojxMKPvfEc0PIXb@YRn24OR%JyH-$`OK;|(#!6s%;W(D+0}$p
z%sK3OWcv1A-lO%S8RM|`P;-cl%_Qmo0iW8fQpQ9}mvVB?t4gg6k?ItMHeNI$4Rqnd
zI|S985fAUTaY1E5rsJ+)!d~hEoQCWy5_VgQ6KI(osWZzBOBx6-Hp}K+C%?s~dIy^_
zKgVupf}JYiMdiAStG>qg;D-xY)k*<2sVp|xy@6Dl8ZYM3=c0yATQL2Ti%UfQwB0aC
z=U}>xg3qg?*!a?U&SbgX-7PE>Kbw=Q0eIHa%Ygti_RCqS0PW9yhkI#P-csGl$_g1!
zKF;`U{xxC_IN8QUuiIOm_KjO;EK};D>RFQ;Wh&JA$6(Fc6P_}t!;+WQ_2XklUX6KN(Mk}@CS4}!!fuwe9
zZ5#|<;*W~c`D^l6DRH8F{!XB9kNTwl#M-O5p3Bp2q2}s7mPU(qzu`42fC$Owzgi8>ri+n`=E+zF6
zn