a670c7ecb1
Signed-off-by: Andrei Jiroh Halili <ajhalili2006@andreijiroh.eu.org> |
||
|---|---|---|
| .github | ||
| .vscode | ||
| bin | ||
| docker | ||
| gmi | ||
| markdown | ||
| overrides | ||
| tools | ||
| .build.yml | ||
| .env.example | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| .gitmodules | ||
| .gitpod.Dockerfile | ||
| .gitpod.yml | ||
| .hadolint.yml | ||
| .readthedocs.yaml | ||
| .wakatime-project | ||
| Pipfile | ||
| Pipfile.lock | ||
| README.md | ||
| SECURITY.md | ||
| build.sh | ||
| mkdocs.readthedocs.yml | ||
| mkdocs.yml | ||
| package-lock.json | ||
| package.json | ||
| requirements.txt | ||
| start-caddy-tildeserv.sh | ||
| vern.Caddyfile | ||
README.md
~ajhalili2006's website
This is my sources for both andreijiroh.(eu.org|dev) and tilde userpages in Ctrl-C Club and ~vern,
built with Mkdocs + Material theme by ~squidfunk.
(Sources for Gemini version of the website is available at gmi directory.)
Mirrors
Canonically developed at mau.dev where the deployments happen, with the following mirrors being maintained:
- GitHub: https://github.com/ajhalili2006/ajhalili2006.github.io.git, where Docker image builds happen
- Jetbrains Space (personal): https://ajhalili2006.jetbrains.space/p/web/repositories/andreijiroh.dev (repository clone URL:
git.jetbrains.space/ajhalili2006/web/andreijiroh.dev.git) - Sourcehut: https://git.sr.ht/~ajhalili2006/web
Site Development
Use the clone links from either the canonical repository URL or its mirrors as mentioned above or open this repo in a cloud development environment using these links:
Building from source
# install deps via pipenv...
pipenv install
# ...or via pip3 with --user flag (generated from "pipenv requirements" and sending its output
# to requirements.txt)
pip install -r requirements.txt --user
# preview site and edit in another session
mkdocs serve --watch overrides --watch-theme --livereload
Sending patches
# send patches via GitLab or GitHub through the CLI
glab auth login --host "https://mau.dev" # authenticate CLI
gh auth login # authenticate CLI, GitHub.com edition
glab -R https://mau.dev/andreijiroh.dev/website mr create --allow-collaboration -b main
gh -R ajhalili2006/tildeverse-web pr create # might automatically closes PR due to mirror status
# or via my public inbox on sourcehut
# see https://git-send-email.io for setup and guide
git config sendemail.to "~ajhalili2006/public-inbox@lists.sr.ht" # NOT my personal email
git config format.subjectPrefix "PATCH web" # identification in archives + builds.sr.ht
git config --global sendemail.annotate yes
git config --global format.signOff true # needed for compliance with Linux DCO
git send-email HEAD^
Contributing
Patches are always welcome, although you must sign-off your commits to comply with the Linux DCO. Please be reminded that while this is a personal open-source project, please expect long waiting times during pathc reviews and don't be disappointed when I disagree on stuff and chose not to merge the patches for any reasons, including mental health breaks.
License
Unless otherwise noted, source code is licensed under the MPL-2.0 while website content (text-only) is under CC BY-SA 4.0.
The only thing that's not covered by this is the favicon version of my (current) profile picture.
