07. Updating your site - sc0ttj/mdsh GitHub Wiki

Each time you create a post using new post, the following HTML pages are automatically (re)generated:

  • the new post page (posts/<some-date>/post-title.html)
  • all relevant monthly and yearly blog index pages (posts/2019/index.html, etc)
  • all relevant category pages (categories/index.html and categories/<category>.html)
  • all relevant tag pages (tags/index.html and tags/<tag>.html)
  • the relevant author pages (authors/<name>.html and authors/index.html)
  • the archive page (archive.html)
  • the homepage (index.html)
  • the RSS feed (feed.rss)

Rebuilding all index pages, and the homepage

You can manually re-build these index pages (and the homepage) with this command:

rebuild

To re-build all pages on your site, including all posts, run:

rebuild -all

Or to rebuild all pages from the original .mdsh source files (not only from Markdown), run:

rebuild -ALL

Rebuilding specific index pages

You can rebuild specific index pages, using rebuild <index-page>[:<item1,item2,...>].

Examples:

rebuild authors
rebuild categories
rebuild authors:bob,jane
rebuild tags:foo,bar,baz

Or combine them:

rebuild authors categories authors:foo,two categories:bar tags:some,list,here 404 search homepage

Publishing your site

After updating your site, you can publish the changes with this command:

publish "updated site"

^ that will push your site to your server (if using git, which is the default and recommended).

After publishing your new article, you can update the XML sitemap, just run:

generate_sitemap

⚠️ **GitHub.com Fallback** ⚠️