Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/khuedoan/blog
My personal website (written in Rust, blazingly fast, deployed on Kubernetes, <insert a bunch of random buzzwords here>, just lack content)
https://github.com/khuedoan/blog
Last synced: 2 days ago
JSON representation
My personal website (written in Rust, blazingly fast, deployed on Kubernetes, <insert a bunch of random buzzwords here>, just lack content)
- Host: GitHub
- URL: https://github.com/khuedoan/blog
- Owner: khuedoan
- License: gpl-3.0
- Created: 2020-12-26T07:53:02.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-10-20T18:47:39.000Z (14 days ago)
- Last Synced: 2024-10-21T20:19:32.556Z (13 days ago)
- Language: Rust
- Homepage: https://khuedoan.com
- Size: 3.49 MB
- Stars: 19
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-leptos - source
README
# [khuedoan.com](https://khuedoan.com) ![status](https://img.shields.io/website?label=status&style=flat-square&url=https%3A%2F%2Fkhuedoan.com)
This is the source code of my personal website at [khuedoan.com](https://khuedoan.com), built with:
- [Rust](https://www.rust-lang.org)
- [Axum](https://github.com/tokio-rs/axum)
- [Maud](https://maud.lambda.xyz)
- [Pico CSS](https://picocss.com)
- [HTMX](https://htmx.org)You can check out older branches for previous implementations:
- [Rust/Axum/Leptos/WASM/Tailwind CSS](https://github.com/khuedoan/blog/tree/leptos) (2023)
- [Next.js/Tailwind CSS](https://github.com/khuedoan/blog/tree/nextjs) (2023)
- [Hugo/PaperMod](https://github.com/khuedoan/blog/tree/hugo) (2021)
- Plain HTML (2020)## Project structure
- `content/`: content written in Markdown
- `src/`: pages and components
- `public/`: static assets
- `build.rs`: build logic for rendering Markdown to HTML## Content convention
```
content
└── posts
└── example-post.md
public
├── any-static-file-here.txt
└── images
├── avatar.jpg
└── cat-picture.jpg
```Posts are placed in `content/posts`, each post is a Markdown file. Here's an example post:
```
## Example heading![Files inside `./public` can be referenced by your code starting from the base URL](/images/cat-picture.webp)
Lorem ipsum dolor sit amet, consectetur adipiscing elit,
sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
```## Development
Open a shell that provides the build environment (requires Nix):
```
nix develop
```Run the development server:
```
make dev
```Then open .
## Deployment
- Docker image: `Dockerfile`
- Pipelines: `.woodpecker/`
- Kubernetes configuration: see## Acknowledgements
- [Axum examples](https://github.com/tokio-rs/axum/blob/main/examples): code examples
- [Making a dev shell with nix flakes](https://fasterthanli.me/series/building-a-rust-service-with-nix/part-10): Nix flake
- [Comment by ScottAbbey in pulldown-cmark#167](https://github.com/pulldown-cmark/pulldown-cmark/issues/167#issuecomment-448491422) and [eguiraud/highlight-pulldown](https://gitlab.com/eguiraud/highlight-pulldown): Syntax highlighting for Markdown using `pulldown-cmark` and `syntect`