Mkdocs publishing workflow
I write articles on my personal computer.
Mkdocs supports Markdown, which has some great advantages:
- articles are stored as plain text on disk
- the content is indexed making it easy to find content with Alfred/Spotlight/grep
- you can grep, sed, awk the hell out of your articles and bring corrections very quickly
- can (and should!) be stored in a Git repository
This is my current publication workflow:
- I edit articles locally with [Visual Studio Code] (yes, it is an open source Microsoft product, and it is very good)
- I commit changes to my [GitHub]
- With an Alfred workflow, I automatically connect to my VPS and do:
- a “git pull” to retrieve updates
- rebuild the doc (which is served as static files by the HTTP server)