A static site generator, which produces a simple blog.
It can also easily produce custom pages.
The name mdsh refers to the custom Markdown + Shell format used to write blog posts (you can also use HTML).
* Homepage: https://sc0ttj.github.io/mdsh/about.html
* Demo blog here: https://sc0ttj.github.io/mdsh/
* Wiki: https://github.com/sc0ttj/mdsh/wiki
* Github repo: https://github.com/sc0ttj/mdsh
Requirements:
- Bash
- Perl (for markdown.pl)
Optional:
- Git and a GitHub account (if you want super easy deployment and free hosting at GitHub Pages)
Features
- * Written in Bash shell script
* Easy setup - just clone the repo, edit the .site_config file.
* Use a mix of Markdown and shell code to write blog posts!
* Use your terminal - no text editor or IDE required.
* Builds a fast blog with great SEO and mobile support
* Automatically generates index and listings pages for categories, tags, and more.
* Can generate a valid RSS feed and XML sitemap!
* Includes a "Contact" page that works out of the box! (uses formspree.io to send you emails)
* Includes blazing fast site/page search (uses Jets, requires JavaScript)
* Supports fullscreen, native app experience on mobile/smartphone if added to Homescreen
* Optionally use Google Fonts to choose custom web fonts
* Optionally use Unpkg.com to manage JavaScript libraries/dependencies
* Optionally use Git for saving, managing and reverting versions and deployments
* Optionally use GitHub Pages for free, fast, and secure (SSL enabled) site hosting
* Support many other web hosting options too
- * Clone the repo: * Enter project dir:
Code: Select all
git clone https://github.com/sc0ttj/mdsh blog
* Use GitHub Pages for hosting:Code: Select all
cd blog
* Edit site settings:Code: Select all
git checkout -b gh-pages
* Build homepage:Code: Select all
$EDITOR .site_config
* Create your first post (just follow the on-screen instructions): .Code: Select all
rebuild homepage
Code: Select all
new post
^ after you create a post, all site index pages and menus will be rebuilt.
* To re-build all pages:* To publish:Code: Select all
rebuild -all
Code: Select all
publish "some version or message"
If you dont want to use Git or GitHub, you can just FTP the HTML files and 'assets' dir somewhere instead.