Reproog/novelWriter
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Updated documentation for export and the user interface

Browse Source
This commit is contained in:
Veronica K. B. Olsen
2019-10-27 15:44:40 +01:00
parent aba339f8e3
commit 43ebcec4e9
7 changed files with 122 additions and 74 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/source/export.txt
+24 -3
View File
@@ -32,13 +32,34 @@ Plain Text
========== ==========
The plain text export format writes a simple ``.txt`` file without any formatting at all. The plain text export format writes a simple ``.txt`` file without any formatting at all.
It does, however, respect the centering of text if the Word-wrapping to a fixed column width is supported.
It does, however, respect the centering of text if the :guilabel:`Fixed width` setting is larger than ``0``.
Markdown
========
The markdown export formats writes a file using the valid markdown formats used by novelWriter, and converts comments to preformatted blocks by indenting it with four spaces.
Word-wrapping to a fixed column width is supported.
HTML5 Document
==============
The html5 export format writes a single ``.htm`` file with a minimal style settings block.
The style setting block sets a maximum page width of ``768px``.
Comments are exported as indented text boxes with a light yellow background.
LaTeX Document
==============
The latex export formats generats a simple ``.tex`` file using a ``report`` document format.
All chapters and sections are exported as unnumbered, and the internal header numbering formatting of novelWriter is used instead.
Word-wrapping to a fixed column width in the LaTeX source is supported.
***************** *****************
Header Formatting Header Formatting
***************** *****************
The chapter, scene and section headers for novel files can receive some special treatment using the formats under "Chapter Headings" and "Other Headings". The chapter, scene and section headers for novel files can receive some special treatment using the formats under :guilabel:`Chapter Headings` and :guilabel:`Other Headings`.
The chapters can either be of numbered or unnumbered type, the latter being suitable for prologues, epilogues, interludes, etc. The chapters can either be of numbered or unnumbered type, the latter being suitable for prologues, epilogues, interludes, etc.
The headers can be generated using free text in combination with replace tags. The headers can be generated using free text in combination with replace tags.
The tooltip will explain which tags are available for each heading type. The tooltip will explain which tags are available for each heading type.
@@ -53,7 +74,7 @@ Numbered Chapters
Numbered chapters can be automatically assigned a number from 1 and upwards. Numbered chapters can be automatically assigned a number from 1 and upwards.
The number is inserted in place of the ``%num%`` tag. The number is inserted in place of the ``%num%`` tag.
Alternatively, the number can be translated to a word by using the ``%numword%`` tag. Alternatively, the number can be translated to a word by using the ``%numword%`` tag.
The word numbers are currently only supported in English, and work for the range from "One" to "Nine Hundred and Ninety-Nine". The word numbers feature is currently only supported in English, and works for the range from "One" to "Nine Hundred and Ninety-Nine".
Unnumbered Chapters Unnumbered Chapters
=================== ===================
docs/source/interface.txt
+63 -47
View File
@@ -22,15 +22,19 @@ The formats are listed below.
In addition to these standard markdown features, the editor also allows for comments, that is text that is ignored by the word counter and not exported or seen in the document viewer. In addition to these standard markdown features, the editor also allows for comments, that is text that is ignored by the word counter and not exported or seen in the document viewer.
The editor also has a minimal set of commands used for setting tags and references between files. The editor also has a minimal set of commands used for setting tags and references between files.
* ``# Title``: Heading level one. The space after the # is mandatory. .. csv-table:: Formatting Syntax
* ``## Title``: Heading level two. The space after the # is mandatory. :header: "Format", "Description"
* ``### Title``: Heading level three. The space after the # is mandatory. :widths: 15, 70
* ``#### Title``: Heading level four. The space after the # is mandatory.
* ``**text**``: The text is renderred as bold text. "``# Title``", "Heading level one. The space after the # is mandatory."
* ``_text_``:The text is renderred as italics text. "``## Title``", "Heading level two. The space after the # is mandatory."
* ``__text__``: The text is renderred as underlined text. "``### Title``", "Heading level three. The space after the # is mandatory."
* ``% text...``: A comment. The text is not exported, seen in viewer, or counted towards word counts. "``#### Title``", "Heading level four. The space after the # is mandatory."
* ``@keyword: value``: A keyword argument followed by a value, or a comma separated list of values. "``**text**``", "The text is renderred as bold text."
"``_text_``", "The text is renderred as italics text."
"``__text__``", "The text is renderred as underlined text."
"``% text...``", "A comment. The text is not exported, seen in viewer, or counted towards word counts."
"``@keyword: value``", "A keyword argument followed by a value, or a comma separated list of values."
****************** ******************
Keyboard Shortcuts Keyboard Shortcuts
@@ -39,41 +43,53 @@ Keyboard Shortcuts
All features are available as keyboard shortcuts. All features are available as keyboard shortcuts.
These are as following: These are as following:
* ``Ctrl+Shift+O``: Open a project. .. csv-table:: Keyboard Shortcuts
* ``Ctrl+Shift+S``: Save the current project. :header: "Shortcut", "Description"
* ``Ctrl+Shift+W``: Close the current project. :widths: 15, 70
* ``Ctrl+Shift+,``: Change project settings.
* ``Ctrl+Shift+N``: Create new folder. ":kbd:`Ctrl-.`", "Correct word under cursor."
* ``Ctrl+E, F2``: If in tree view, edit a document or folder settings. ":kbd:`Ctrl-1`", "Switch focus to tree view pane."
* ``Ctrl+Del``: If in tree view, move a document to trash, or delete a folder. ":kbd:`Ctrl-2`", "Switch focus to document editor pane."
* ``Ctrl+Q``: Exit novelWriter. ":kbd:`Ctrl-3`", "Switch focus to document viewer pane."
* ``Ctrl+N``: Create new document. ":kbd:`Ctrl-A`", "Select all text in document."
* ``Ctrl+O``: Open selected document. ":kbd:`Ctrl-B`", "Format selected text, or word under cursor, as bold."
* ``Return``: If in tree view, open a document for editing. ":kbd:`Ctrl-C`", "Copy selected text to clipboard."
* ``Ctrl+S``: Save the current document in the editor. ":kbd:`Ctrl-D`", "Wrap selected text, or word under cursor, in double quotes."
* ``Ctrl+W``: Close the current document in the editor. ":kbd:`Ctrl-E`", "If in tree view, edit a document or folder settings."
* ``Ctrl+R``: If in tree view, open a document for viewing. If in editor pane, open current document for viewing. ":kbd:`Ctrl-F`", "Open the search bar and search for selected word, if any is selected."
* ``Ctrl+Shift+R``: Close the document view pane. ":kbd:`Ctrl-H`", "Open the search and replace bar and search for selected word, if any is selected."
* ``Ctrl+Z``: Undo latest changes. ":kbd:`Ctrl-I`", "Format selected text, or word under cursor, as italic."
* ``Ctrl+Y``: Redo latest undo. ":kbd:`Ctrl-N`", "Create new document."
* ``Ctrl+C``: Copy selected text to clipboard. ":kbd:`Ctrl-O`", "Open selected document."
* ``Ctrl+X``: Cut selected text to clipboard. ":kbd:`Ctrl-Q`", "Exit novelWriter."
* ``Ctrl+V``: Paste text from clipboard to cursor position. ":kbd:`Ctrl-R`", "If in tree view, open a document for viewing. If in editor pane, open current document for viewing."
* ``Ctrl+A``: Select all text in document. ":kbd:`Ctrl-S`", "Save the current document in the editor."
* ``Ctrl+Shift+A``: Select all text in current paragraph. ":kbd:`Ctrl-T`", "Show project timeline."
* ``Ctrl+1``: Switch focus to tree view pane. ":kbd:`Ctrl-U`", "Format selected text, or word under cursor, as underline."
* ``Ctrl+2``: Switch focus to document editor pane. ":kbd:`Ctrl-V`", "Paste text from clipboard to cursor position."
* ``Ctrl+3``: Switch focus to document viewer pane. ":kbd:`Ctrl-W`", "Close the current document in the editor."
* ``Ctrl+T``: Show project timeline. ":kbd:`Ctrl-X`", "Cut selected text to clipboard."
* ``Ctrl+B``: Format selected text, or word under cursor, as bold. ":kbd:`Ctrl-Y`", "Redo latest undo."
* ``Ctrl+I``: Format selected text, or word under cursor, as italic. ":kbd:`Ctrl-Z`", "Undo latest changes."
* ``Ctrl+U``: Format selected text, or word under cursor, as underline. ":kbd:`Ctrl-F7`", "Toggle spell checking."
* ``Ctrl+D``: Wrap selected text, or word under cursor, in double quotes. ":kbd:`Ctrl-Del`", "If in tree view, move a document to trash, or delete a folder."
* ``Ctrl+Shift+D``: Wrap selected text, or word under cursor, in single quotes. ":kbd:`Ctrl-Shift-,`", "Change project settings."
* ``Ctrl+Shift+Up``: Move item one step up in the tree view. ":kbd:`Ctrl-Shift-1`", "Replace occurrence of word in current document, and search for next occurrence."
* ``Ctrl+Shift+Down``: Move item one step down in the tree view. ":kbd:`Ctrl-Shift-A`", "Select all text in current paragraph."
* ``Ctrl+F7``: Toggle spell checking. ":kbd:`Ctrl-Shift-D`", "Wrap selected text, or word under cursor, in single quotes."
* ``F7``: Re-run spell checker. ":kbd:`Ctrl-Shift-I`", "Import text to the current document from a text file."
* ``Ctrl+.``: Correct word under cursor. ":kbd:`Ctrl-Shift-N`", "Create new folder."
* ``F9``: Re-build project indices. ":kbd:`Ctrl-Shift-O`", "Open a project."
* ``F1``: Open documentation. ":kbd:`Ctrl-Shift-R`", "Close the document view pane."
":kbd:`Ctrl-Shift-S`", "Save the current project."
":kbd:`Ctrl-Shift-W`", "Close the current project."
":kbd:`Ctrl-Shift-Up`", "Move item one step up in the tree view."
":kbd:`Ctrl-Shift-Down`", "Move item one step down in the tree view."
":kbd:`F1`", "Open documentation."
":kbd:`F2`", "Alternative to :kbd:`Ctrl-E`."
":kbd:`F3`", "Find next occurrence of word in current document."
":kbd:`F5`", "Export project dialog."
":kbd:`F7`", "Re-run spell checker."
":kbd:`F9`", "Re-build project indices."
":kbd:`Shift-F3`", "Find previous occurrence of word in current document."
":kbd:`Return`", "If in tree view, open a document for editing."
docs/source/introduction.txt
+2 -2
View File
@@ -1,6 +1,6 @@
############
Introduction Introduction
============ ############
novelWriter is a simple multi-document plain text editor using a modified novelWriter is a simple multi-document plain text editor using a modified
markdown syntax to apply simple formatting. Additional features are available markdown syntax to apply simple formatting. Additional features are available
docs/source/notes.txt
+4 -2
View File
@@ -1,12 +1,14 @@
########################
Supporting Files (Notes) Supporting Files (Notes)
======================== ########################
Supporting files, or notes, are any files stored in root folders that are not the Novel root folder. Supporting files, or notes, are any files stored in root folders that are not the Novel root folder.
These files are intended for summaries and outlines of the various plot elements, characters, locations, and so on, of the novel. These files are intended for summaries and outlines of the various plot elements, characters, locations, and so on, of the novel.
These are not required, but making at least minimal files for each such element makes it possible to use the timeline view feature to see how each element intersects with each section of the novel itself. These are not required, but making at least minimal files for each such element makes it possible to use the timeline view feature to see how each element intersects with each section of the novel itself.
*********
File Tags File Tags
^^^^^^^^^ *********
Each note file can have a tag associated with it, Each note file can have a tag associated with it,
The format of a tag is ``@tag: tagname``, where tagname is a unique identifier. The format of a tag is ``@tag: tagname``, where tagname is a unique identifier.
docs/source/projects.txt
+15 -10
View File
@@ -1,5 +1,6 @@
##############
Novel Projects Novel Projects
============== ##############
A novelWriter project requires a dedicated folder for storing its files. A novelWriter project requires a dedicated folder for storing its files.
See the Technical Information section for further details. See the Technical Information section for further details.
@@ -10,8 +11,9 @@ A list of recently opened projects is also maintained and can be selected from t
The project specific settings are available in :menuselection:`Project --> Project Settings`. The project specific settings are available in :menuselection:`Project --> Project Settings`.
See further details below. See further details below.
*****************
Project Structure Project Structure
^^^^^^^^^^^^^^^^^ *****************
Projects are structured into a set of root folders, visible in the left side tree view panel. Projects are structured into a set of root folders, visible in the left side tree view panel.
@@ -36,7 +38,7 @@ Deleted files will be moved into a special "Trash" root folder.
Currently, these files cannot be permanently deleted from the project. Currently, these files cannot be permanently deleted from the project.
Orphaned Documents Orphaned Documents
~~~~~~~~~~~~~~~~~~ ==================
In the event the editor crashes or otherwise exits without saving the project state, files that have been added to the project tree and are saved to disk will appear in a special "Orphaned Items" root folder next time the application is started. In the event the editor crashes or otherwise exits without saving the project state, files that have been added to the project tree and are saved to disk will appear in a special "Orphaned Items" root folder next time the application is started.
These orphaned files will not have any meta data associated with them, so the title and other information has to be set again, and the files moved back to the correct location in the project. These orphaned files will not have any meta data associated with them, so the title and other information has to be set again, and the files moved back to the correct location in the project.
@@ -44,14 +46,15 @@ Using Project Folders
Folders, aside from root folders, have no structural significance to the project. They are there purely as a way for the user to organise the files in meaningful sections and to be able to close them in the tree view. When processing the files in the novel, the folders are ignored. Folders, aside from root folders, have no structural significance to the project. They are there purely as a way for the user to organise the files in meaningful sections and to be able to close them in the tree view. When processing the files in the novel, the folders are ignored.
****************
Project Settings Project Settings
^^^^^^^^^^^^^^^^ ****************
The project settings can be accessed from the :menuselection:`Project --> Project Settings` menu entry. The project settings can be accessed from the :menuselection:`Project --> Project Settings` menu entry.
This will open a dialog box. This will open a dialog box.
Settings Tab Settings Tab
~~~~~~~~~~~~ ============
The Settings tab holds the project title and author settings. The Settings tab holds the project title and author settings.
Working Title can be set to a different title than the Book Title. Working Title can be set to a different title than the Book Title.
@@ -62,7 +65,7 @@ The Book Authors text box takes one author per line.
The line breaks matter in that this is converted to a list for later correct formatting. The line breaks matter in that this is converted to a list for later correct formatting.
Status Tab Status Tab
~~~~~~~~~~ ==========
Each file of type NOVEL can be given a status level, signified by a coloured icon. Each file of type NOVEL can be given a status level, signified by a coloured icon.
These are purely there for the user's convenience, and you are not required to use them for any other feature to work. These are purely there for the user's convenience, and you are not required to use them for any other feature to work.
@@ -71,7 +74,7 @@ The intention is to use this list to set what stage of writing you are on, altho
Note that status levels currently in use by a file cannot be deleted. Note that status levels currently in use by a file cannot be deleted.
Importance Tab Importance Tab
~~~~~~~~~~~~~~ ==============
Each file of types PLOT, CHARACTER, WORLD, TIMELINE, OBJECT or CUSTOM can be given an importance level, signified by a coloured icon like for status level. Each file of types PLOT, CHARACTER, WORLD, TIMELINE, OBJECT or CUSTOM can be given an importance level, signified by a coloured icon like for status level.
These are also purely there for the user's convenience, and you are not required to use them for any other feature to work. These are also purely there for the user's convenience, and you are not required to use them for any other feature to work.
@@ -81,7 +84,7 @@ Again, these can in principle be used for whatever you want.
Note that importance levels currently in use by a file cannot be deleted. Note that importance levels currently in use by a file cannot be deleted.
Auto-Replace Tab Auto-Replace Tab
~~~~~~~~~~~~~~~~ ================
A set of automatically replaced keywords can be added in this tab. A set of automatically replaced keywords can be added in this tab.
The keywords in the left column wile be replaced by the text in the right column when documents are opened in the viewer. The keywords in the left column wile be replaced by the text in the right column when documents are opened in the viewer.
@@ -91,8 +94,9 @@ Note that a keyword cannot contain any spaces.
The angle brackets are added by default, and when used in the text are a part of the keyword to be replaced. The angle brackets are added by default, and when used in the text are a part of the keyword to be replaced.
This is to ensure that parts of the text isn't unintentionally replaced by the content of the list. This is to ensure that parts of the text isn't unintentionally replaced by the content of the list.
*************
Writing Files Writing Files
^^^^^^^^^^^^^ *************
New document files can be created from the Document menu, or by pressing Ctrl+N while in the tree view pane. New document files can be created from the Document menu, or by pressing Ctrl+N while in the tree view pane.
This will create a new, empty file, and open the item settings dialog where the filename and various other settings can be set. This will create a new, empty file, and open the item settings dialog where the filename and various other settings can be set.
@@ -100,8 +104,9 @@ This dialog can also be opened again later from either the menu, :menuselection:
The different classes of documents have some restrictions. The different classes of documents have some restrictions.
******
Backup Backup
^^^^^^ ******
An automatic backup system is built into novelWriter. An automatic backup system is built into novelWriter.
In order to use it, a backup path to where the backups are to be stored needs to be provided in :menuselection:`Tools --> Preferences`. In order to use it, a backup path to where the backups are to be stored needs to be provided in :menuselection:`Tools --> Preferences`.
docs/source/structure.txt
+8 -5
View File
@@ -1,12 +1,13 @@
#################
Project Structure Project Structure
================= #################
This section concerns files under the Novel type root folder. This section concerns files under the Novel type root folder.
There are some restrictions and features that only applies to these type of files. There are some restrictions and features that only applies to these type of files.
**********************
Importance of Headings Importance of Headings
^^^^^^^^^^^^^^^^^^^^^^ **********************
Subfolders under root folders have no impact on the structure of the novel itself. Subfolders under root folders have no impact on the structure of the novel itself.
The structure is instead dictated by the heading level. The structure is instead dictated by the heading level.
@@ -23,8 +24,9 @@ The different header levels are interpreted as specific section types of the nov
* ``### Header3``: Header level 3 signifies a scene level partition. * ``### Header3``: Header level 3 signifies a scene level partition.
* ``#### Header4``: Header level 4 signifies a sub-scene level partition. * ``#### Header4``: Header level 4 signifies a sub-scene level partition.
**************
Tag References Tag References
^^^^^^^^^^^^^^ **************
Each section, indicated by a heading, can contain references to tags set in the supporting files of the project. Each section, indicated by a heading, can contain references to tags set in the supporting files of the project.
See the File Tags section. See the File Tags section.
@@ -62,8 +64,9 @@ the syntax highlighter will alert the user that only the correct keywords are us
If the index of defined tags is out of date, press F9 to regenerate it, or select :menuselection:`Tools --> Rebuild Indices` from the menu. If the index of defined tags is out of date, press F9 to regenerate it, or select :menuselection:`Tools --> Rebuild Indices` from the menu.
In general, the index for a file is regenerated when a file is saved, so this shouldn't normally be necessary. In general, the index for a file is regenerated when a file is saved, so this shouldn't normally be necessary.
*****************
Novel File Layout Novel File Layout
^^^^^^^^^^^^^^^^^ *****************
Files that exist under the NOVEL type root folder can have a number of layouts set. Files that exist under the NOVEL type root folder can have a number of layouts set.
See overview below. See overview below.
docs/source/technical.txt
+6 -5
View File
@@ -1,14 +1,15 @@
#####################
Technical Information Technical Information
===================== #####################
This section contains details of how novelWriter stores and handles the project data. This section contains details of how novelWriter stores and handles the project data.
******************
How Data is Stored How Data is Stored
^^^^^^^^^^^^^^^^^^ ******************
Main Project File Main Project File
~~~~~~~~~~~~~~~~~ =================
The project itself requires a dedicated folder for storing its files. The project itself requires a dedicated folder for storing its files.
The main project file is stored as an XML file with the name ``nwProject.nwx``. The main project file is stored as an XML file with the name ``nwProject.nwx``.
@@ -21,7 +22,7 @@ It is important to keep this file backed up.
The project XML file is suitable for diff tools and version control, although a timesetamp is set in the meta section on line 2 each time the file is saved. The project XML file is suitable for diff tools and version control, although a timesetamp is set in the meta section on line 2 each time the file is saved.
Project Documents Project Documents
~~~~~~~~~~~~~~~~~ =================
The project documents are saved in folders staring with ``data_``. The project documents are saved in folders staring with ``data_``.
Each document has a file handle taken from the first 13 characters of a SHA256 hash of the system time. Each document has a file handle taken from the first 13 characters of a SHA256 hash of the system time.