org-howto/README.md

org-howto

Emacs org git repo with howto articles.

Published to https://conybeare.us/web regularly. Also from time-to-time to github pages here: https://rconybea.github.io/web

Publish content here by pushing to ssh://forgejo@conybeare.us:2222/roland/org-howto.git

Publish to local html tree:

$ cd path/to/org-howto
$ nix-shell shell.nix --run "./bin/howto-publish ~/proj/public_html/org-howto"

Alternatively from emacs using M-x org-publish-project org-howto.

automatic publishing via forgejo

See forgejo runner in .forgejo/workflows/deploy.yaml The runner generates html into /var/www/org-howto on new commits

host configuration for publishing

mkdir -p ~/proj
mkdir -p ~/proj/public_html
(cd ~/proj && git clone git@github.com:Rconybea/org-howto.git)
(cd ~/proj/public_html && git clone git@github.com:Rconybea/web.git org-howto)

interactive emacs configuration

assuming:

1. contents of this repo is at ~/proj/org-howto
2. publishing html to ~/proj/public_html/org-howto we need the following in ~/.emacs:

;; ----------------------------------------------------------------
;; org-mode publishing
;;
(require 'ox-publish)

;; publishing setup -- this is a kitchen sink -- it's intended to cover
;; everything we want org-mode to publish
;;
(setq org-publish-project-alist
      '(
        ("org-howto"
         :components ("org-howto-notes" "org-howto-static"))

        ("org-howto-notes"
         :base-directory "~/proj/org-howto"
         :base-extension "org"
         :publishing-directory "~/proj/public_html/org-howto"
         :recursive t
         :publishing-function org-html-publish-to-html
         :headling-levels 4
         :auto-preamble t
         )

        ("org-howto-static"
         :base-directory "~/org/"
         :base-extension "css\\|js\\|svg\\|png\\|jpg\\|gif\\|pdf\\|mp3\\|ogg\\|swf"
         :publishing-directory "~/proj/public_html/org-howto"
         :recursive t
         :publishing-function org-publish-attachment
        )))

create html tree with

M-x org-publish-project org-howto

To serve html content locally:

python3 -m http.server 8000 --directory ~/proj/public_html/org-howto

To publish updated html tree to github

cd ~/proj/public_html/org-howto
git add .
git commit -m update
git push

To reset org-mode publishing cache (e.g. because futzing with host setup)

rm -rf ~/.org-timestamps/*