Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dmarcoux/dmarcoux.com
Source code for my website at https://dmarcoux.com
https://github.com/dmarcoux/dmarcoux.com
blog nix zola
Last synced: about 2 months ago
JSON representation
Source code for my website at https://dmarcoux.com
- Host: GitHub
- URL: https://github.com/dmarcoux/dmarcoux.com
- Owner: dmarcoux
- License: cc0-1.0
- Created: 2020-10-03T19:56:32.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-20T17:46:46.000Z (3 months ago)
- Last Synced: 2024-10-20T21:29:55.872Z (3 months ago)
- Topics: blog, nix, zola
- Language: HTML
- Homepage: https://dmarcoux.com
- Size: 3.67 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [dmarcoux/dmarcoux.com](https://github.com/dmarcoux/dmarcoux.com)
## Development
Reproducible development environment for [Zola](https://github.com/getzola/zola)
which relies on [Nix](https://github.com/NixOS/nix), a purely functional and
cross-platform package manager.
Start with `nix-shell --pure`.
### Create Page / Blog Post
There is no built-in command for this in Zola, simply copy from one of the
existing pages or create a file with only the frontmatter like:
```markdown
+++
title = "My page"
(...)
+++
```
### Web Server
Start web server for development on localhost:1111
```bash
zola serve
```
### Lint Markdown Files
```bash
lint
```
## Production
### Host
The application is hosted on [Cloudflare](https://www.cloudflare.com/) and configured
via the web UI.
[Preview
deployments](https://developers.cloudflare.com/pages/configuration/preview-deployments)
are commenting in pull requests whenever the deploy preview is ready.
### Domain
The domain `dmarcoux.com` is managed on
[Cloudflare](https://www.cloudflare.com/) with a `CNAME` record for `@` pointing
to the default site name provided by Cloudflare Pages.
### Settings
Since Cloudflare Pages only support a single build configuration for all
environments (preview and production), I need to use a few tricks in order to
have the right base URL depending on the environment. Credits goes to this
[comment](https://github.com/NathanVaughn/blog.nathanv.me/discussions/210#discussioncomment-9629836).
As for the development environment, it isn't affected since `zola serve` already
overwrites the base URL to `localhost`.
In the preview environment, the environment variable `CF_PAGES_URL` is set to
the URL of the preview deployment, so this can be passed to the `zola build`
command with the `--base-url` flag. In production, we set the environment
variable `CF_PAGES_URL` to `https://dmarcoux.com`. This way, I can use the same
build command for both environments and have the right base URL in all
environments.
#### Build Configurations
- Build command: `zola build --base-url $CF_PAGES_URL`
- Build output directory: `/public`
- Root directory: `/`
- Build comments on pull requests: `Enabled`
#### Environment Variables
The following environment variables are set.
_Production & Preview_:
- `ZOLA_VERSION` with the value `0.19.2`
_Production_:
- `CF_PAGES_URL` with the value `https://dmarcoux.com`
## Credits
- I've based my theme on [Apollo](https://github.com/not-matthias/apollo).