diff --git a/manual/A-Brief-Introduction-to-the-Zettelkasten-Method.html b/manual/A-Brief-Introduction-to-the-Zettelkasten-Method.html index f64349c..8c4d58e 100644 --- a/manual/A-Brief-Introduction-to-the-Zettelkasten-Method.html +++ b/manual/A-Brief-Introduction-to-the-Zettelkasten-Method.html @@ -26,7 +26,7 @@ General Public License for more details. - + + + + + + + + +
+

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

+
+
+ +

2 Target Audience

+ +

Org-roam is a tool that will appear unfriendly to anyone unfamiliar with Emacs +and Org-mode, but is also extremely powerful to those willing to put effort in +mastering the intricacies of the tools. Org-roam stands on the shoulders on +giants. Emacs was first created in 1985, and remains a top tier tool for editing +text and designing textual interfaces. The malleability of Emacs allowed the +creation of Org-mode, an all-purpose plain-text system for maintaining TODO +lists, planning projects, and authoring documents. Both of these tools are +incredibly vast and require significant time investment to master. +

+

Org-roam assumes basic familiarity with these tools. It is not difficult to get +up and running with basic text-editing functionality, but one will only fully +appreciate the power of building Roam functionality into Emacs and Org-mode when +the usage of these tools become more advanced. +

+

One key advantage to Org-roam is that building on top of Emacs gives it +malleability. This is especially important for note-taking workflows. It is our +belief that note-taking workflows are extremely personal, and there is no one +tool that’s perfect for you. Org-mode and Org-roam allows you to discover what +works for you, and build that perfect tool for yourself. +

+

If you are new to the software, and choose to take this leap of faith, I hope +you find yourself equally entranced as Neal Stephenson was. +

+
+

Emacs outshines all other editing software in approximately the same way that +the noonday sun does the stars. It is not just bigger and brighter; it simply +makes everything else vanish. – Neal Stephenson, In the Beginning was the +Command Line (1998) +

+
+ +
+
+

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

+
+ + + + + diff --git a/manual/Template-Walkthrough.html b/manual/Template-Walkthrough.html index 15be973..078797c 100644 --- a/manual/Template-Walkthrough.html +++ b/manual/Template-Walkthrough.html @@ -67,7 +67,7 @@ Next: -

6.1 Template Walkthrough

+

7.1 Template Walkthrough

To demonstrate the additions made to org-capture templates. Here, we walkthrough the default template, reproduced below. diff --git a/manual/The-Org_002droam-Buffer.html b/manual/The-Org_002droam-Buffer.html index 14dceee..864a724 100644 --- a/manual/The-Org_002droam-Buffer.html +++ b/manual/The-Org_002droam-Buffer.html @@ -67,7 +67,7 @@ Next: -

7.2 The Org-roam Buffer

+

8.2 The Org-roam Buffer

The Org-roam buffer displays backlinks for the currently active Org-roam note.

diff --git a/manual/The-Templating-System.html b/manual/The-Templating-System.html index 3374b32..c296d74 100644 --- a/manual/The-Templating-System.html +++ b/manual/The-Templating-System.html @@ -67,7 +67,7 @@ Next:
-

6 The Templating System

+

7 The Templating System

Rather than creating blank files on org-roam-insert and org-roam-find-file, it may be desirable to prefill the file with templated content. This may diff --git a/manual/The-roam_002dfile-protocol.html b/manual/The-roam_002dfile-protocol.html index 3ce3724..b4e2627 100644 --- a/manual/The-roam_002dfile-protocol.html +++ b/manual/The-roam_002dfile-protocol.html @@ -67,7 +67,7 @@ Next:

-

12.3 The roam-file protocol

+

13.3 The roam-file protocol

This is a simple protocol that opens the path specified by the file key (e.g. org-protocol://roam-file?file=/tmp/file.org). This is used diff --git a/manual/The-roam_002dref-protocol.html b/manual/The-roam_002dref-protocol.html index b372519..b9c5e24 100644 --- a/manual/The-roam_002dref-protocol.html +++ b/manual/The-roam_002dref-protocol.html @@ -67,7 +67,7 @@ Previous:

-

12.4 The roam-ref protocol

+

13.4 The roam-ref protocol

This protocol finds or creates a new note with a given roam_key (see Anatomy of an Org-roam File):

diff --git a/manual/Titles.html b/manual/Titles.html index b17a3ae..bae5ecd 100644 --- a/manual/Titles.html +++ b/manual/Titles.html @@ -67,7 +67,7 @@ Next: , Up: -

5.1 Titles

+

6.1 Titles

To easily find a note, a title needs to be prescribed to a note. A note can have many titles: this allows a note to be referred to by different names, which is diff --git a/manual/Versioning-Notes.html b/manual/Versioning-Notes.html index e39a7e8..c7eaaee 100644 --- a/manual/Versioning-Notes.html +++ b/manual/Versioning-Notes.html @@ -67,7 +67,7 @@ Next: -

16.2.2 Versioning Notes

+

17.2.2 Versioning Notes

Since Org-roam notes are just plain text, it is trivial to track changes in your notes database using version control systems such as Git. Simply initialize diff --git a/manual/_005f.html b/manual/_005f.html index 0cf3cf1..122ce11 100644 --- a/manual/_005f.html +++ b/manual/_005f.html @@ -67,7 +67,7 @@ Next:

-

12.1 _ :ignore:

+

13.1 _ :ignore:

Org-roam extending org-protocol with 2 protocols: the roam-file and roam-ref protocol. diff --git a/manual/index.html b/manual/index.html index 82b9149..c1817c2 100644 --- a/manual/index.html +++ b/manual/index.html @@ -71,68 +71,69 @@ ul.no-bullet {list-style: none}

@@ -180,21 +181,23 @@ General Public License for more details. - - - - - - - - + diff --git a/org-roam.org b/org-roam.org index e493a46..a74cce4 100644 --- a/org-roam.org +++ b/org-roam.org @@ -56,6 +56,38 @@ Org-roam provides several benefits over other tooling: - Leverages the Org-mode ecosystem :: Over the years, Emacs and Org-mode has developed into a mature system for plain-text organization. Building upon Org-mode already puts Org-roam light-years ahead of many other solutions. - Built on Emacs :: Emacs is also a fantastic interface for editing text, and we can inherit many of the powerful text-navigation and editing packages available to Emacs. +* Target Audience + +Org-roam is a tool that will appear unfriendly to anyone unfamiliar with Emacs +and Org-mode, but is also extremely powerful to those willing to put effort in +mastering the intricacies of the tools. Org-roam stands on the shoulders on +giants. Emacs was first created in 1985, and remains a top tier tool for editing +text and designing textual interfaces. The malleability of Emacs allowed the +creation of Org-mode, an all-purpose plain-text system for maintaining TODO +lists, planning projects, and authoring documents. Both of these tools are +incredibly vast and require significant time investment to master. + +Org-roam assumes basic familiarity with these tools. It is not difficult to get +up and running with basic text-editing functionality, but one will only fully +appreciate the power of building Roam functionality into Emacs and Org-mode when +the usage of these tools become more advanced. + +One key advantage to Org-roam is that building on top of Emacs gives it +malleability. This is especially important for note-taking workflows. It is our +belief that note-taking workflows are extremely personal, and there is no one +tool that's perfect for you. Org-mode and Org-roam allows you to discover what +works for you, and build that perfect tool for yourself. + +If you are new to the software, and choose to take this leap of faith, I hope +you find yourself equally entranced as Neal Stephenson was. + +#+BEGIN_QUOTE +Emacs outshines all other editing software in approximately the same way that +the noonday sun does the stars. It is not just bigger and brighter; it simply +makes everything else vanish. – Neal Stephenson, In the Beginning was the +Command Line (1998) +#+END_QUOTE + * A Brief Introduction to the Zettelkasten Method Org-roam provides utilities for maintaining a digital slip-box. This section diff --git a/org-roam.texi b/org-roam.texi index 7bc5442..ddbd60e 100644 --- a/org-roam.texi +++ b/org-roam.texi @@ -65,6 +65,7 @@ General Public License for more details. @menu * Introduction:: +* Target Audience:: * A Brief Introduction to the Zettelkasten Method:: * Installation:: * Getting Started:: @@ -186,6 +187,40 @@ Over the years, Emacs and Org-mode has developed into a mature system for plain- Emacs is also a fantastic interface for editing text, and we can inherit many of the powerful text-navigation and editing packages available to Emacs. @end table +@node Target Audience +@chapter Target Audience + +Org-roam is a tool that will appear unfriendly to anyone unfamiliar with Emacs +and Org-mode, but is also extremely powerful to those willing to put effort in +mastering the intricacies of the tools. Org-roam stands on the shoulders on +giants. Emacs was first created in 1985, and remains a top tier tool for editing +text and designing textual interfaces. The malleability of Emacs allowed the +creation of Org-mode, an all-purpose plain-text system for maintaining TODO +lists, planning projects, and authoring documents. Both of these tools are +incredibly vast and require significant time investment to master. + +Org-roam assumes basic familiarity with these tools. It is not difficult to get +up and running with basic text-editing functionality, but one will only fully +appreciate the power of building Roam functionality into Emacs and Org-mode when +the usage of these tools become more advanced. + +One key advantage to Org-roam is that building on top of Emacs gives it +malleability. This is especially important for note-taking workflows. It is our +belief that note-taking workflows are extremely personal, and there is no one +tool that's perfect for you. Org-mode and Org-roam allows you to discover what +works for you, and build that perfect tool for yourself. + +If you are new to the software, and choose to take this leap of faith, I hope +you find yourself equally entranced as Neal Stephenson was. + +@quotation +Emacs outshines all other editing software in approximately the same way that +the noonday sun does the stars. It is not just bigger and brighter; it simply +makes everything else vanish. – Neal Stephenson, In the Beginning was the +Command Line (1998) + +@end quotation + @node A Brief Introduction to the Zettelkasten Method @chapter A Brief Introduction to the Zettelkasten Method
• Introduction:  
• A Brief Introduction to the Zettelkasten Method:   +
• Target Audience:  
• Installation:   +
• A Brief Introduction to the Zettelkasten Method:  
• Getting Started:   +
• Installation:  
• Anatomy of an Org-roam File:   +
• Getting Started:  
• The Templating System:   +
• Anatomy of an Org-roam File:  
• Concepts and Configuration:   +
• The Templating System:  
• Navigating Around:   +
• Concepts and Configuration:  
• Encryption:   +
• Navigating Around:   +
• Encryption:  
• Graphing: