foodogsquared/nixos-config
1
0
Fork 0
mirror of https://github.com/foo-dogsquared/nixos-config.git synced 2025-01-31 10:58:02 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
dependabot/github_actions/DeterminateSystems/magic-nix-cache-action-9
nixos-config/configs/home-manager/foo-dogsquared/files/homepage
History
Gabriel Arazas f30be27328
users/foo-dogsquared: update Tridactyl and homepage settings
2025-01-12 14:12:13 +08:00
..
assets users/foo-dogsquared: update links and CSS 2024-09-14 12:25:17 +08:00
config/_default users/foo-dogsquared/programs/browsers: init and set custom homepage 2024-09-03 15:11:42 +08:00
data/foodogsquared-homepage users/foo-dogsquared: update Tridactyl and homepage settings 2025-01-12 14:12:13 +08:00
layouts users/foo-dogsquared: update homepage links and layout 2025-01-04 15:32:18 +08:00
.gitignore users/foo-dogsquared/programs/browsers: init and set custom homepage 2024-09-03 15:11:42 +08:00
default.nix users/foo-dogsquared/programs/browsers: init and set custom homepage 2024-09-03 15:11:42 +08:00
go.mod users/foo-dogsquared/programs/browsers: init and set custom homepage 2024-09-03 15:11:42 +08:00
go.sum users/foo-dogsquared/programs/browsers: init and set custom homepage 2024-09-03 15:11:42 +08:00
LICENSE users/foo-dogsquared: make LICENSE file for homepage 2024-09-14 12:25:45 +08:00
Makefile users/foo-dogsquared/programs/browsers: init and set custom homepage 2024-09-03 15:11:42 +08:00
package.nix users/foo-dogsquared: add ability to set icons for custom homepage 2024-09-10 08:10:45 +08:00
README.adoc users/foo-dogsquared/programs/browsers: init and set custom homepage 2024-09-03 15:11:42 +08:00
shell.nix users/foo-dogsquared/programs/browsers: init and set custom homepage 2024-09-03 15:11:42 +08:00

README.adoc

Table of Contents

My custom homepage intended to be deployed alongside my home-manager configuration. In theory, you could deploy this outside of the home-manager config but that’s on you (READ: anyone that is not foodogsquared) to figure out. It should be fairly easy to do that though since all you need is the following list of components to successfully build the website:

  • GNU Make for its build automation. This is structured in this way to make building consistent either with Nix and non-Nix’d environments.

  • Hugo is the site generator mainly designed to be deployed with one binary.

  • Panapton to compile the stylesheet with my custom scheme. In place of this, you could use other Base16 builders but you’ll have to recreate the stylesheet template for that particular builder.

There are some design constraints when developing this website.

  • This homepage is pretty much designed to be completely possible to use entirely offline. As such, it has a design constraint of using less (zero as much as possible) remote resources such as a CDN. Usage of third-party libraries are fine as long as it is bundled nicely (we’ll probably use something like Bun for this).

  • We cannot use anything within the site generator requiring a network access mostly because we’re relying on the Nix which has sandboxing by default including networking isolation. [1] As a neat side effect, it also strengthens the previous goal of keeping it as offline as possible.

Development

It is recommended to set up the development environment with Nix package manager. In case it isn’t possible to use it, you’ll have to install the following tools.

1. While we can remove it ourselves, it isn’t really good practice.