Skip to content

Commit 0d5d206

Browse files
ZacharyGaoZacharyGao
authored
Initial commit
0 parents  commit 0d5d206

File tree

273 files changed

+53462
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

273 files changed

+53462
-0
lines changed

‎.all-contributorsrc

+44
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
{
2+
"files": ["README.md"],
3+
"imageSize": 100,
4+
"commit": false,
5+
"contributorsPerLine": 7,
6+
"projectName": "al-folio",
7+
"projectOwner": "alshedivat",
8+
"repoType": "github",
9+
"repoHost": "https://github.com",
10+
"badgeTemplate": "[core_contributors]: https://img.shields.io/badge/core_contributors-<%= contributors.length %>-orange.svg 'Number of core contributors'",
11+
"contributorTemplate": "<a href=\"<%= contributor.profile %>\"><img src=\"<%= contributor.avatar_url %>\" width=\"<%= options.imageSize %>px;\" alt=\"\"/><br /><sub><b><%= contributor.name %></b></sub></a>",
12+
"skipCi": true,
13+
"contributors": [
14+
{
15+
"login": "alshedivat",
16+
"name": "Maruan",
17+
"avatar_url": "https://avatars.githubusercontent.com/u/2126561?v=4",
18+
"profile": "http://maruan.alshedivat.com",
19+
"contributions": ["design", "code"]
20+
},
21+
{
22+
"login": "rohandebsarkar",
23+
"name": "Rohan Deb Sarkar",
24+
"avatar_url": "https://avatars.githubusercontent.com/u/50144004?v=4",
25+
"profile": "http://rohandebsarkar.github.io",
26+
"contributions": ["code"]
27+
},
28+
{
29+
"login": "pourmand1376",
30+
"name": "Amir Pourmand",
31+
"avatar_url": "https://avatars.githubusercontent.com/u/32064808?v=4",
32+
"profile": "https://amirpourmand.ir",
33+
"contributions": ["code"]
34+
},
35+
{
36+
"login": "george-gca",
37+
"name": "George",
38+
"avatar_url": "https://avatars.githubusercontent.com/u/31376482?v=4",
39+
"profile": "https://george-gca.github.io/",
40+
"contributions": ["code"]
41+
}
42+
],
43+
"commitConvention": "angular"
44+
}

‎.dockerignore

+3
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
_site/
2+
.git/
3+
assets/

‎.git-blame-ignore-revs

+24
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# Template taken from https://github.com/v8/v8/blob/master/.git-blame-ignore-revs.
2+
#
3+
# This file contains a list of git hashes of revisions to be ignored by git blame. These
4+
# revisions are considered "unimportant" in that they are unlikely to be what you are
5+
# interested in when blaming. Most of these will probably be commits related to linting
6+
# and code formatting.
7+
#
8+
# Instructions:
9+
# - Only large (generally automated) reformatting or renaming CLs should be
10+
# added to this list. Do not put things here just because you feel they are
11+
# trivial or unimportant. If in doubt, do not put it on this list.
12+
# - Precede each revision with a comment containing the PR title and number.
13+
# For bulk work over many commits, place all commits in a block with a single
14+
# comment at the top describing the work done in those commits.
15+
# - Only put full 40-character hashes on this list (not short hashes or any
16+
# other revision reference).
17+
# - Append to the bottom of the file (revisions should be in chronological order
18+
# from oldest to newest).
19+
# - Because you must use a hash, you need to append to this list in a follow-up
20+
# PR to the actual reformatting PR that you are trying to ignore.
21+
22+
# Format all the code using prettier.io. (#2048, #2062)
23+
beb6f27d596e753014cb9bff1939e5f78d66431c
24+
2d34024961c3a3d27d6fd18ce06a551657983234

‎.github/ISSUE_TEMPLATE/1_bug_report.yml

+101
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,101 @@
1+
name: 🐛 Report a bug
2+
description: Any errors.
3+
labels: ["needs triage", "bug"]
4+
body:
5+
- type: markdown
6+
attributes:
7+
value: >
8+
Before you go any further. Is this really a **🐛 bug**?
9+
10+
If it's a question about how al-folio works, have a look at our [documentation](https://github.com/alshedivat/al-folio/blob/master/README.md),
11+
[frequently asked questions](https://github.com/alshedivat/al-folio/blob/master/FAQ.md),
12+
[past questions](https://github.com/alshedivat/al-folio/discussions/categories/q-a),
13+
or [ask a question](https://github.com/alshedivat/al-folio/discussions/new?category=q-a).
14+
15+
- type: checkboxes
16+
id: requirements
17+
attributes:
18+
label: Have you checked that your issue isn't already filed?
19+
description: >
20+
Please check if somebody else has already filed the same issue.
21+
If you find a similar issue, please add a 👍 reaction or comment on the original post.
22+
options:
23+
- label: I read through [FAQ](https://github.com/alshedivat/al-folio/blob/master/FAQ.md) and searched through the [past issues](https://github.com/alshedivat/al-folio/issues), none of which addressed my issue.
24+
required: true
25+
- label: Yes, I have checked that this issue isn't already filed.
26+
required: true
27+
28+
- type: input
29+
attributes:
30+
label: Bug description
31+
description: A description of the 🐛 bug.
32+
placeholder: A clear and concise description of what the bug is.
33+
validations:
34+
required: true
35+
36+
- type: textarea
37+
attributes:
38+
label: How to reproduce the bug
39+
description: Provide steps to reproduce the 🐛 bug.
40+
placeholder: |
41+
Include steps to reproduce, the expected behaviour, and the actual behaviour.
42+
43+
1. Go to '...'
44+
2. Click on '....'
45+
3. Scroll down to '....'
46+
4. See error
47+
validations:
48+
required: true
49+
50+
- type: textarea
51+
attributes:
52+
label: Error messages and logs
53+
description: >
54+
Provide any error messages and/or logs
55+
placeholder: "Copy the complete error messages and logs"
56+
value: |
57+
```
58+
The error message you got, with the full traceback if available. Please paste it between these triple backticks.
59+
```
60+
validations:
61+
required: false
62+
63+
- type: dropdown
64+
id: os
65+
attributes:
66+
label: What operating system are you using?
67+
description: select all OSs where you have experienced this issue
68+
multiple: true
69+
options:
70+
- Linux
71+
- Mac
72+
- Windows
73+
- Not applicable (e.g. you're using GitHub Pages or other hosting)
74+
validations:
75+
required: true
76+
77+
- type: dropdown
78+
id: environment
79+
attributes:
80+
label: Where are you seeing the problem on?
81+
description: select all environments where you have experienced this issue
82+
multiple: true
83+
options:
84+
- "Running locally with Docker"
85+
- "Running locally without Docker"
86+
- "Deployed site"
87+
validations:
88+
required: true
89+
90+
- type: textarea
91+
attributes:
92+
label: More info
93+
description: Add any other info about the issue here.
94+
placeholder: |
95+
Add any other context about the problem here, such as versions of the libraries if running without docker, screenshots, links to the deployed site, etc.
96+
validations:
97+
required: false
98+
99+
- type: markdown
100+
attributes:
101+
value: "**Happy coding!**"

‎.github/ISSUE_TEMPLATE/2_feature_request.yml

+56
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
name: 🚀 Feature request
2+
description: Propose a feature for this project
3+
labels: ["needs triage", "enhancement"]
4+
body:
5+
- type: markdown
6+
attributes:
7+
value: >
8+
Before you go any further, are you sure that this feature is not already implemented?
9+
10+
If it's a question about how al-folio works, have a look at our [documentation](https://github.com/alshedivat/al-folio/blob/master/README.md),
11+
[frequently asked questions](https://github.com/alshedivat/al-folio/blob/master/FAQ.md),
12+
[past questions](https://github.com/alshedivat/al-folio/discussions/categories/q-a),
13+
or [ask a question](https://github.com/alshedivat/al-folio/discussions/new?category=q-a).
14+
15+
- type: checkboxes
16+
id: requirements
17+
attributes:
18+
label: Have you checked that your feature request isn't already filed?
19+
description: >
20+
Please check if somebody else has already filed the same 🚀 feature request.
21+
If you find a similar feature request, please add a 👍 reaction or comment on the original post.
22+
options:
23+
- label: I read through [FAQ](https://github.com/alshedivat/al-folio/blob/master/FAQ.md) and searched through the [past issues](https://github.com/alshedivat/al-folio/issues), none of which addressed my feature request.
24+
required: true
25+
- label: Yes, I have checked that this feature request isn't already filed.
26+
required: true
27+
28+
- type: textarea
29+
attributes:
30+
label: Description & Motivation
31+
description: A clear and concise description of the 🚀 feature proposal
32+
placeholder: |
33+
Please outline the motivation for the proposal.
34+
Is your feature request related to a problem? e.g., I'm always frustrated when [...].
35+
If this is related to another GitHub issue, please link it here
36+
37+
- type: textarea
38+
attributes:
39+
label: Pitch
40+
description: A clear and concise description of what you want to happen.
41+
validations:
42+
required: false
43+
44+
- type: textarea
45+
attributes:
46+
label: Alternatives
47+
description: A clear and concise description of any alternative solutions or features you've considered, if any.
48+
validations:
49+
required: false
50+
51+
- type: textarea
52+
attributes:
53+
label: Additional context
54+
description: Add any other context or screenshots about the feature request here.
55+
validations:
56+
required: false

‎.github/ISSUE_TEMPLATE/config.yml

+8
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
blank_issues_enabled: false
2+
contact_links:
3+
- name: ❓ Ask a Question
4+
url: https://github.com/alshedivat/al-folio/discussions/categories/q-a
5+
about: Ask and answer al-folio related questions.
6+
- name: 📖 Read the documentation
7+
url: https://github.com/alshedivat/al-folio/blob/master/README.md
8+
about: Please consult the documentation before opening any issues!

‎.github/release.yml

+14
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
changelog:
2+
exclude:
3+
labels:
4+
- ignore-for-release
5+
categories:
6+
- title: new features 🚀
7+
labels:
8+
- enhancement
9+
- title: bug fixes and improvements ✨
10+
labels:
11+
- bug-fix
12+
- title: other changes 🛠️
13+
labels:
14+
- "*"

‎.github/stale.yml

+18
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
# Number of days of inactivity before an issue becomes stale
2+
daysUntilStale: 60
3+
# Number of days of inactivity before a stale issue is closed
4+
daysUntilClose: 7
5+
# Issues with these labels will never be considered stale
6+
exemptLabels:
7+
- pinned
8+
- security
9+
- enhancement
10+
# Label to use when marking an issue as stale
11+
staleLabel: wontfix
12+
# Comment to post when marking an issue as stale. Set to `false` to disable
13+
markComment: >
14+
This issue has been automatically marked as stale because it has not had
15+
recent activity. It will be closed if no further activity occurs. Thank you
16+
for your contributions.
17+
# Comment to post when closing a stale issue. Set to `false` to disable
18+
closeComment: false

‎.github/workflows/axe.yml

+73
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
name: Axe accessibility testing
2+
3+
on:
4+
# if you want to run this on every push uncomment the following lines
5+
# push:
6+
# branches:
7+
# - master
8+
# - main
9+
# pull_request:
10+
# branches:
11+
# - master
12+
# - main
13+
workflow_dispatch:
14+
inputs:
15+
url:
16+
description: "URL to be checked (e.g.: blog/)"
17+
required: false
18+
19+
env:
20+
URL: ""
21+
22+
jobs:
23+
check:
24+
# available images: https://github.com/actions/runner-images#available-images
25+
runs-on: ubuntu-latest
26+
steps:
27+
- name: Checkout 🛎️
28+
uses: actions/checkout@v4
29+
- name: Setup Ruby
30+
uses: ruby/setup-ruby@v1
31+
with:
32+
ruby-version: "3.2.2"
33+
bundler-cache: true
34+
- name: Update _config.yml ⚙️
35+
uses: fjogeleit/yaml-update-action@main
36+
with:
37+
commitChange: false
38+
valueFile: "_config.yml"
39+
changes: |
40+
{
41+
"giscus.repo": "${{ github.repository }}",
42+
"baseurl": ""
43+
}
44+
- name: Install and Build 🔧
45+
run: |
46+
pip3 install --upgrade jupyter
47+
export JEKYLL_ENV=production
48+
bundle exec jekyll build --lsi
49+
- name: Purge unused CSS 🧹
50+
run: |
51+
npm install -g purgecss
52+
purgecss -c purgecss.config.js
53+
- name: Get Chromium version 🌐
54+
# https://github.com/GoogleChromeLabs/chrome-for-testing?tab=readme-ov-file#other-api-endpoints
55+
run: |
56+
CHROMIUM_VERSION=$(wget -qO- https://googlechromelabs.github.io/chrome-for-testing/LATEST_RELEASE_STABLE | cut -d. -f1)
57+
echo "Chromium version: $CHROMIUM_VERSION"
58+
echo "CHROMIUM_VERSION=$CHROMIUM_VERSION" >> $GITHUB_ENV
59+
- name: Setup Chrome 🌐
60+
id: setup-chrome
61+
uses: browser-actions/setup-chrome@v1
62+
with:
63+
chrome-version: ${{ env.CHROMIUM_VERSION }}
64+
- name: Install chromedriver 🚗
65+
run: |
66+
npm install -g chromedriver@$CHROMIUM_VERSION
67+
- name: Run axe 🪓
68+
# https://github.com/dequelabs/axe-core-npm/tree/develop/packages/cli
69+
run: |
70+
npm install -g @axe-core/cli
71+
npm install -g http-server
72+
http-server _site/ &
73+
axe --chromedriver-path $(npm root -g)/chromedriver/bin/chromedriver http://localhost:8080/${{ github.event.inputs.url || env.URL }} --load-delay=1500 --exit

‎.github/workflows/broken-links-site.yml

+46
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
name: Check for broken links on site
2+
3+
on:
4+
workflow_run:
5+
workflows: [Deploy site]
6+
types: [completed]
7+
8+
jobs:
9+
check-links-on-site:
10+
# https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#running-a-workflow-based-on-the-conclusion-of-another-workflow
11+
if: ${{ github.event.workflow_run.conclusion == 'success' }}
12+
# available images: https://github.com/actions/runner-images#available-images
13+
runs-on: ubuntu-latest
14+
steps:
15+
- name: Checkout 🛎️
16+
uses: actions/checkout@v4
17+
- name: Setup Ruby
18+
uses: ruby/setup-ruby@v1
19+
with:
20+
ruby-version: "3.2.2"
21+
bundler-cache: true
22+
- name: Update _config.yml ⚙️
23+
uses: fjogeleit/yaml-update-action@main
24+
with:
25+
commitChange: false
26+
valueFile: "_config.yml"
27+
changes: |
28+
{
29+
"giscus.repo": "${{ github.repository }}",
30+
"baseurl": ""
31+
}
32+
- name: Install and Build 🔧
33+
run: |
34+
pip3 install --upgrade jupyter
35+
export JEKYLL_ENV=production
36+
bundle exec jekyll build --lsi
37+
- name: Purge unused CSS 🧹
38+
run: |
39+
npm install -g purgecss
40+
purgecss -c purgecss.config.js
41+
- name: Link Checker 🔗
42+
uses: lycheeverse/[email protected]
43+
with:
44+
fail: true
45+
# only check local links
46+
args: --offline --remap '_site(/?.*)/assets/(.*) _site/assets/$2' --verbose --no-progress '_site/**/*.html'

0 commit comments

Comments
 (0)