daniel/emacs
1
2
Fork 0
Code Issues 7 Pull Requests Projects Releases Wiki Activity

add more information about packages

Browse Source
This commit is contained in:
Daniel Weschke
2021-02-16 14:36:31 +01:00
parent 09e44e084b
commit ea842bb955
2 changed files with 309 additions and 131 deletions
Download Patch File Download Diff File Expand all files Collapse all files

269
README.md
View File

@@ -1,32 +1,40 @@
# Table of Contents
1. [Requirements](#orgcb9390d)
2. [Installation](#orgf9a7dd2)
3. [Key bindings and functions](#org4741345)
4. [Packages](#org62b82b1)
5. [Information](#orgc744d51)
6. [Errors](#org27051a8)
1. [failed execution of bibtex2html](#orga0059df)
1. [Requirements](#requirements)
2. [Installation](#installation)
3. [Packages](#packages)
1. [Org](#org)
2. [Multiple cursors](#multiple-cursors)
3. [Other packages](#other-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="orgcb9390d"></a>
<a id="requirements"></a>
# Requirements
external packages:
# flyspell-buffer
yay -S aspell hunspell
# org-mode latex-mode
yay -S biber bibtex2html
# fonts (opensans in latex article preamble)
yay -S ttf-inconsolata ttf-opensans
# spelling flyspell-buffer
yay -S aspell aspell-de aspell-en \
hunspell hunspell-de hunspell-en_US \
languagetool
# org-mode latex-mode ox-latex
yay -S biber bibtex2html texlive-bibtexextra texlive-core \
texlive-fontsextra texlive-formatsextra texlive-langgreek \
texlive-langjapanese texlive-latexextra texlive-pgf-pie \
texlive-pgfopts texlive-pictures texlive-pstricks \
texlive-publishers texlive-science texlive-slashbox
# ledger-mode
yay -S ledger
# langtool
yay -S languagetool
# python-mode
yay -S python-pylint
# emacs-application-famework EAF
@@ -34,11 +42,13 @@ external packages:
python-pyqt5 python-pyqt5-sip python-pyqtwebengine python-qrcode \
python-feedparser python-dbus python-pyinotify python-markdown \
python-grip filebrowser-bin python-epc
# other
yay -S ditaa plantuml r
Optional package for EAF see in Installation.
<a id="orgf9a7dd2"></a>
<a id="installation"></a>
# Installation
@@ -52,7 +62,8 @@ or copy all files of this directory into your ~/.config/emacs directory
- `ln -s ~/.config/emacs/init ~/.emacs` (or `~/.emacs.el`,
`~/.emacs.d/init.el`)
copy/merge the texmf directory into your home directory
LaTeX sytling files: copy/merge the `texmf` directory into your home
directory `~/texmf`
optional for EAF
@@ -66,12 +77,12 @@ edit `PGKBUILD` file for `python-pymupdf` to:
}
<a id="org4741345"></a>
<a id="packages"></a>
# Key bindings and functions
# Packages
<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
<caption class="t-above"><span class="table-number">Table 1:</span> General</caption>
<caption class="t-above"><span class="table-number">Table 1:</span> General key bindings and functions</caption>
<colgroup>
<col class="org-left" />
@@ -142,11 +153,79 @@ edit `PGKBUILD` file for `python-pymupdf` to:
<td class="org-left">counsel-describe-funtion</td>
<td class="org-left">help text of function</td>
</tr>
<tr>
<td class="org-left">C-r</td>
<td class="org-left">query-replace-regexp</td>
<td class="org-left">replace text. (former isearch-backward)</td>
</tr>
<tr>
<td class="org-left">C-x C-b</td>
<td class="org-left">ibuffer</td>
<td class="org-left">list buffers (former list-buffers)</td>
</tr>
<tr>
<td class="org-left">C-x &vert;</td>
<td class="org-left">toggle-window-split</td>
<td class="org-left">toggle horizontal/vertical 2 window split</td>
</tr>
<tr>
<td class="org-left">M-up</td>
<td class="org-left">move-line-up</td>
<td class="org-left">move current line up</td>
</tr>
<tr>
<td class="org-left">M-down</td>
<td class="org-left">move-line-down</td>
<td class="org-left">move current line down</td>
</tr>
<tr>
<td class="org-left">mouse-6</td>
<td class="org-left">&#xa0;</td>
<td class="org-left">scroll right</td>
</tr>
<tr>
<td class="org-left">mouse-7</td>
<td class="org-left">&#xa0;</td>
<td class="org-left">scroll left</td>
</tr>
<tr>
<td class="org-left">mouse-8</td>
<td class="org-left">previous-buffer</td>
<td class="org-left">&#xa0;</td>
</tr>
<tr>
<td class="org-left">mouse-9</td>
<td class="org-left">next-buffer</td>
<td class="org-left">&#xa0;</td>
</tr>
</tbody>
</table>
<a id="org"></a>
## Org
<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
<caption class="t-above"><span class="table-number">Table 2:</span> Org</caption>
<caption class="t-above"><span class="table-number">Table 2:</span> Org key bindings and functions</caption>
<colgroup>
<col class="org-left" />
@@ -252,79 +331,18 @@ edit `PGKBUILD` file for `python-pymupdf` to:
<td class="org-left">org-babel-tangle</td>
<td class="org-left">create a file with the content of the block, use in header: :tangle filename</td>
</tr>
</tbody>
</table>
<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
<caption class="t-above"><span class="table-number">Table 3:</span> Custom and changed keys</caption>
<colgroup>
<col class="org-left" />
<col class="org-left" />
<col class="org-left" />
</colgroup>
<tbody>
<tr>
<td class="org-left">C-r</td>
<td class="org-left">query-replace-regexp</td>
<td class="org-left">replace text. (former isearch-backward)</td>
</tr>
<tr>
<td class="org-left">C-x C-b</td>
<td class="org-left">ibuffer</td>
<td class="org-left">list buffers (former list-buffers)</td>
</tr>
<tr>
<td class="org-left">C-x &vert;</td>
<td class="org-left">toggle-window-split</td>
<td class="org-left">toggle horizontal/vertical 2 window split</td>
</tr>
<tr>
<td class="org-left">M-up</td>
<td class="org-left">move-line-up</td>
<td class="org-left">move current line up</td>
</tr>
<tr>
<td class="org-left">M-down</td>
<td class="org-left">move-line-down</td>
<td class="org-left">move current line down</td>
</tr>
<tr>
<td class="org-left">mouse-6</td>
<td class="org-left">&#xa0;</td>
<td class="org-left">scroll right</td>
</tr>
<tr>
<td class="org-left">mouse-7</td>
<td class="org-left">&#xa0;</td>
<td class="org-left">scroll left</td>
</tr>
<tr>
<td class="org-left">mouse-8</td>
<td class="org-left">previous-buffer</td>
<td class="org-left">&#xa0;</td>
</tr>
<tr>
<td class="org-left">mouse-9</td>
<td class="org-left">next-buffer</td>
<td class="org-left">Org export</td>
<td class="org-left">&#xa0;</td>
<td class="org-left">&#xa0;</td>
</tr>
@@ -344,8 +362,28 @@ edit `PGKBUILD` file for `python-pymupdf` to:
</tbody>
</table>
**Important**
- For **Gnuplot** source blocks: Do not use `%` inside Gnuplot source
block but `\%` or in format command `\%%`
- % starts a comment in LaTeX and therefore stops further
interpretations like a closing bracket `}` etc.
- Gnuplot graphics are imported as .tex (text, axis, legend) and
.eps (figure) files.
- `\%` `\%%` can also be used for HTML SVG export
Links
- <https://tex.stackexchange.com/questions/167583/include-custom-file-into-header-with-org-mode/201674>
- <https://orgmode.org/manual/LaTeX-specific-export-settings.html>
<a id="multiple-cursors"></a>
## Multiple cursors
<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
<caption class="t-above"><span class="table-number">Table 4:</span> Multiple cursors</caption>
<caption class="t-above"><span class="table-number">Table 3:</span> Multiple cursors key bindings and functions</caption>
<colgroup>
<col class="org-left" />
@@ -385,16 +423,16 @@ edit `PGKBUILD` file for `python-pymupdf` to:
</table>
<a id="org62b82b1"></a>
<a id="other-packages"></a>
# Packages
## Other packages
- **rainbow-mode.el:** <https://elpa.gnu.org/packages/rainbow-mode.html>
rainbow-mode is a minor mode for Emacs which displays strings representing
colors with the color they represent as background.
<a id="orgc744d51"></a>
<a id="information"></a>
# Information
@@ -404,18 +442,61 @@ 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="org27051a8"></a>
<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&rsquo; @ error/delegate.c/ExternalDelegateCommand/378.
- convert: no images defined \`DESY<sub>logo</sub><sub>tikz.png</sub>&rsquo; @ error/convert.c/ConvertImageCommand/3282.
- edit `/etc/ImageMagick-7/policy.xml` and comment out
- `<policy domain="delegate" rights="none" pattern="gs" />`
<a id="orga0059df"></a>
## failed execution of bibtex2html
<a id="todos"></a>
see bib2htmlxxxxxx.blg for errors, e.g.
# TODOs
- I couldn&rsquo;t open style file acmu.bst
copy/merge the texmf directory into your home directory.
- Org / global configuration
- Page formatting
- Modify HTML styling
- Printed page layout, white styled figures
- Custom export function for HTML and \(\LaTeX\), with;
- `Shift` - `<f5>`, `Shift` - `<f6>` with open file
- delete temp. generated export files
- Figures
- Gnuplot
- plot transposed files/tables
- preamble in function and call this function for every gnuplot block either
manually or automatically with a hook?!
- 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:
- Preamle: `#+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\"]
});
});

171
README.org
View File

@@ -6,16 +6,25 @@ This is an ongoing evolution of Emacs configuration files, inspired by
a bunch of online resources.
* Requirements
:PROPERTIES:
:CUSTOM_ID: requirements
:END:
external packages:
#+begin_src shell
# flyspell-buffer
yay -S aspell hunspell
# org-mode latex-mode
yay -S biber bibtex2html
# fonts (opensans in latex article preamble)
yay -S ttf-inconsolata ttf-opensans
# spelling flyspell-buffer
yay -S aspell aspell-de aspell-en \
hunspell hunspell-de hunspell-en_US \
languagetool
# org-mode latex-mode ox-latex
yay -S biber bibtex2html texlive-bibtexextra texlive-core \
texlive-fontsextra texlive-formatsextra texlive-langgreek \
texlive-langjapanese texlive-latexextra texlive-pgf-pie \
texlive-pgfopts texlive-pictures texlive-pstricks \
texlive-publishers texlive-science texlive-slashbox
# ledger-mode
yay -S ledger
# langtool
yay -S languagetool
# python-mode
yay -S python-pylint
# emacs-application-famework EAF
@@ -23,10 +32,15 @@ a bunch of online resources.
python-pyqt5 python-pyqt5-sip python-pyqtwebengine python-qrcode \
python-feedparser python-dbus python-pyinotify python-markdown \
python-grip filebrowser-bin python-epc
# other
yay -S ditaa plantuml r
#+end_src
Optional package for EAF see in Installation.
* Installation
:PROPERTIES:
:CUSTOM_ID: installation
:END:
Install into =~/.config/emacs= (must be empty)
#+begin_src sh
git clone http://gogs.weseng.de/daniel/emacs.git ~/.config/emacs
@@ -39,7 +53,8 @@ a bunch of online resources.
- =ln -s ~/.config/emacs/init ~/.emacs= (or =~/.emacs.el=,
=~/.emacs.d/init.el=)
copy/merge the texmf directory into your home directory
LaTeX sytling files: copy/merge the =texmf= directory into your home
directory =~/texmf=
optional for EAF
#+begin_src shell
@@ -54,19 +69,35 @@ a bunch of online resources.
}
#+end_example
* Key bindings and functions
#+caption: General
| M-> | end-of-buffer | |
| M-< | beginning-of-buffer | |
| C-x h | mark-whole-buffer | mark the whole buffer |
| C-x TAB | indent-rigidly | indent selected region |
| 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 and file |
| C-h v | counsel-describe-variable | help text of variable |
| C-h f | counsel-describe-funtion | help text of function |
* Packages
:PROPERTIES:
:CUSTOM_ID: packages
:END:
#+caption: General key bindings and functions
| M-> | end-of-buffer | |
| M-< | beginning-of-buffer | |
| C-x h | mark-whole-buffer | mark the whole buffer |
| C-x TAB | indent-rigidly | indent selected region |
| 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 and file |
| C-h v | counsel-describe-variable | help text of variable |
| C-h f | counsel-describe-funtion | help text of function |
| C-r | query-replace-regexp | replace text. (former isearch-backward) |
| C-x C-b | ibuffer | list buffers (former list-buffers) |
| C-x \vert | toggle-window-split | toggle horizontal/vertical 2 window split |
| M-up | move-line-up | move current line up |
| M-down | move-line-down | move current line down |
| mouse-6 | | scroll right |
| mouse-7 | | scroll left |
| mouse-8 | previous-buffer | |
| mouse-9 | next-buffer | |
#+caption: Org
** Org
:PROPERTIES:
:CUSTOM_ID: org
:END:
#+caption: Org key bindings and functions
| C-c \vert | org-table-create-or-convert-from-region | convert seperator 1. TAB, 2. comma, 3. space |
| C-u C-c \vert | org-table-create-or-convert-from-region | convert using comma (CSV) seperator |
| C-u C-u C-c \vert | org-table-create-or-convert-from-region | convert using TAB |
@@ -81,39 +112,105 @@ a bunch of online resources.
| | | |
| Org src block | | |
| C-c C-v t | org-babel-tangle | create a file with the content of the block, use in header: :tangle filename |
| | | |
| Org export | | |
| f5 | | in org export to html |
| f6 | | in org export to LaTeX |
#+caption: Custom and changed keys
| C-r | query-replace-regexp | replace text. (former isearch-backward) |
| C-x C-b | ibuffer | list buffers (former list-buffers) |
| C-x \vert | toggle-window-split | toggle horizontal/vertical 2 window split |
| M-up | move-line-up | move current line up |
| M-down | move-line-down | move current line down |
| mouse-6 | | scroll right |
| mouse-7 | | scroll left |
| mouse-8 | previous-buffer | |
| mouse-9 | next-buffer | |
| f5 | | in org export to html |
| f6 | | in org export to LaTeX |
*Important*
- For *Gnuplot* source blocks: Do not use =%= inside Gnuplot source
block but =\%= or in format command =\%%=
- % starts a comment in LaTeX and therefore stops further
interpretations like a closing bracket =}= etc.
- Gnuplot graphics are imported as .tex (text, axis, legend) and
.eps (figure) files.
- =\%= =\%%= can also be used for HTML SVG export
#+caption: Multiple cursors
Links
- https://tex.stackexchange.com/questions/167583/include-custom-file-into-header-with-org-mode/201674
- https://orgmode.org/manual/LaTeX-specific-export-settings.html
** Multiple cursors
:PROPERTIES:
:CUSTOM_ID: multiple-cursors
:END:
#+caption: Multiple cursors key bindings and functions
| M-m s m a | mc/mark-all-dwim | try to mark all at point |
| C-v | | jump to next cursor |
| M-v | | jump to previous cursor |
| C-' | | hide/unhide lines without a cursor |
* Packages
** Other packages
:PROPERTIES:
:CUSTOM_ID: other-packages
:END:
- rainbow-mode.el :: https://elpa.gnu.org/packages/rainbow-mode.html
rainbow-mode is a minor mode for Emacs which displays strings representing
colors with the color they represent as background.
* 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
** 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.
: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
- Custom export function for HTML and \(\LaTeX\), with;
- =Shift= - =<f5>=, =Shift= - =<f6>= with open file
- delete temp. generated export files
- Figures
- Gnuplot
- plot transposed files/tables
- preamble in function and call this function for every gnuplot block either
manually or automatically with a hook?!
- 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:
- Preamle: ~#+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