10 |
11 | This program is a structured notetaking application based on GTK+ 3.
12 | Write your notes in instantly-formatted Markdown, organise them in a
13 | tree of folders that can be instantly navigated from within the
14 | program, and add hand-drawn notes by mouse, touchscreen or
15 | digitiser.
16 |
17 |
18 | 1. Why?
19 |
20 |
21 | I figured it would be nice to have a free-software,
22 | platform-independent OneNote. While there is a remarkable number of
23 | free (speech or beer) notetaking applications out there, to my best
24 | knowledge, none of them simultaneously check the following boxes:
25 |
26 |
27 | - note organisation
28 | - text as a first-class object
29 | - formatting
30 | - simple, standard on-disk format
31 | - tablet input
32 |
33 |
34 | 2. Usage notes
35 |
36 |
37 | Note management
38 |
39 |
40 | - To create a new note, doubleclick a "+" node in the tree view
41 | and enter a name.
42 | - To create a new folder, doubleclick a "+" node in the tree view
43 | and enter a name ending in "/", e.g. new "folder/".
44 | - Notes will be sorted alphabetically.
45 | - You can move notes and whole folders between folders by dragging
46 | and dropping.
47 | - Files are saved automatically when the window is closed, when a
48 | different file is opened, and after a timeout when no user
49 | action is performed.
50 |
51 |
52 | Markdown
53 |
54 |
55 | - Some markdown features are unsupported as a stylistic choice or
56 | because of parser limitations. If you are feeling adventurous,
57 | you can adjust the markdown parser by editing the GtkSourceView
58 | language definition in "sourceview/markdown.lang".
59 | - Add LaTeX math using single "$" signs, e.g. "$\int x dx$".
60 | - Some markdown will be hidden ("rendered") unless your cursor is
61 | next to it.
62 |
63 |
64 | Note management
65 |
66 |
67 | - Drawings can currently only be deleted whole. (This will be
68 | fixed eventually.)
69 | - To edit the default colour palette, right-click any of the
70 | colour buttons on the right-hand toolbar.
71 | - Due to present limitations, drawing clears the undo stack.
72 | - When copypasting text into other applications, drawings will be
73 | automatically converted into data URL PNGs.
74 |
75 |
76 | Note management
77 |
78 |
79 | -
80 | The program loads a custom Gtk+ stylesheet found in
81 | "data/stylesheet.css". Clear it if parts of the UI look wonky.
82 |
83 | - If something unexpected happens, it is often useful to run the
84 | program from a terminal and look at stdout.
85 |
86 |
87 |