
# Table of Contents

1.  [Installation](#installation)
2.  [Usage](#usage)
3.  [Packages](#packages)
4.  [Information](#information)
5.  [Errors](#errors)
6.  [TODOs](#todos)

This is an ongoing evolution of Emacs configuration files, inspired by
a bunch of online resources.


<a id="installation"></a>

# Installation

Download repo and point the emacs `init` (and `early-init.el`) file to
this configuration.

Or run one of the following install script commands (using curl, wget or fetch).

    sh -c "$(curl -fsSL http://gitea.weseng.de/daniel/emacs/raw/master/scripts/install.sh)"
    sh -c "$(wget -O- http://gitea.weseng.de/daniel/emacs/raw/master/scripts/install.sh)"
    sh -c "$(fetch -o - http://gitea.weseng.de/daniel/emacs/raw/master/scripts/install.sh)"

Installation path is `~/.config/emacs`. See details and other
installed linux packages as requirements inside `sripts/install.sh`.


<a id="usage"></a>

# Usage

See the emacs command `my-help` for some key-bindings and further
commands and information.

-   Org Templates
    -   Article: `?article[TAB]` / YASnippet - org-mode - Article
        Templates - Article
    -   Letter: `?letter[TAB]` / YASnippet - org-mode - Letter Templates -
        Letter
-   Org Export
    -   To Article HTML (extended version)
        -   `my-org-article-html-export-to-html` / My - Org Export - Article HTML
        -   `my-org-article-html-export-to-html-notify-async` (`F5`) / My - Org Export - Article HTML async
    -   To Article PDF (LaTeX, extended version)
        -   `my-org-article-latex-export-to-pdf` / My - Org Export - Article PDF
        -   `my-org-article-latex-export-to-pdf-notify-async` (`F6`) / My - Org Export - Article PDF async
    -   To Letter (LaTeX)
        -   `my-org-letter-latex-export-to-pdf` (`C-c C-e l t`)


<a id="packages"></a>

# Packages

General key bindings and functions

-   `C-r` (`query-replace-regexp`) replace text
-   `C-x RET f` (`set-buffer-file-coding-system`) e.g. set to =utf-8
-   (`decode-coding-region`) e.g. decode to `utf-8` (郭富城Aaron Kwok)
-   (`diff-buffer-with-file`) show a diff between buffer (current state) and file (saved state)

<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">


<colgroup>
<col  class="org-left" />

<col  class="org-right" />

<col  class="org-left" />
</colgroup>
<tbody>
<tr>
<td class="org-left">PACKAGE_____________________</td>
<td class="org-right">VERSION______</td>
<td class="org-left">REPO_______</td>
</tr>


<tr>
<td class="org-left">ace-window</td>
<td class="org-right">20220911.358</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">adaptive-wrap</td>
<td class="org-right">0.8</td>
<td class="org-left">elpa-gnu</td>
</tr>


<tr>
<td class="org-left">all-the-icons</td>
<td class="org-right">20220929.2303</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">amx</td>
<td class="org-right">20210305.118</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">anaconda-mode</td>
<td class="org-right">20220922.741</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">async</td>
<td class="org-right">20221217.649</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">avy</td>
<td class="org-right">20220910.1936</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">awesome-tray</td>
<td class="org-right">4.2</td>
<td class="org-left">custom</td>
</tr>


<tr>
<td class="org-left">biblio</td>
<td class="org-right">20210418.406</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">biblio-core</td>
<td class="org-right">20210418.406</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">bibtex-completion</td>
<td class="org-right">20221024.857</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">bind-key</td>
<td class="org-right">20221209.2013</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">citeproc</td>
<td class="org-right">20221216.1238</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">cl-libify</td>
<td class="org-right">20181130.23</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">company</td>
<td class="org-right">20221206.2122</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">company-anaconda</td>
<td class="org-right">20200404.1859</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">company-ledger</td>
<td class="org-right">20210910.25</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">company-quickhelp</td>
<td class="org-right">20221212.534</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">company-web</td>
<td class="org-right">20220115.2146</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">counsel</td>
<td class="org-right">20221015.936</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">crdt</td>
<td class="org-right">0.3.5</td>
<td class="org-left">elpa-gnu</td>
</tr>


<tr>
<td class="org-left">ctable</td>
<td class="org-right">20210128.629</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">dash</td>
<td class="org-right">20221013.836</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">dashboard</td>
<td class="org-right">20221206.1228</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">deft</td>
<td class="org-right">20210707.1633</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">delight</td>
<td class="org-right">1.7</td>
<td class="org-left">elpa-gnu</td>
</tr>


<tr>
<td class="org-left">dialog</td>
<td class="org-right">0.2</td>
<td class="org-left">custom</td>
</tr>


<tr>
<td class="org-left">diff-hl</td>
<td class="org-right">20221007.2147</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">dim</td>
<td class="org-right">20160818.949</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">elisp-refs</td>
<td class="org-right">20220704.2141</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">emojify</td>
<td class="org-right">20210108.1111</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">ess</td>
<td class="org-right">20221204.1348</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">ess-R-data-view</td>
<td class="org-right">20130509.1158</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">f</td>
<td class="org-right">20220911.711</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">flycheck</td>
<td class="org-right">20221213.107</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">flycheck-ledger</td>
<td class="org-right">20200304.2204</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">flycheck-pos-tip</td>
<td class="org-right">20200516.16</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">flyspell-correct</td>
<td class="org-right">20220520.63</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">flyspell-correct-ivy</td>
<td class="org-right">20220520.63</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">focus</td>
<td class="org-right">20221016.1846</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">git-commit</td>
<td class="org-right">20221127.2227</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">git-messenger</td>
<td class="org-right">20201202.1637</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">gnuplot</td>
<td class="org-right">20221112.2049</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">helpful</td>
<td class="org-right">20221209.1743</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">ht</td>
<td class="org-right">20221031.705</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">htmlize</td>
<td class="org-right">20210825.215</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">hydra</td>
<td class="org-right">20220910.1206</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">indent-guide</td>
<td class="org-right">20210115.4</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">iscroll</td>
<td class="org-right">20220612.31</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">ivy</td>
<td class="org-right">20220926.125</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">ivy-bibtex</td>
<td class="org-right">20210927.1205</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">ivy-rich</td>
<td class="org-right">20210409.931</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">js2-mode</td>
<td class="org-right">20221028.1819</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">key-chord</td>
<td class="org-right">20201222.203</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">langtool</td>
<td class="org-right">20200529.23</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">ledger-mode</td>
<td class="org-right">20220623.1125</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">lv</td>
<td class="org-right">20200507.1518</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">magit</td>
<td class="org-right">20221208.1848</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">magit-section</td>
<td class="org-right">20221127.2227</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">markdown-mode</td>
<td class="org-right">20221210.348</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">memoize</td>
<td class="org-right">20200103.2036</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">mu4e-maildirs-extension</td>
<td class="org-right">20220517.1852</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">multiple-cursors</td>
<td class="org-right">20221126.743</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">ob-async</td>
<td class="org-right">20210428.2052</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">org</td>
<td class="org-right">9.6</td>
<td class="org-left">elpa-gnu</td>
</tr>


<tr>
<td class="org-left">org-appear</td>
<td class="org-right">20220617.2355</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">org-brain</td>
<td class="org-right">20210706.1519</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">org-cliplink</td>
<td class="org-right">20201126.102</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">org-contrib</td>
<td class="org-right">0.4.1</td>
<td class="org-left">elpa-nongnu</td>
</tr>


<tr>
<td class="org-left">org-drill</td>
<td class="org-right">20210427.2003</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">org-fancy-priorities</td>
<td class="org-right">20210830.1657</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">org-fragtog</td>
<td class="org-right">20220714.2146</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">orgit</td>
<td class="org-right">20221127.2228</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">org-ref</td>
<td class="org-right">20221129.1925</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">org-sticky-header</td>
<td class="org-right">20201223.143</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">org-superstar</td>
<td class="org-right">20210915.1934</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">org-table-sticky-header</td>
<td class="org-right">20190924.506</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">ov</td>
<td class="org-right">20200326.1042</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">ox-pandoc</td>
<td class="org-right">20220705.1036</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">ox-reveal</td>
<td class="org-right">20221127.814</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">ox-tufte</td>
<td class="org-right">20160926.1607</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">page-break-lines</td>
<td class="org-right">20210104.2224</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">parsebib</td>
<td class="org-right">20221007.1402</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">pdf-tools</td>
<td class="org-right">20221202.1104</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">persist</td>
<td class="org-right">0.5</td>
<td class="org-left">elpa-gnu</td>
</tr>


<tr>
<td class="org-left">pfuture</td>
<td class="org-right">20220913.1401</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">php-mode</td>
<td class="org-right">20221112.1616</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">plantuml-mode</td>
<td class="org-right">20191102.2056</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">polymode</td>
<td class="org-right">20220820.163</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">popup</td>
<td class="org-right">20220927.161</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">popwin</td>
<td class="org-right">20210215.1849</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">pos-tip</td>
<td class="org-right">20220715.102</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">powershell</td>
<td class="org-right">20220805.1712</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">pythonic</td>
<td class="org-right">20220723.1741</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">queue</td>
<td class="org-right">0.2</td>
<td class="org-left">elpa-gnu</td>
</tr>


<tr>
<td class="org-left">rainbow-mode</td>
<td class="org-right">1.0.6</td>
<td class="org-left">elpa-gnu</td>
</tr>


<tr>
<td class="org-left">restart-emacs</td>
<td class="org-right">20201127.1425</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">s</td>
<td class="org-right">20220902.1511</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">spacemacs-theme</td>
<td class="org-right">20221103.1406</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">sphinx-doc</td>
<td class="org-right">20210213.125</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">sql-indent</td>
<td class="org-right">1.6</td>
<td class="org-left">elpa-gnu</td>
</tr>


<tr>
<td class="org-left">srefactor</td>
<td class="org-right">20180703.181</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">stickyfunc-enhance</td>
<td class="org-right">20150429.1814</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">string-inflection</td>
<td class="org-right">20220910.1306</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">swiper</td>
<td class="org-right">20220430.2247</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">systemd</td>
<td class="org-right">20210209.2052</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">transient</td>
<td class="org-right">20221202.1727</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">treemacs</td>
<td class="org-right">20221107.2105</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">treemacs-magit</td>
<td class="org-right">20220917.1026</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">use-package</td>
<td class="org-right">20221209.2013</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">virtual-auto-fill</td>
<td class="org-right">20200906.2038</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">visual-fill-column</td>
<td class="org-right">20220519.1959</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">vterm</td>
<td class="org-right">20221118.1354</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">web-completion-data</td>
<td class="org-right">20160318.848</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">web-mode</td>
<td class="org-right">20221012.8</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">which-key</td>
<td class="org-right">20220811.1616</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">with-editor</td>
<td class="org-right">20221127.2243</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">yasnippet</td>
<td class="org-right">20200604.246</td>
<td class="org-left">melpa</td>
</tr>


<tr>
<td class="org-left">yasnippet-snippets</td>
<td class="org-right">20220713.1234</td>
<td class="org-left">melpa</td>
</tr>
</tbody>
</table>


<a id="information"></a>

# Information

Interlock symlinks and auto-save files.
Be aware that symbolic links of the form “.#\*” are not auto-save files
but interlocks to prevent the simultaneous editing of the same
file. See [Interlocking](https://www.emacswiki.org/info-ref?find=Interlocking) in the [EmacsManual](https://www.emacswiki.org/emacs/EmacsManual) for details.


<a id="errors"></a>

# Errors

-   failed execution of bibtex2html
    -   see bib2htmlxxxxxx.blg for errors, e.g.
        -   I couldn&rsquo;t open style file acmu.bst
    -   copy/merge the texmf directory into your home directory.
-   when using this in an Org mode buffer:
    `#+HEADER: :fit yes :imagemagick yes :iminoptions -density 300`
    -   can leads to:
        -   ``convert: attempt to perform an operation not allowed by the security policy `gs' @ error/delegate.c/ExternalDelegateCommand/378.``
        -   ``convert: no images defined `DESY_logo_tikz.png' @ error/convert.c/ConvertImageCommand/3282.``
    -   edit `/etc/ImageMagick-7/policy.xml` and comment out
        -   `<policy domain="delegate" rights="none" pattern="gs" />`


<a id="todos"></a>

# TODOs

-   Org / global configuration
    -   Page formatting
        -   Modify HTML styling
            -   Printed page layout, white styled figures
-   Figures
    -   Gnuplot
        -   plot transposed files/tables
-   Tables
    -   Wrap Table in div element. For smartphone scrolling.
-   Table of contents
    -   $\LaTeX$; currently headers with no-number property means not included in TOC
    -   HTML; currently generated list, like lot and lol, are not included in toc
        but own headers without numbers are.
-   Equation cancel/strike out with color line
    -   hcancel[color]{}
    -   Example: `\(\hcancel[red]{f_{X_2}(x_2)}}\)`
    -   Definition:
        -   Preamble: `#+LATEX_HEADER: \usepackage{cancel}`   
            `#+LATEX_HEADER: \newcommand\hcancel[2][black]{\setbox0=\hbox{$#2$}%`   
            `#+LATEX_HEADER: \rlap{\raisebox{.45\ht0}{\textcolor{#1}{\rule{\wd0}{1pt}}}}#2}`
        -   `hcancel: [\"{\\\\setbox0=\\\\hbox{$#2$}\\\\rlap{\\\\raisebox{.45\\\\ht0}{\\\\textcolor{#1}{\\\\rule{\\\\wd0}{1pt}}}}#2}\",2]`
            
                MathJax.Ajax.config.path[\"Contrib\"] = \"https://cdn.mathjax.org/mathjax/contrib\";
                MathJax.Hub.Register.StartupHook(\"TeX Jax Ready\",function () {
                    MathJax.Hub.Insert(MathJax.InputJax.TeX.Definitions.macros,{
                        cancel: [\"Extension\",\"cancel\"],
                        bcancel: [\"Extension\",\"cancel\"],
                        xcancel: [\"Extension\",\"cancel\"],
                        cancelto: [\"Extension\",\"cancel\"]
                    });
                });

