[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/toc-org 1df1f58c5e 003/128: update readme
From: |
ELPA Syncer |
Subject: |
[nongnu] elpa/toc-org 1df1f58c5e 003/128: update readme |
Date: |
Sun, 2 Jan 2022 09:59:05 -0500 (EST) |
branch: elpa/toc-org
commit 1df1f58c5e5a006a06d83f12bf26b1e39514d6a3
Author: Sergei Nosov <sergei.nosov@gmail.com>
Commit: Sergei Nosov <sergei.nosov@gmail.com>
update readme
---
README.org | 58 ++++++++++++++++++++++++++++++++++++++++++++++------------
1 file changed, 46 insertions(+), 12 deletions(-)
diff --git a/README.org b/README.org
index c307428fde..ff00f6b17e 100644
--- a/README.org
+++ b/README.org
@@ -1,4 +1,4 @@
-* Intro
+* About
org-toc is a utility to have an up-to-date table of contents in the
org files without exporting (useful primarily for readme files on
@@ -8,24 +8,42 @@ It is similar to the
[[https://github.com/ardumont/markdown-toc][markdown-toc]]
files.
* Table of Contents :TOC:
- - [[#intro][Intro]]
+ - [[#about][About]]
- [[#installation][Installation]]
+ - [[#via-packageel][via package.el]]
+ - [[#manual][Manual]]
- [[#use][Use]]
* Installation
-
-- *TBD*
+** via package.el
+This is the simplest method if you have the package.el module
+(built-in since Emacs 24.1) you can simply use =M-x package-install=
+and then put the following snippet in your ~/.emacs file
+#+BEGIN_SRC elisp
+ (eval-after-load "org-toc-autoloads"
+ '(progn
+ (if (require org-toc nil t)
+ (add-hook 'org-mode-hook 'org-toc-enable)
+ (warn "org-toc not found"))))
+#+END_SRC
+** Manual
+- Create folder ~/.emacs.d if you don't have it
+- Go to it and clone org-toc there
+ #+BEGIN_SRC sh
+ git clone https://github.com/snosov1/org-toc.git
+ #+END_SRC
+- Put this in your ~/.emacs file
+ #+BEGIN_SRC elisp
+ (add-to-list 'load-path "~/.emacs.d")
+ (when (require org-toc nil t)
+ (add-hook 'org-mode-hook 'org-toc-enable))
+ #+END_SRC
* Use
-If you put the following line into your .emacs file:
-
-#+BEGIN_SRC emacs-lisp
- (add-hook 'org-mode-hook 'org-toc-enable)
-#+END_SRC
-
-Then every time you'll be saving an org file, the first headline with
-a :TOC: tag will be updated with the current table of contents.
+After the installation, every time you'll be saving an org file, the
+first headline with a :TOC: tag will be updated with the current table
+of contents.
To add a TOC tag, you can use the command =org-set-tags-command=.
@@ -39,3 +57,19 @@ tag formats:
GitHub-style hrefs in the table of contents (the default). The other
supported href style is 'org', which is the default org style (you
can use C-c C-o to go to the headline at point).
+
+* Example
+#+BEGIN_SRC org
+ * About
+ * Table of Contents :TOC:
+ - [[#about][About]]
+ - [[#installation][Installation]]
+ - [[#via-packageel][via package.el]]
+ - [[#manual][Manual]]
+ - [[#use][Use]]
+ * Installation
+ ** via package.el
+ ** Manual
+ * Use
+ * Example
+#+END_SRC
- [nongnu] branch elpa/toc-org created (now a2cb4c254f), ELPA Syncer, 2022/01/02
- [nongnu] elpa/toc-org cc367dee40 002/128: fix issues mentioned in the PR, ELPA Syncer, 2022/01/02
- [nongnu] elpa/toc-org 1df1f58c5e 003/128: update readme,
ELPA Syncer <=
- [nongnu] elpa/toc-org 32441dd37e 007/128: add missing quotes to readme, ELPA Syncer, 2022/01/02
- [nongnu] elpa/toc-org 928e215c13 001/128: init, ELPA Syncer, 2022/01/02
- [nongnu] elpa/toc-org b1fc800d3f 005/128: fix old name, ELPA Syncer, 2022/01/02
- [nongnu] elpa/toc-org a3db0cfc07 006/128: fix typo, ELPA Syncer, 2022/01/02
- [nongnu] elpa/toc-org 49e3bcb8db 009/128: update readme with different href styles, ELPA Syncer, 2022/01/02
- [nongnu] elpa/toc-org c3a549fd96 012/128: add a couple of tests, ELPA Syncer, 2022/01/02
- [nongnu] elpa/toc-org 9c5861ceee 004/128: add parent group to fix compilation warning, ELPA Syncer, 2022/01/02
- [nongnu] elpa/toc-org 91670bcc41 014/128: add badges, ELPA Syncer, 2022/01/02
- [nongnu] elpa/toc-org 8364e88da3 015/128: fix travis badge, ELPA Syncer, 2022/01/02
- [nongnu] elpa/toc-org 381abe6c52 032/128: add a renaming note, ELPA Syncer, 2022/01/02