tamouse / swaac

Software as a Craft blog posts, converted to org-mode
https://swaac.dev
7 stars 0 forks source link
software software-engineering web webdev

[[./posts/index.org][Full List of Posts]]

This is my swaac (Software as a Craft) web site posts, converted into [[https://orgmode.org/][Emacs Org Mode]] which is another sort of mark-down type writing experience, only richer than straight Markdown. Org mode includes a richer environment for editing code snippets, which is part-and-parcel of this particular web site. Org mode is also a great way to organize thoughts and concepts. The major inhibiting factor has been how to publish the results. I'm just stuffing these onto github, which handles org formatting at least as well as it does Markdown. This feels like the least restrictive way for me to write my devblog.

The posts are in the [[./posts][posts]] directory. The other directories are only temporary in case I need to do some editing and have the original around.

If you're looking for the Atom feed, it is [[https://tamouse.github.io/swaac/feed.xml][here]].

If you're looking for the "learning" entry it is [[./posts/learning.org][here (./posts/learning.org)]]

Each directory also has an ~index.org~ file in it listing the posts for that directory.

** Publishing

I've recently set up a publishing scheme for this blog, so maybe it's not just available as a github repo.

Utilizing org-mode's vast publishing capability, I can put these org files out as a whole web site. Ultimately, I'll build a rake command for it so it can be easily built and published.

For now, in emacs, open the [[file:publish-setup.el::(setq%20org-publish-project-alist][~publish-setup.el~]], evaluate the buffer, and then execute ~org-publish~, selecting ~website~ as the object to be published. It's kinda cool. The entire directory is published in ~$HOME/Sites/swaac-pub/~ (hardcoded for now).

** Issues, Questions, Comments

Please feel free to file an [[https://github.com/tamouse/swaac-org/issues][issue]] on the repo if you

** License

This content is licensed [[http://creativecommons.org/licenses/by-nc-sa/4.0/][CC BY-NC-SA 4.0]], a Creative Commons license: Attribution, Non-commercial, Share-Alike 4.0, International.

** Code of Conduct / Contributor Covenant

This project adheres to the [[https://www.contributor-covenant.org/version/1/4/code-of-conduct][Code of Conduct v1.4]]. Report issues regarding this to me at my email below.

** Contact