index.org source

#+title: assorted how-tos
#+author: Roland Conybeare
#+email: git3ub@nym.hush.com
#
# org-publish options
# H:2   controls section numbering.
#       number top-level and second-level headings only
# ^:{}  require a_{b} before assuming that b should be subscripted.
#       without this option a_b will automatically subscript b.
#+options: ^:{}
#
# options used exclusively by emacs
#+startup: showall
#
# options used exclusively by the html exporter
#+setupfile: ext/fniessen/theme-readtheorg.setup
#+language: en
#
#+html_head: <link rel="shortcut icon" type="image/x-icon" href="img/favicon.ico" />
#
# not using: prefer theme-readtheorg
# +infojs_opt: view:showall mouse:#ffc0c0 toc:nil ltoc:nil path:/web/ext/orginfo/org-info.js
# +html_head: <link rel="stylesheet" type="text/css" href="/web/css/primary.css" />
# +html_link_home: index.html

* Introduction
  How-to articles maintained at [[https://github.com/Rconybea/org-howto]]

  ~org-publish~ generates html tree in =$HOME/proj/public_html/org-howto=.

  Recent snapshots available from github pages: [[https://rconybea.github.io/web]]

* Contents
  - [[file:lessons/til.org][TIL]] lessons learned - problems & fixes
  - [[file:lessons/ls2r.org][LS2R]] quirky corner cases

  - software projects
    - xo: c++/python libraries for event-based simulation; cmake/c++/pybind11/websockets
      - [[file:sw/xo.org][xo libraries intro]]
      - [[https://github.com/Rconybea/xo][xo]] umbrella repo for all xo libraries (using git submodules)
      - [[https://github.com/rconybea/xo-nix2][xo-nix2]] xo nix build using flakes (TODO: update per nix cookbook below)
      - [[https://github.com/rconybea/xo-nix3][xo-nix3]] git CI build; using nix-built custom docker container
      - [[https://github.com/Rconybea/docker-xo-builder][docker-xo-builder]] custom docker container with all xo build deps

  - cmake-examples progressive walkthrough; cmake/c++/boost/gcov/pybind11/doxygen/sphinx; +nix
    - [[https://github.com/rconybea/cmake-examples][cmake-examples]] primary repo
    - [[https://github.com/rconybea/cmake-examples-nix][cmake-examples-nix]] nix build of cmake-examples

  - [[file:env/development-environment.org][c++ development environment]] emacs/lsp/cmake/c++/nix/github/docker
    - [[file:env/emacs-setup.org][.emacs walkthrough]] terse!
    - [[file:env/org-mode-resources.org][org-mode resources]]
    - [[file:env/publish-static-html.org][publish static html]] org-mode -> github pages
    - [[file:env/github-continuous-integration.org][continuous integration]] with github + nix + docker
    - [[file:nix/nix-for-your-own-project.org][nix cookbook]] build your own projects with nix

  - unix environment
    - [[file:env/windows11-setup.org][windows11 setup]] wsl2 life hacks
    - file:env/gpg-setup.org GPG setup
    - file:env/email-setup.org email setup
    - [[file:env/cleanmbox.org]] automatically tidy email messages

  - [[file:orgpub/org-examples.org][org-examples]] cookbook for org-mode publishing
  - file:d3/d3-examples.org d3 (javascript graphics library) examples
  - file:octave/octave-crib.org octave examples

* .org source
   ~org-mode~ source here: [[file:index-src.org][index-src.org]]