From 4e63382bb723b7e483527489d0eacb7949a58fea Mon Sep 17 00:00:00 2001 From: jethrokuan Date: Sat, 26 Sep 2020 05:56:43 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20=20@=20176b2?= =?UTF-8?q?bf19df96bb44d3063f4a6d0bf3150cb1a0e=20=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../Installing-from-the-Git-Repository.html | 73 +++++++++++++++++- manual/index.html | 2 +- org-roam.org | 62 ++++++++++++++- org-roam.texi | 75 ++++++++++++++++++- 4 files changed, 207 insertions(+), 5 deletions(-) diff --git a/manual/Installing-from-the-Git-Repository.html b/manual/Installing-from-the-Git-Repository.html index 3b6b054..c2e2a7f 100644 --- a/manual/Installing-from-the-Git-Repository.html +++ b/manual/Installing-from-the-Git-Repository.html @@ -66,9 +66,78 @@ ul.no-bullet {list-style: none} Next: , Previous: , Up: Installation   [Contents]

- -

4.3 TODO Installing from the Git Repository

+ +

4.3 Installing from the Git Repository

+

You may install Org-roam directly from the repository on GitHub if you like. This will give you access to the latest version hours or days before it appears on MELPA, and months (or more) before it is added to the Debian or Ubuntu repositories. This will also give you access to various developmental branches that may be available. +

+

Note, however, that development version, and especially any feature branches, may not always be in working order. You’ll need to be prepared to do some debugging, or to manually roll-back to working versions, if you install from GitHub. +

+

Installing from GitHub requires that you clone the repository: +

+
+
git clone https://github.com/org-roam/org-roam.git /path/to/org/roam
+
+ +

where ./path/to/org/roam is the location you will store your copy of the code. +

+

Next, you need to add this location to your load path, and require the Org-roam library. Add the following code to your .emacs: +

+
+
(add-to-list 'load-path "/path/to/org/roam")
+(require 'org-roam)
+
+ +

You now have Org-roam installed. However, you don’t necessarily have the dependencies that it requires. These include: +

+ + +

You can install this manually as well, or get the latest version from MELPA. You may wish to use use-package, straight.el, or some other tool or tools to help manage this. +

+

If you would like to install the manual for access from Emacs’ built-in Info system, you’ll need to compile the .texi source file, and install it in an appropriate location. +

+

To compile the .texi source file, from a terminal navigate to the /doc subdirectory of the Org-roam repository, and run the following: +

+
+
make infodir=/path/to/my/info/files install-info
+
+ +

Where /path/to/my/info/files is the location where you keep info files. This target directory needs to be stored in the variable ‘Info-default-directory-list‘. If you aren’t using one of the default info locations, you can configure this with the following in your .emacs file: +

+
+
(require 'info)
+(add-to-list 'Info-default-directory-list
+             "/path/to/my/info/files")
+
+ +

You can also use one of the default locations, such as: +

+ + +

If you do this, you’ll need to make sure you have write-access to that location, or run the above make command as root. +

+

Now that the info file is ready, you need to add it to the corresponding dir file: +

+
+
install-info /path/to/my/info/files/org-roam.info /path/to/my/info/files/dir
+
+ +
+
+

+Next: , Previous: , Up: Installation   [Contents]

+
diff --git a/manual/index.html b/manual/index.html index 8c33ac5..4607f7e 100644 --- a/manual/index.html +++ b/manual/index.html @@ -77,7 +77,7 @@ ul.no-bullet {list-style: none}
  • 5 Getting Started
    • diff --git a/org-roam.org b/org-roam.org index c293c41..8f15007 100644 --- a/org-roam.org +++ b/org-roam.org @@ -195,7 +195,67 @@ using Apt: Org-roam will then be autoloaded into Emacs. -** TODO Installing from the Git Repository +** Installing from the Git Repository + +You may install Org-roam directly from the repository on [[https://github.com/org-roam/org-roam][GitHub]] if you like. This will give you access to the latest version hours or days before it appears on MELPA, and months (or more) before it is added to the Debian or Ubuntu repositories. This will also give you access to various developmental branches that may be available. + +Note, however, that development version, and especially any feature branches, may not always be in working order. You'll need to be prepared to do some debugging, or to manually roll-back to working versions, if you install from GitHub. + +Installing from GitHub requires that you clone the repository: + +#+begin_src bash +git clone https://github.com/org-roam/org-roam.git /path/to/org/roam +#+end_src + +where ~./path/to/org/roam~ is the location you will store your copy of the code. + +Next, you need to add this location to your load path, and ~require~ the Org-roam library. Add the following code to your ~.emacs~: + +#+begin_src elisp +(add-to-list 'load-path "/path/to/org/roam") +(require 'org-roam) +#+end_src + +You now have Org-roam installed. However, you don't necessarily have the dependencies that it requires. These include: + +- dash +- f +- s +- org +- emacsql +- emacsql-sqlite3 + +You can install this manually as well, or get the latest version from MELPA. You may wish to use [[https://github.com/jwiegley/use-package][use-package]], [[https://github.com/raxod502/straight.el][straight.el]], or some other tool or tools to help manage this. + +If you would like to install the manual for access from Emacs' built-in Info system, you'll need to compile the .texi source file, and install it in an appropriate location. + +To compile the .texi source file, from a terminal navigate to the ~/doc~ subdirectory of the Org-roam repository, and run the following: + +#+begin_src bash +make infodir=/path/to/my/info/files install-info +#+end_src + +Where ~/path/to/my/info/files~ is the location where you keep info files. This target directory needs to be stored in the variable `Info-default-directory-list`. If you aren't using one of the default info locations, you can configure this with the following in your ~.emacs~ file: + +#+begin_src elisp +(require 'info) +(add-to-list 'Info-default-directory-list + "/path/to/my/info/files") +#+end_src + +You can also use one of the default locations, such as: + +- /usr/local/share/info/ +- /usr/share/info/ +- /usr/local/share/info/ + +If you do this, you'll need to make sure you have write-access to that location, or run the above ~make~ command as root. + +Now that the info file is ready, you need to add it to the corresponding ~dir~ file: + +#+begin_src bash +install-info /path/to/my/info/files/org-roam.info /path/to/my/info/files/dir +#+end_src ** Post-Installation Tasks diff --git a/org-roam.texi b/org-roam.texi index cd64238..c810477 100644 --- a/org-roam.texi +++ b/org-roam.texi @@ -346,7 +346,80 @@ using Apt: Org-roam will then be autoloaded into Emacs. @node Installing from the Git Repository -@section @strong{TODO} Installing from the Git Repository +@section Installing from the Git Repository + +You may install Org-roam directly from the repository on @uref{https://github.com/org-roam/org-roam, GitHub} if you like. This will give you access to the latest version hours or days before it appears on MELPA, and months (or more) before it is added to the Debian or Ubuntu repositories. This will also give you access to various developmental branches that may be available. + +Note, however, that development version, and especially any feature branches, may not always be in working order. You'll need to be prepared to do some debugging, or to manually roll-back to working versions, if you install from GitHub. + +Installing from GitHub requires that you clone the repository: + +@example +git clone https://github.com/org-roam/org-roam.git /path/to/org/roam +@end example + +where @code{./path/to/org/roam} is the location you will store your copy of the code. + +Next, you need to add this location to your load path, and @code{require} the Org-roam library. Add the following code to your @code{.emacs}: + +@lisp +(add-to-list 'load-path "/path/to/org/roam") +(require 'org-roam) +@end lisp + +You now have Org-roam installed. However, you don't necessarily have the dependencies that it requires. These include: + +@itemize +@item +dash +@item +f +@item +s +@item +org +@item +emacsql +@item +emacsql-sqlite3 +@end itemize + +You can install this manually as well, or get the latest version from MELPA@. You may wish to use @uref{https://github.com/jwiegley/use-package, use-package}, @uref{https://github.com/raxod502/straight.el, straight.el}, or some other tool or tools to help manage this. + +If you would like to install the manual for access from Emacs' built-in Info system, you'll need to compile the .texi source file, and install it in an appropriate location. + +To compile the .texi source file, from a terminal navigate to the @code{/doc} subdirectory of the Org-roam repository, and run the following: + +@example +make infodir=/path/to/my/info/files install-info +@end example + +Where @code{/path/to/my/info/files} is the location where you keep info files. This target directory needs to be stored in the variable `Info-default-directory-list`. If you aren't using one of the default info locations, you can configure this with the following in your @code{.emacs} file: + +@lisp +(require 'info) +(add-to-list 'Info-default-directory-list + "/path/to/my/info/files") +@end lisp + +You can also use one of the default locations, such as: + +@itemize +@item +@emph{usr/local/share/info} +@item +@emph{usr/share/info} +@item +@emph{usr/local/share/info} +@end itemize + +If you do this, you'll need to make sure you have write-access to that location, or run the above @code{make} command as root. + +Now that the info file is ready, you need to add it to the corresponding @code{dir} file: + +@example +install-info /path/to/my/info/files/org-roam.info /path/to/my/info/files/dir +@end example @node Post-Installation Tasks @section Post-Installation Tasks