publishing static HTML

;; ----------------------------------------------------------------
;; 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 "~/proj/org-howto"
         :base-extension "css\\|html\\|js\\|svg\\|png\\|jpg\\|gif\\|pdf\\|mp3\\|ogg\\|swf"
         :publishing-directory "~/proj/public_html/org-howto"
         :recursive t
         :publishing-function org-publish-attachment
         )
        )

        ; ... additional org trees here ...
        )

;; ----------------------------------------------------------------
;; org-mode babel setup
;; (execute dot/ditaa/bash/c++ etc. from .org code blocks)
;;
;; see
;;   [[https://orgmode.org/worg/org-contrib/babel/intro.html]]
;;   [[https://orgmode.org/worg/org-contrib/babel/languages/index.html]]
;;
;; code block:
;;   #+begin_src ${language} ${switches} ${headerarguments}
;;     ${body}
;;   #+end_src
;;
;; use header argument
;;   :results output
;; to insert code-block output (i.e. contents of stdout) into .org file below code block
;;
;; use
;;   :results value
;; to just take value of last statement
;;
;; use
;;   :session
;; to share language sub-process across code-blocks.
;;
;; can use
;;   #+name: foo
;; to name an org-mode table;  then:
;;   #+begin_src ... :var myfreevar=foo
;;     ...
;;   #+end_src
;; with body mentioning myfreevar;  .org will substitute foo
;;
;; can do inline coode block with
;;   src_<${lang}>{${code}} or src_<${lang}[${args}]{${code}}
;; e.g.
;;   src_python[:session]{10*x}
;;
;; notes:
;;   [C-c C-v] org-babel prefix
;;   [C-c C-v b] -- evaluate code blocks in buffer
;;   [C-c C-v s] -- evaluate code blocks in subtree
;;   [C-c C-v e] -- evaluate code block at point
;;   [C-c '] M-x org-edit-src-code -- puts code block in new buffer with appropriate mode activated
;;   [C-c M-b p] M-x org-babel-expand-src-block -- show expanded code block prior to evaluation
;;   (org-babel-lob-ingest "path/to/file.org") to share code blogs as 'library'

(org-babel-do-load-languages
 'org-babel-load-languages
 '((ditaa . t) ; ditaa
   (dot . t)  ; graphviz [[https://orgmode.org/worg/org-contrib/babel/languages/ob-doc-dot.html]] see also graphviz-dot-mode
   ))

# options used exclusively by the html exporter
#+setupfile: ext/fniessen/theme-readtheorg.setup

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

cd ~/proj/org-howto
ln -s ext web

{
  description = "publish org-howto-derived html";

  # dependencies of this flake
  inputs = rec {
    nixpkgs.url = "github:nixos/nixpkgs/23.05";
    org_howto_path = {
      url = "./org-howto";
      flake = false;
    };
  };

  outputs = { self, nixpkgs, org_howto_path } :
    let
      system = "x86_64-linux";
      pkgs = import nixpkgs { inherit system; };

      # creates shell script 'serve-org-howto'.
      # to use:
      #   $ cd ~/proj/public_html
      # A.
      #   $ nix build
      #   $ ./result/bin/serve-org-howto
      # B.
      #   $ nix run
      #
      serve_org_howto_deriv = pkgs.writeShellScriptBin "serve-org-howto" ''
        ${pkgs.python3}/bin/python3 -m http.server 8080 --directory ${org_howto_path}
      '';

      # builds custom docker image!
      serve_org_howto_docker_deriv =
        let
          serve_org_howto = self.packages.${system}.serve_org_howto;
        in
          pkgs.dockerTools.buildLayeredImage {
            name = serve_org_howto.name;
            tag = "1.0";
            contents = [ serve_org_howto ];

            config = {
              Cmd = [ "/bin/serve-org-howto" ];
              WorkingDir = "/";
            };
          };

    in rec {
      packages.${system} = {
        default = serve_org_howto_deriv;

        serve_org_howto = serve_org_howto_deriv;
        serve_org_howto_docker = serve_org_howto_docker_deriv;
      };
    };
}