This is the source for https://cedarland.blog
- Install
mdbookif you haven't already
- Instructions at https://rust-lang.github.io/mdBook/guide/installation.html
- Add the new blog content under
CedarlandBlog/blog/src
- Each blog post has its own folder, containing the blog content (named
content.md), plus any image files. - Tool Tip: From the directory
CedarlandBlog/blog, you can runmdbook serve -oto preview your content as you write it.
- If adding a new blog post...
- Update the table of contents at
CedarlandBlog/blog/src/SUMMARY.md - Update the "Recent Posts" list at the bottom of
CedarlandBlog/blog/src/about.md - See existing examples inside those files. Should be self-evident.
- When ready to publish, generate HTML from the source files by following these steps
cdinto the directory forCedarlandBlog/blog- Run
mdbook build -d ../docs
- Push the new content into GitHub with the normal commands
git add -Agit commit -m "Blog update"git push
- Wait a minute or so...
- The blog is hosted from GitHub pages, so it should automatically update after pushing new content to GitHub. Due to caching, it can take a minute or so.