Repo for the pub.solar website https://pub.solar
 
 
 
 
 
Go to file
b12f 3766a9f945
continuous-integration/drone/push Build is passing Details
Merge pull request 'about: add wiki link' (#21) from about/add-wiki into main
Reviewed-on: #21
Reviewed-by: teutat3s <teutat3s@noreply.git.pub.solar>
2024-01-07 15:31:03 +00:00
.well-known/matrix Add well-known for matrix federation 2022-05-01 00:00:17 +02:00
_data fix: remove schedule to be more chaotic 2023-12-28 19:50:37 +01:00
_includes fix: remove schedule to be more chaotic 2023-12-28 19:50:37 +01:00
assets deno does not like dots in filenames... 2023-05-19 17:39:57 +02:00
fonts/opensans Update to lume v1.17.3 2023-05-19 15:49:36 +02:00
scripts feat: add hakken themes and schedule 2023-12-26 22:11:36 +01:00
.dockerignore Add dockerignore, Dockerfile cleanup 2022-10-20 18:19:52 +02:00
.drone.yml fix: recreate deno.lock file 2023-12-29 18:34:59 +01:00
.envrc Use tritonshell instead of shell.nix 2022-10-20 16:11:53 +02:00
.gitignore Basic lume setup 2022-10-02 20:46:42 +02:00
Dockerfile fix: recreate deno.lock file 2023-12-29 18:34:59 +01:00
LICENSE.md Add aGPLv3 2022-01-16 21:44:53 +01:00
README.md docs: add troubleshooting steps for ENOTFOUND error 2024-01-07 16:23:13 +01:00
_config.ts deno: ignore docker-compose.yml and regenerate 2023-05-19 17:24:56 +02:00
about.yml chore: remove donation via paypal / liberapay for now 2024-01-07 16:24:51 +01:00
deno.json Write to explicit lock file location 2023-05-19 15:56:43 +02:00
deno.lock fix: recreate deno.lock file 2023-12-29 18:34:59 +01:00
docker-compose.yml Add green hosting hint and Greenbaum Cloud logo+links 2022-05-01 00:43:17 +02:00
filters.ts feat: add hakken themes and schedule 2023-12-26 22:11:36 +01:00
flake.lock chore: bump deno version to 1.39.1, lume to 2.0.1 2023-12-28 19:37:49 +01:00
flake.nix style: fix linting error 2023-10-28 16:25:27 +02:00
hakken.yml fix: small style changes 2023-12-28 19:38:22 +01:00
import_map.json chore: bump deno version to 1.39.1, lume to 2.0.1 2023-12-28 19:37:49 +01:00
index.yml fix: improve about 2023-11-15 19:22:19 +01:00
maintenance.yml feat: maintenance page 2023-10-27 22:41:34 +02:00
privacy.yml Explicitly mention keycloak 2022-11-26 01:51:38 +01:00
styles.scss Refactor the CSS to SCSS 2022-10-03 02:02:47 +02:00

README.md

pub.solar homepage

This is the repository containing the code for https://pub.solar.

It is built using lume with JSX. To get started, make sure you have the nix package manager installed. Then you can start developing with:

Quick start

nix develop

This will use a nix devshell to create an environment that has deno and lume available.

An alternative approach for loading all dependencies is direnv. It basically runs nix develop for you, once you enter a directory which contains a .envrc file and allow it by running direnv allow. Once installed globally, run:

direnv allow

To get a live development server, run

deno task serve

Unfortunately, hot module reloading is currently broken for JSX modules, so you'll need to restart this process regularly during development.

Updating Open Sans

To update the font files and CSS, run google-font-downloader $FONT_CSS_URL. As "documentation" flake.nix shows the internals, and _includes/styles/typography.css has a comment at the top that shows which command was used to generate it.

Troubleshooting

When running deno task serve, if you see an error message like:

NotFound: No such file or directory (os error 2): stat '/home/<user>/.../git.pub.solar/pub-solar/pub.solar/.direnv/flake-inputs/5acdh8xyry0kdvp6xla2hw7wf3zkphkl-source/pkgs/test/nixpkgs-check-by-name/tests/symlink-invalid/pkgs/by-name/fo/foo/foo.nix'
    at Object.statSync (ext:deno_fs/30_fs.js:362:7)
    at FS.#walkLink (https://deno.land/x/lume@v2.0.1/core/fs.ts:143:23)
    at FS.#walkFs (https://deno.land/x/lume@v2.0.1/core/fs.ts:117:23)
    at FS.#walkFs (https://deno.land/x/lume@v2.0.1/core/fs.ts:136:21)
    at FS.#walkFs (https://deno.land/x/lume@v2.0.1/core/fs.ts:136:21)
    at FS.#walkFs (https://deno.land/x/lume@v2.0.1/core/fs.ts:136:21)
    at FS.#walkFs (https://deno.land/x/lume@v2.0.1/core/fs.ts:136:21)
    at FS.#walkFs (https://deno.land/x/lume@v2.0.1/core/fs.ts:136:21)
    at FS.#walkFs (https://deno.land/x/lume@v2.0.1/core/fs.ts:136:21)
    at FS.#walkFs (https://deno.land/x/lume@v2.0.1/core/fs.ts:136:21) {
  name: "NotFound",
  code: "ENOENT"
}

try removing the .direnv directory:

rm -rf .direnv
deno task serve

Another common error message after updating dependencies is:

22.31 error: The source code is invalid, as it does not match the expected hash in the lock file.

To recreate the deno lock file, run

deno cache --lock=deno.lock --lock-write _config.ts