Files
emacs/README.org

285 lines
12 KiB
Org Mode

#+TITLE: Emacs Configuration
#+HTML_DOCTYPE: xhtml
# xhtml for gogs needed, bug showing table in the footer, bc/ html5 creates <col> instead of <col />
This is an ongoing evolution of Emacs configuration files, inspired by
a bunch of online resources.
* Installation
:PROPERTIES:
:CUSTOM_ID: installation
:END:
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).
#+begin_src sh
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)"
#+end_src
Installation path is =~/.config/emacs=. See details and other
installed linux packages as requirements inside =sripts/install.sh=.
* Usage
:PROPERTIES:
:CUSTOM_ID: usage
:END:
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=)
* Packages
:PROPERTIES:
:CUSTOM_ID: packages
:END:
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)
#+begin_src sh :results output :exports results
dir=$HOME/repos/emacs-conf/lisp
verinfo() {
#echo -n $1 ''
if test -f $dir/$1.el; then
ver=$(grep -i package-version: $dir/$1.el | cut -d":" -f2 | xargs)
if test -z $ver; then
ver=$(grep -i version: $dir/$1.el | cut -d":" -f2 | xargs)
fi
echo $ver
elif test -d $dir/$1; then
emacs --batch --eval "(princ (nth 2 (read (with-temp-buffer (insert-file-contents \"$dir/$1/$1-pkg.el\") (buffer-string)))))"
echo ''
fi
}
pkg_custom=$(
for i in $(echo awesome-tray dialog); do
pkg=$(sed 's/-[0-9].*//' <(basename $i))
ver=$(verinfo $pkg)
echo $pkg $ver custom
done)
pkg_elpagnu=$(
for i in $(ls -F ~/repos/my-elpa-gnu/archive/*.tar | grep -v @); do
pkg=$(sed 's/-[0-9].*//' <(basename $i))
ver=$(verinfo $pkg)
echo $pkg $ver elpa-gnu
done)
pkg_elpanongnu=$(
for i in $(ls -F ~/repos/my-elpa-nongnu/archive/*.tar | grep -v @); do
pkg=$(sed 's/-[0-9].*//' <(basename $i))
ver=$(verinfo $pkg)
echo $pkg $ver elpa-nongnu
done)
pkg_melpa=$(
for i in $(sort <(ls ~/repos/my-melpa/packages/*.tar | xargs -n1) <(ls ~/repos/my-melpa/packages/*.el | xargs -n1)); do
pkg=$(sed 's/-[0-9].*//' <(basename $i))
ver=$(verinfo $pkg)
echo $pkg $ver melpa
done)
echo -e "$pkg_custom\n$pkg_elpagnu\n$pkg_elpanongnu\n$pkg_melpa" | sort | column -t -N PACKAGE_____________________,VERSION______,REPO_______
#+end_src
#+RESULTS:
#+begin_example
PACKAGE_____________________ VERSION______ REPO_______
ace-window 20200606.1259 melpa
adaptive-wrap 0.8 elpa-gnu
all-the-icons 20211225.506 melpa
amx 20210305.118 melpa
anaconda-mode 20211122.817 melpa
async 20210823.528 melpa
avy 20220102.805 melpa
awesome-tray 4.2 custom
biblio 20210418.406 melpa
biblio-core 20210418.406 melpa
bibtex-completion 20211019.1306 melpa
bind-key 20210210.1609 melpa
citeproc 20220101.1527 melpa
cl-libify 20181130.230 melpa
company 20220103.351 melpa
company-anaconda 20200404.1859 melpa
company-ledger 20210910.250 melpa
company-quickhelp 20211115.1335 melpa
company-web 20180402.1155 melpa
counsel 20211230.1909 melpa
crdt 0.2.7 elpa-gnu
ctable 20210128.629 melpa
dash 20210826.1149 melpa
dashboard 20211221.2005 melpa
deft 20210707.1633 melpa
delight 1.7 elpa-gnu
dialog 0.2 custom
diff-hl 20211106.2353 melpa
dim 20160818.949 melpa
elisp-refs 20211009.1531 melpa
emojify 20210108.1111 melpa
ess 20211231.1746 melpa
ess-R-data-view 20130509.1158 melpa
f 20210624.1103 melpa
flycheck 20210825.1804 melpa
flycheck-ledger 20200304.2204 melpa
flycheck-pos-tip 20200516.1600 melpa
flyspell-correct 20210724.1042 melpa
flyspell-correct-ivy 20210124.1143 melpa
focus 20191209.2210 melpa
git-commit 20220101.841 melpa
git-messenger 20201202.1637 melpa
gnuplot 20220102.1637 melpa
helpful 20211226.1843 melpa
ht 20210119.741 melpa
htmlize 20210825.2150 melpa
hydra 20220102.803 melpa
indent-guide 20210115.400 melpa
iscroll 20210128.1938 melpa
ivy 20211231.1730 melpa
ivy-bibtex 20210927.1205 melpa
ivy-rich 20210409.931 melpa
js2-mode 20211229.135 melpa
key-chord 20201222.2030 melpa
langtool 20200529.230 melpa
ledger-mode 20211214.1449 melpa
lv 20200507.1518 melpa
magit 20220126.1645 melpa
magit-section 20220101.841 melpa
markdown-mode 20211022.55 melpa
memoize 20200103.2036 melpa
mu4e-maildirs-extension 20201028.921 melpa
multiple-cursors 20211112.2223 melpa
ob-async 20210428.2052 melpa
org 9.5.2 elpa-gnu
org-appear 20211202.604 melpa
org-brain 20210706.1519 melpa
org-cliplink 20201126.1020 melpa
org-contrib 0.3 elpa-nongnu
org-drill 20210427.2003 melpa
org-fancy-priorities 20210830.1657 melpa
org-fragtog 20220106.758 melpa
orgit 20210620.1943 melpa
org-ref 20220101.1941 melpa
org-sticky-header 20201223.143 melpa
org-superstar 20210915.1934 melpa
org-table-sticky-header 20190924.506 melpa
ov 20200326.1042 melpa
ox-reveal 20220410.1533 melpa
ox-tufte 20160926.1607 melpa
page-break-lines 20210104.2224 melpa
parsebib 20211208.2335 melpa
pdf-tools 20220103.308 melpa
persist 0.4 elpa-gnu
pfuture 20211229.1513 melpa
php-mode 20210808.1745 melpa
plantuml-mode 20191102.2056 melpa
polymode 20211124.913 melpa
popup 20211231.1823 melpa
popwin 20210215.1849 melpa
pos-tip 20191227.1356 melpa
powershell 20220103.925 melpa
pythonic 20210122.1247 melpa
queue 0.2 elpa-gnu
rainbow-mode 1.0.5 elpa-gnu
restart-emacs 20201127.1425 melpa
s 20210616.619 melpa
spacemacs-theme 20210924.1220 melpa
sphinx-doc 20210213.1250 melpa
sql-indent 1.6 elpa-gnu
srefactor 20180703.1810 melpa
stickyfunc-enhance 20150429.1814 melpa
string-inflection 20210918.419 melpa
swiper 20210919.1221 melpa
systemd 20210209.2052 melpa
transient 20220104.1601 melpa
treemacs 20220104.1302 melpa
treemacs-magit 20211010.1005 melpa
use-package 20210207.1926 melpa
virtual-auto-fill 20200906.2038 melpa
visual-fill-column 20211118.33 melpa
vterm 20211226.817 melpa
web-completion-data 20160318.848 melpa
web-mode 20220104.1504 melpa
which-key 20220102.1433 melpa
with-editor 20220101.1316 melpa
yasnippet 20200604.246 melpa
yasnippet-snippets 20210910.1959 melpa
#+end_example
* Information
:PROPERTIES:
:CUSTOM_ID: information
:END:
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 [[https://www.emacswiki.org/info-ref?find=Interlocking][Interlocking]] in the [[https://www.emacswiki.org/emacs/EmacsManual][EmacsManual]] for details.
* Errors
:PROPERTIES:
:CUSTOM_ID: errors
:END:
- failed execution of bibtex2html
- see bib2htmlxxxxxx.blg for errors, e.g.
- I couldn'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" />~
* TODOs
:PROPERTIES:
:CUSTOM_ID: todos
:END:
- 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]~
#+Begin_example
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\"]
});
});
#+End_example