Skip to content

Commit c8d49ef

Browse files
pauldrinnpauldrinn
committed
Merge remote-tracking branch 'template/main'
2 parents 5d00c11 + cef2ac0 commit c8d49ef

78 files changed

Lines changed: 25973 additions & 596 deletions

Some content is hidden

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

‎.all-contributorsrc‎

Lines changed: 44 additions & 0 deletions
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+
}

‎.devcontainer/devcontainer.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,4 +28,4 @@
2828
},
2929

3030
"remoteUser": "vscode"
31-
}
31+
}

.gitattibutes renamed to .gitattributes

File renamed without changes.

‎.github/ISSUE_TEMPLATE/1_bug_report.yml‎

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
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/main/README.md),
11+
[frequently asked questions](https://github.com/alshedivat/al-folio/blob/main/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/main/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 (docker compose)"
85+
- "Running locally with Docker (devcontainer)"
86+
- "Running locally without Docker"
87+
- "Deployed site"
88+
validations:
89+
required: true
90+
91+
- type: textarea
92+
attributes:
93+
label: More info
94+
description: Add any other info about the issue here.
95+
placeholder: |
96+
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.
97+
validations:
98+
required: false
99+
100+
- type: markdown
101+
attributes:
102+
value: "**Happy coding!**"

‎.github/ISSUE_TEMPLATE/2_feature_request.yml‎

Lines changed: 56 additions & 0 deletions
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/main/README.md),
11+
[frequently asked questions](https://github.com/alshedivat/al-folio/blob/main/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/main/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‎

Lines changed: 8 additions & 0 deletions
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/main/README.md
8+
about: Please consult the documentation before opening any issues!

‎.github/release.yml‎

Lines changed: 14 additions & 0 deletions
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/workflows/axe.yml‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
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+
sudo apt-get update && sudo apt-get install -y imagemagick
47+
pip3 install --upgrade jupyter
48+
export JEKYLL_ENV=production
49+
bundle exec jekyll build
50+
- name: Purge unused CSS 🧹
51+
run: |
52+
npm install -g purgecss
53+
purgecss -c purgecss.config.js
54+
- name: Get Chromium version 🌐
55+
# https://github.com/GoogleChromeLabs/chrome-for-testing?tab=readme-ov-file#other-api-endpoints
56+
run: |
57+
CHROMIUM_VERSION=$(wget -qO- https://googlechromelabs.github.io/chrome-for-testing/LATEST_RELEASE_STABLE | cut -d. -f1)
58+
echo "Chromium version: $CHROMIUM_VERSION"
59+
echo "CHROMIUM_VERSION=$CHROMIUM_VERSION" >> $GITHUB_ENV
60+
- name: Setup Chrome 🌐
61+
id: setup-chrome
62+
uses: browser-actions/setup-chrome@v1
63+
with:
64+
chrome-version: ${{ env.CHROMIUM_VERSION }}
65+
- name: Install chromedriver 🚗
66+
run: |
67+
npm install -g chromedriver@$CHROMIUM_VERSION
68+
- name: Run axe 🪓
69+
# https://github.com/dequelabs/axe-core-npm/tree/develop/packages/cli
70+
run: |
71+
npm install -g @axe-core/cli
72+
npm install -g http-server
73+
http-server _site/ &
74+
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‎

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
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+
sudo apt-get update && sudo apt-get install -y imagemagick
35+
pip3 install --upgrade jupyter
36+
export JEKYLL_ENV=production
37+
bundle exec jekyll build
38+
- name: Purge unused CSS 🧹
39+
run: |
40+
npm install -g purgecss
41+
purgecss -c purgecss.config.js
42+
- name: Link Checker 🔗
43+
uses: lycheeverse/lychee-action@v2.0.2
44+
with:
45+
fail: true
46+
# only check local links
47+
args: --offline --remap '_site(/?.*)/assets/(.*) _site/assets/$2' --verbose --no-progress '_site/**/*.html'

0 commit comments

Comments
 (0)