Merge pull request #90 from ooker777/main

Update documentary

docs/Features/Styling/CSS Styling.md

@@ -183,9 +183,10 @@ edge.inline {
 }
 ```
 # Current limitations
+
 - CSS variables like `var(--background-primary)` will not be recognized. If this is something you need, please add a pull request.
-- `not()` does not seem to work.
 
+- `not()` does not seem to work.
 
 --- 
 #feature

docs/Neo4j Stream/Installing the Neo4j Stream Plugin.md

@@ -0,0 +1,79 @@
+---
+aliases: [installation, install]
+---
+The general steps to install the plugin are as follows:
+1. Make sure you have [[Neo4j Desktop]] installed. See [[Install Neo4j Stream Plugin#Install Neo4j Desktop]].
+3. Create a new database in Neo4j desktop and start it. See [[Install Neo4j Stream Plugin#Creating a Neo4j database]].
+5. Install the Obsidian plugin from the Third-party plugins list. See [[Install Neo4j Stream Plugin#Installing the Obsidian plugin]]
+6. In the settings of the plugin, enter the password. Then run the restart command. See [[Install Neo4j Stream Plugin#Configuring the Obsidian plugin]].
+
+If you are still running into problems after thorougly following these steps, see the [[Install Neo4j Stream Plugin#Troubleshooting]] section. 
+
+## 1. Install Neo4j Desktop
+Download [Neo4j desktop](https://neo4j.com/download/). Neo4j wants you to fill a form before giving you the link. Save the Neo4j Desktop Activation Key they provide for later. 
+
+![[Pasted image 20210112215108.png]]
+
+One user reported the activation key doesn't appear. [According to the Neo4j developers](https://community.neo4j.com/t/installing-and-activation-key/6173), that doesn't actually matter and you can proceed without using a key, curiously. I haven't tried this, though. 
+
+The download can take a while because it's a pretty big file and the servers aren't very quick. 
+
+Installation of Neo4j desktop is pretty straightforward. You have to input the key Neo4j gave you after registration. There's an [installation video](https://www.youtube.com/watch?v=pPhJi9twN9Q&feature=emb_title) if you need more help. 
+
+
+## 2. Creating a Neo4j database
+In a Project in Neo4j Desktop, click "+ Add Database" under projects:
+![[Pasted image 20201231174344.png|300]]
+
+Then select "Create a Local Database". Next follows this screen: 
+
+![[Pasted image 20201231174425.png|300]]
+
+You have to set a password here. We're also going to use it in the plugin. Make sure not to choose a sensitive password here! [[Neo4j Stream Plugin]] doesn't store passwords encrypted. You can choose any name. For the Neo4j version, I have tested on 4.2.0, but it should not matter much. 
+
+It'll create your database! Then, click the "Start" button. Note that you have to start your database every time whenever your computer reboots: It needs to remain active while you use the plugin. 
+
+### Possible problems
+Every now and then, the Graph database fails to start.
+- Sometimes, it just says it 'timed out'. Retrying it a few times may help.
+- Port in use: It's unlikely the port is actually in use. Restart Neo4j desktop and try again. It's currently not possible to set a port different than the default port (request on [[Github]] if needed).
+- "Could not change the password": This has been reported with a [[Windows]] user. See [this post](https://stackoverflow.com/questions/49342422/neo4j-database-failed-to-create-error-could-not-change-password) for possible guidance.
+
+## 3. Installing the Obsidian plugin
+Time to install the plugin! Since Neo4j Stream is unfinished, you will have to download and install it manually. 
+
+1. Download the plugin from [this link](https://github.com/HEmile/obsidian-neo4j-stream/releases). 
+1. Open the Obsidian settings, and go to Third-party plugins. Disable the "Safe mode" toggle, then click "Turn off safe mode" to confirm this. 
+2. Now, more options appear. Click on the "open plugin folders" icon
+3. In the resulting folder, create a new directory called `neo4j-stream`
+4. Extract the downloaded file into this folder.
+5. Close the current screen. In the Third-party plugins settings, enable Neo4j Stream with the slider. 
+
+## 4. Configuring Neo4j Stream
+We need to do one more thing before we can get playing with the plugin: Setting the password. 
+1. Go to the Neo4j Stream settings, which has appeared under Plugin options in the Obsidian settings. 
+2. In the password field, input the password you set during [[Install Neo4j Stream Plugin#Creating a Neo4j database]].  ![[Pasted image 20201231180930.png]]
+3. Close the settings view.
+4. Run the Obsidian command: "Neo4j Graph View: Restart Neo4j stream". You can run a command by using ctrl/cmd + p. ![[Pasted image 20201231181003.png]]
+5. The plugin is succesfully installed if the following notice appears in the top-right corner: ![[Pasted image 20201231181103.png|300]] (note: for some reason, it doesn't always appear even though the server did properly start...)
+
+If a different notice appears, something went wrong. Let's try to figure out what!
+
+## Troubleshooting
+If a notice appears that doesn't say the Neo4j stream is online, something went wrong. Two simple notices are
+- "Please provide a password in the Neo4j Stream settings": This means your user credentials weren't accepted by the Neo4j database. Check if the password is set correctly during [[Install Neo4j Stream Plugin#Configuring the Obsidian plugin]].
+- "No connection to Neo4j database. Please start Neo4j Database in Neo4j Desktop": This means there's no connection to a Neo4j database on port 7687. Check Neo4j desktop if the database is online.
+
+The third notice is scariest: "Error during initialization of the Neo4j stream. Check the console for crash report.". Here are some steps to help figure out how to resolve this:
+1. Enable "Debug" mode in the Neo4j Stream settings ![[Pasted image 20201231181917.png]]
+2. Open the Developer Tools. This option is under the View menu. If the View menu doesn't show, the keyboard shortcut to open it is Ctrl+Shift+I on windows and Option+Cmd+I on mac.
+3. Look at the error in the Console. 
+
+Otherwise, it's likely that there's some bug in the plugin in that it cannot handle something that's present in your vault. Since this version is unfinished, you will have to fork the plugin to fix this. 
+
+You can also contact [[Emile van Krieken|me]] on Twitter, Github or [[Discord]] if you need help. 
+
+--- 
+#howto
+- hasTopic [[Neo4j Graph View]]
+- author [[Emile van Krieken]]

docs/Neo4j Stream/Neo4j Stream Plugin.md

@@ -0,0 +1,19 @@
+This plugin helps by streaming your vault to a [Neo4j](https://neo4j.com/)  database. This is a separate plugin to ensure non-advanced users of [[Juggl]] will not have to deal with installing Neo4j, and is completely optional for advanced users.
+
+⚠ Note: This is an unfinshed pluggin. Absolutely no guarantees are given that this works.    
+
+Please refer to [[Install Neo4j Stream Plugin]] and [[Neo4j graph visualizations]] for more information
+
+## Development
+[[Roadmap]]: [[Roadmap#^2d1fd7]]
+
+Contributions are very much welcomed. The easiest way to get started is to join the [[Discord]] server! See [[Contributing]] for an overview of ways you can help.
+
+[HEmile/obsidian-neo4j-stream](https://github.com/HEmile/obsidian-neo4j-stream "HEmile/obsidian-neo4j-stream")
+
+--- 
+#plugin
+- hasTopic [[Neo4j]]
+- hasTopic [[Obsidian]]
+
+

docs/Neo4j Stream/Neo4j graph visualizations.md

@@ -0,0 +1,34 @@
+---
+aliases: []
+---
+
+The main use case for the [[Neo4j Stream Plugin]] is to use your Obsidian vault in one of the many apps in the [[Neo4j Desktop]]
+Graph Apps Store. Using with this plugin active will automatically connect it to your vault. Here are some suggestions:
+
+### Neo4j Bloom
+[Neo4j Bloom](https://neo4j.com/product/bloom/) is very powerful graph visualization software. Compared to the embedded
+graph view in Obsidian, it offers much more freedom in customization.
+
+![[bloom_screenshot.jpg]]
+
+
+### GraphXR
+[GraphXR](https://www.kineviz.com/) is a 3D graph view, which looks quite gorgeous!
+
+![[graphxr.gif]]
+
+
+### Neo4j Browser
+A query browser that uses the [[Cypher]] language to query your vault. Can be used for advanced queries or data anlysis of your vault. 
+
+![[browser_screenshot.png]]
+
+### Gephi
+Neo4j can export to the graph visualization software [[Gephi]]. See the [Neo4j document](https://neo4j.com/labs/apoc/4.1/export/gephi/) for help on how to do this. Note that it requires installing the "APOC" plugin to your Neo4j Graph Database.
+
+
+
+--- 
+#topic
+- hasTopic [[Neo4j]], [[Neo4j Stream Plugin]]
+- author [[Emile van Krieken]]

docs/Roadmap.md

@@ -6,9 +6,9 @@ aliases: []
 # Juggl
 ## Planned
 ### [[Neo4j Stream]]
-A new plugin that will upload your vault to [[Neo4j Desktop]]. This feature was present in [[Neo4j Graph View Plugin]], but not in [[Juggl]]. It'll be a separate plugin to ensure non-advanced users will not have to deal with installing Neo4j, and that this is completely optional for advanced users.
+Export your vault to [[Neo4j]]. 
+Later on, this will allow for [[Cypher]] querying in [[Juggl]] ^2d1fd7
 
-This plugin will not require installing Python, and will allow for [[Cypher]] querying in [[Juggl]]. 
 
 ### [[Link Types]]
 Add better support for creating and maintaining link types. Also provide new syntax for inline link types and properties on links. A discussion on syntax is in [[Link Types]].
@@ -18,8 +18,10 @@ Add better support for creating and maintaining link types. Also provide new syn
 - Autocomplete typed links
 
 ### [[Style Pane]] for edges
+
 Makes it easier to style typed links, and to filter edges.
-#### Outline in compound nodes
+### Outline in compound nodes
+
 The outline of a note is essentially a tree. As it is completely hierarchical wrt the node representing the note, it can be nicely rendered and collapsed using compound nodes, like in
 
 ![](https://cdn.discordapp.com/attachments/794501737062203422/798921299404652574/JfMR9BuCHr.gif)__