1
0
Fork
You've already forked jacksonchen666.com
0
Mirror source code of jacksonchen666.com (origin is git.sr.ht) https://jacksonchen666.com
  • HTML 48.8%
  • Shell 24.1%
  • CSS 18.6%
  • Makefile 8.2%
  • Standard ML 0.3%
2026年07月11日 23:34:34 +02:00
.builds temporarily downgrade alpine 2025年12月05日 13:19:24 +01:00
archetypes update maintenance section with reword (and internal docs) 2026年05月26日 00:25:26 +02:00
assets/css pad code blocks more 2026年04月23日 15:02:46 +02:00
config update email addresses and break contact page link 2026年04月23日 16:17:32 +02:00
content update keys and stuff 2026年07月11日 23:34:34 +02:00
docs random site docs stuff 2026年06月23日 23:19:07 +02:00
git-hooks warn against created_date and error against public drafts 2025年08月14日 16:51:16 +02:00
layouts add ai policy link to footer 2026年06月02日 19:44:20 +02:00
LICENSES add reuse thingy 2023年08月15日 11:20:11 +02:00
scripts extensive documentation of server setup 2026年03月28日 19:07:52 +01:00
static add gentoo related PGP key 2026年06月16日 15:47:12 +02:00
.gitignore include all variant of outputs in gitignore 2024年02月07日 00:04:46 +01:00
.mailmap git mailmap 2024年11月25日 09:50:04 +01:00
.tool-versions update hugo 2025年06月01日 18:46:25 +02:00
check-links.sh check-links.sh: change user agent 2026年06月16日 20:48:40 +02:00
CONTRIBUTING.md move permalinks to docs from contributing.md 2024年07月31日 04:42:51 +02:00
LICENSE specify which kind of works 2023年02月18日 20:50:48 +01:00
Makefile warn against created_date and error against public drafts 2025年08月14日 16:51:16 +02:00
NOTES.md remove ' cause it's wrong 2023年04月07日 12:55:23 +02:00
README.md add a link to hugo 2025年06月01日 18:48:52 +02:00
REUSE.toml you know i don't exactly like how REUSE spec has to make me license everything sometimes 2026年03月28日 18:36:32 +01:00
site-config.json update caching max-age 2023年08月11日 19:50:18 +02:00

jacksonchen666.com

my website

running a local version

clone the repo first

dependency

this site uses hugo 0.147.2 (non-extended verison).

the minimum version of hugo for this site is 0.120.0 (uses hugo.IsDevelopment).

the version choice is based on whatever in the alpine linux repos for the latest version of alpine. (note: link links to a specific version of alpine linux, please adjust distro version as necessary, using alpine/latest from builds.sr.ht images as a reference for the alpine version)

other dependencies:

  • some GNU tools (make, gzip, tar)
    • make for building and deploying the site (the Makefile makes use of features probably only in GNU make)
    • gzip for page compression (in deployment)
    • tar for turning a directory into a single file (used in deployment, may make use of gzip)
  • hut for updating pages.sr.ht
  • brotli for page compression (in deployment)

serve the site

run make live and look at localhost:1313

expected production site generation

  • the correct environment is used for generating alternative sites (tor onions, i2p, yggdrasil, etc.). set it by passing the --environment argument. for the normal website, use the environment value production (default with just the hugo command).
  • the site is pretty much made with makefiles where it runs the commands and stuff. makefiles are used in CI as well.
  • gzip/brotli compression is done before files are uploaded to the server at jacksonchen666.com, not done on that server.

slightly notable notes on development vs. production

in the hugo config files, there is a development config and a production config.

there is an extremely important distinction to make: script-src 'none'; in production, script-src 'self'; in development.

whether it is "production" or "development" depends on if you run hugo or hugo server:

  • hugo gets you a production environment
  • hugo server gets you a development environment

you can override the environment to production with --environment production so you can test if your changes works.

it is highly recommended to test using the production environment mode, otherwise your changes might not work correctly. do so with hugo server --environment production.

licensing

this project is compliant with the REUSE specification. please refer to the LICENSE file for more information.

contributing

contributions are not accepted. please refer to CONTRIBUTING.md for more info.

issues

check https://todo.sr.ht/~jacksonchen666/jacksonchen666.com