[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/org-real 8f7ef62 085/160: Updated readme
From: |
ELPA Syncer |
Subject: |
[elpa] externals/org-real 8f7ef62 085/160: Updated readme |
Date: |
Wed, 6 Oct 2021 16:58:21 -0400 (EDT) |
branch: externals/org-real
commit 8f7ef627521fb4dd412e91c442bf15a72f4c5d79
Author: Tyler Grinn <tylergrinn@gmail.com>
Commit: Tyler Grinn <tylergrinn@gmail.com>
Updated readme
---
README.org | 87 ++++++++++++++++++++++++++++++++++++++++++++++++++------------
1 file changed, 70 insertions(+), 17 deletions(-)
diff --git a/README.org b/README.org
index 3d1f5aa..8d02395 100644
--- a/README.org
+++ b/README.org
@@ -2,22 +2,59 @@
Keep track of real things as org-mode links.
+
+* Status *BETA*
+* Installation
+
+** Using
[[https://github.com/raxod502/straight.el#getting-started][straight.el]]
(defaults shown)
#+begin_src emacs-lisp
(use-package org-real
- :straight (org-real :type git :host gitlab :repo "tygrdev/org-real"))
+ :straight (org-real :type git :host gitlab :repo "tygrdev/org-real")
+ :init
+ (setq org-real-default-visibility 2
+ org-real-flex-width 80
+ org-real-include-context t
+ org-real-margin-x 2
+ org-real-margin-y 1
+ org-real-padding-x 2
+ org-real-padding-y 1))
#+end_src
-*OR*
-
-[[https://gitlab.com/tygrdev/org-real/-/releases][Download the latest release]]
-
-and
-
-=M-x package-install-file org-real-x.y.z.el=
-
-=M-x load-library RET org-real=
+** Manual installation
+ First, [[https://gitlab.com/tygrdev/org-real/-/releases][download the
latest release]] (=org-real-x.y.z.el=)
+
+*** Try it out
+ You can try it out in the current emacs session with:
+
+ =M-x load-file RET org-real-x.y.z.el=
+*** Permanent installation
+ Or you can install it permanently by running:
+
+ =M-x package-install-file RET org-real-x.y.z.el=
+
+ and adding the following to your init file.
+
+ Bare bones:
+ #+begin_src emacs-lisp
+ (require 'org-real)
+ #+end_src
+
+ Or, for use-package (defaults shown)
+ #+begin_src emacs-lisp
+ (use-package org-real
+ :init
+ (setq org-real-default-visibility 2
+ org-real-flex-width 80
+ org-real-include-context t
+ org-real-margin-x 2
+ org-real-margin-y 1
+ org-real-padding-x 2
+ org-real-padding-y 1))
+ #+end_src
+*** Manual upgrade
+ Download the latest release and run:
+ =M-x package-install-file RET org-real-x.y.z.el=
-* Status *BETA*
* Usage
** Inserting a link
To create a real link in org-mode, use =C-c C-l real RET=.
@@ -96,12 +133,9 @@ and
In the org real diagram, emacs movement keys will navigate by boxes
rather than characters. Each box in the diagram has these options:
- - RET / mouse-1
- Jump to first occurrence of link
- - o
- Cycle occurrences of links in other window
- - M-RET
- Open all occurences of links by splitting the current window
+ - =RET / mouse-1= Jump to first occurrence of link
+ - =o= Cycle occurrences of links in other window
+ - =M-RET= Open all occurences of links by splitting the current window
[[file:demo/org-real-mode.gif]]
@@ -126,3 +160,22 @@ and
- to the left of
[[file:demo/headline-relationships.png]]
+
+
+* Development
+
+** Setup
+
+ Install [[https://github.com/doublep/eldev#installation][eldev]]
+
+** Commands:
+*** =eldev lint=
+ Lint the =org-real.el= file
+*** =eldev compile=
+ Test whether ELC has any complaints
+*** =eldev test=
+ Run all test files in =tests/=
+*** =eldev package=
+ Creates a dist folder with =org-real-<version>.el=
+*** =eldev md5=
+ Creates an md5 checksum against all files in the dist folder.
- [elpa] externals/org-real 20e80af 145/160: Bump version, (continued)
- [elpa] externals/org-real 20e80af 145/160: Bump version, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real babe4da 148/160: Add submodules during ci/cd pipeline, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real a13ee17 155/160: Added elpaignore, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real 89c1120 153/160: Linting, rearranging, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real 19711cb 159/160: Updated elpaignore, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real af8744b 151/160: Removed `org-real-headlines`, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real d95d469 156/160: Changed cl-defmethod to defun; linting, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real 80799f6 150/160: Linting, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real 791ed99 157/160: Added url-parse, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real 0d25274 084/160: Passing edge cases, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real 8f7ef62 085/160: Updated readme,
ELPA Syncer <=
- [elpa] externals/org-real 87dfecc 081/160: Org real headlines switched to add-next, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real e0d81ab 098/160: Bump version, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real a8e336d 095/160: Typo in flex-adjust, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real 5fb78c3 108/160: Skip adding box if it already exists, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real 900f96a 129/160: Added is-plural, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real fb056dc 078/160: Reuse window if org real diagram already visible, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real 4cc110c 086/160: Added document container to org-real-headlines, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real 4246089 096/160: Rotate locations of box when cycling, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real 193f14d 138/160: Refactoring, ELPA Syncer, 2021/10/06
- [elpa] externals/org-real 7e51167 128/160: Linting/documentation, ELPA Syncer, 2021/10/06