Skip to content

Wiki-like personal knowledge management tool running locally in browser

License

Notifications You must be signed in to change notification settings

bobzgibb/NotedW

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NotedW

Wiki-like personal knowledge management tool running locally in browser - with backup possibility to local files (and hopefully to DropBox at some point in the future)

SPA

Install & first use

  • Just copy the single dist/notedw_dist.html file to any local folder, and open it in your favourite browser.
  • It is advised to add a new page with the title Main. This will serve as a "homepage" in the future. When clicking the Home button, this Main will be shown.

Features

  • Markdown syntax on pages
  • Wiki-like page referencing (page names within [] )
  • Segment editing for Level 1 or Level 2 markdown headers (click on the Pencil icon)
  • Breadcrumbs and list of pages
  • Diagrams (mermaid and bpmn ) can be inserted in the pages within a code block
  • Simple annotation for to do-s (@@ before the text of the task)
  • Backup possibility (click on cogwheel icon at the top right corner)

Some examples

Create page reference with todo

# Main topic
## Subtopic
Lorem ipsum dolor sit amet, consectetur adipiscing elit. [Curabitur] pretium lacus vel elit ullamcorper tincidunt. Nulla ornare ante sem, nec mollis turpis sollicitudin eget. Sed sit amet velit eu massa maximus volutpat. Nam dignissim erat vel dignissim cursus. Curabitur lobortis enim eu mauris congue, vel [pretium] ante pellentesque. ...
@@ Write page [Curabitur]
@@ Write page [pretium]

Create simple diagram within a page

The page structure is given by using markdown. The diagram shall be created within a code block. The definition and edit is done manually, the syntax is according to the desired diagram.

# Page
'''
graph LR;
A(something) --> B(anything);
B --> C[everything];
'''

It is possible to insert graph, gantt or sequenceDiagram similar to the above. The detailed syntax is to be found in the mermaid documentation.

Adding BPMN diagram to a page

The structure is defined by markdown. The BPMN diagram is not edited manually, but in a WYSIWYG editor launched in another window, by clicking on the BPMN block. The placeholder for a new diagram is created like this:

# Page
'''
bpmn

'''

The empty space will be filled with xml data. The page can be edited manually afterwards. To ensure the XML consistency, it is advised, to leave the BPMN codeblock unabridged.

Detailed help

You can find more examples with some screenshots in the docs folder.

Credits

Many thanks to the

  • marked project for the Markdown parser,
  • mermaid project for the graph library,
  • BPMN.io for the BPMN.js viewer and editor library
  • and to the StackExchange community for the hundreds of already asked and answered questions, which helped me along. (No new question was posted during development.)

This personal wiki / note-taking tool is created by Bob Z. Gibb. You can contact me if you have questions, suggestions, etc.

About

Wiki-like personal knowledge management tool running locally in browser

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published