2019-03-04 01:24:46 +00:00
|
|
|
#+TITLE: ietf layer
|
|
|
|
|
|
2019-05-02 21:49:30 +00:00
|
|
|
#+TAGS: layer|misc
|
|
|
|
|
|
2019-03-04 01:24:46 +00:00
|
|
|
[[file:img/ietf-logo.png]]
|
|
|
|
|
|
2019-05-07 20:05:06 +00:00
|
|
|
* Table of Contents :TOC_5_gh:noexport:
|
2019-04-12 19:31:31 +00:00
|
|
|
- [[#description][Description]]
|
|
|
|
|
- [[#features][Features:]]
|
|
|
|
|
- [[#fetching-and-opening-ietf-documents][Fetching and Opening IETF Documents]]
|
|
|
|
|
- [[#viewing-ietf-documents][Viewing IETF Documents]]
|
|
|
|
|
- [[#writing-ietf-documents][Writing IETF Documents]]
|
|
|
|
|
- [[#install][Install]]
|
|
|
|
|
- [[#key-bindings][Key bindings]]
|
2019-03-04 01:24:46 +00:00
|
|
|
|
|
|
|
|
* Description
|
|
|
|
|
The =IETF= layer collects various useful packages for participating in the
|
2019-04-12 19:31:31 +00:00
|
|
|
Internet Engineering Task Force ([[https://www.ietf.org]]).
|
2019-03-04 01:24:46 +00:00
|
|
|
|
2019-04-12 18:09:51 +00:00
|
|
|
** Features:
|
|
|
|
|
- Fetching and opening IETF documents.
|
|
|
|
|
- Viewing IETF documents.
|
|
|
|
|
- Writing IETF documents.
|
2019-03-04 01:24:46 +00:00
|
|
|
|
2019-04-12 18:09:51 +00:00
|
|
|
* Fetching and Opening IETF Documents
|
2019-03-04 01:24:46 +00:00
|
|
|
Support for fetching and downloading IETF documents is added through the
|
|
|
|
|
=ietf-docs= package. The IETF docs package adds support for fetching and loading
|
|
|
|
|
IETF documents based on the name of a document (usually under the emacs point).
|
|
|
|
|
For example if the point is anwhere on the text RFC781 and one invokes the
|
|
|
|
|
=ietf-docs-open-at-point= the package will fetch the document to a local cache
|
|
|
|
|
(if not present) and view it. This works for the 3 standard document names,
|
|
|
|
|
STDXXX, RFCXXX and draft-xxxx-yyy.
|
|
|
|
|
|
2019-04-12 18:09:51 +00:00
|
|
|
* Viewing IETF Documents
|
2019-03-04 01:24:46 +00:00
|
|
|
Support for viewing IETF documents is added through the IRFC minor mode
|
|
|
|
|
(=irfc-mode=). The IRFC minor mode improves the display and formatting of IETF
|
|
|
|
|
documents using the well known IETF document structure. Additionally it creates
|
|
|
|
|
hyperlink overlays for references within the document.
|
|
|
|
|
|
2019-04-12 18:09:51 +00:00
|
|
|
* Writing IETF Documents
|
2019-03-04 01:24:46 +00:00
|
|
|
Support for writing IETF documents using org mode is added using the RFC Org
|
|
|
|
|
Mode Exporter (=ox-rfc=) package.
|
|
|
|
|
|
|
|
|
|
* Install
|
|
|
|
|
To use the ietf layer add it to your =~/.spacemacs=
|
|
|
|
|
|
2019-04-12 18:09:51 +00:00
|
|
|
#+BEGIN_SRC emacs-lisp
|
2019-03-04 01:24:46 +00:00
|
|
|
(setq-default dotspacemacs-configuration-layers '(ietf))
|
2019-04-12 18:09:51 +00:00
|
|
|
#+END_SRC
|
2019-03-04 01:24:46 +00:00
|
|
|
|
|
|
|
|
By default fetched IETF documents are stored in a subdirectory of the
|
|
|
|
|
=spacemacs-cache-directory=. To override this location you can set the
|
|
|
|
|
=ietf-docs-cache= variable.
|
|
|
|
|
|
2019-04-12 18:09:51 +00:00
|
|
|
#+BEGIN_SRC emacs-lisp
|
2019-03-04 01:24:46 +00:00
|
|
|
(setq-default dotspacemacs-configuration-layers '(
|
|
|
|
|
(ietf :variables
|
|
|
|
|
ietf-docs-cache "~/Downloads/ietf-docs-cache")))
|
2019-04-12 18:09:51 +00:00
|
|
|
#+END_SRC
|
2019-03-04 01:24:46 +00:00
|
|
|
|
|
|
|
|
* Key bindings
|
|
|
|
|
|
2019-04-12 19:31:31 +00:00
|
|
|
| Key binding | Description |
|
2019-03-04 01:24:46 +00:00
|
|
|
|-------------+-----------------------------------------------------|
|
|
|
|
|
| ~SPC f I~ | Opens IETF document based on the text at the point. |
|
