How saga-soft/novelwriter works
novelWriter is a Qt desktop application for composing novels from organized plain-text documents and notes. The principal workflow is to create or open a project, organize its items, edit documents with novelWriter’s lightweight syntax, and build a manuscript in an output format. Project metadata, search, story outlining, and writing statistics support that workflow. The graph preserves documented capabilities, but unsampled modules are represented only at subsystem level; the available excerpts do not establish every runtime connection.
Main entry points: guimain.py Main window · project.py Project model · search.py Project search · editor.py Document editor
Components 21
Project workspace
- Application startup
novelwriter/__init__.py - Main window
novelwriter/guimain.py - Project tree
novelwriter/gui/projtree.py - Project search
novelwriter/gui/search.py
Writing and structure
- Document editor
novelwriter/editor/editor.py - Document model
novelwriter/core/document.py - Text syntax
novelwriter/text/formats.py - Story outline
novelwriter/story/outline.py - Story view
novelwriter/story/storyview.py
Project services
- Project model
novelwriter/core/project.py - Project storage
novelwriter/core/storage.py - Project items
novelwriter/core/item.py - Search engine
novelwriter/core/projectsearch.py - Search results
novelwriter/models/searchmodel.py - Project index
novelwriter/core/index.py - Writing statistics
novelwriter/tools/writingstats.py
Manuscript output
- Manuscript settings
novelwriter/manuscript/manuscript.py - Manuscript builder
novelwriter/manuscript/manusbuild.py - Document builder
novelwriter/manuscript/docbuild.py - Export formats
novelwriter/formats/tohtml.py
Other components
- Writer
Connections 24
- Writer → Application startup: launches
novelwriter/__init__.py - Application startup → Main window: starts
novelwriter/__init__.py - Writer → Main window: uses
README.md - Main window → Project tree: shows
novelwriter/guimain.py - Main window → Document editor: opens
novelwriter/guimain.py - Main window → Project model: manages
- Project tree → Project items: uses
novelwriter/gui/projtree.py - Project items → Project model: belongs to
novelwriter/core/item.py - Project model → Project storage: persists through
novelwriter/core/storage.py - Document editor → Document model: edits
novelwriter/editor/editor.py - Document editor → Text syntax: uses
novelwriter/editor/editor.py - Writer → Story outline: organizes story
README.md - Story outline → Story view: displays
novelwriter/story/outline.py - Main window → Project search: provides
novelwriter/guimain.py - Project search → Search engine: searches with
novelwriter/gui/search.py - Project search → Search results: populates
novelwriter/gui/search.py - Search engine → Project items: searches
novelwriter/core/projectsearch.py - Project model → Project index: indexes
novelwriter/core/index.py - Writer → Writing statistics: tracks writing
README.md - Main window → Manuscript settings: opens
novelwriter/guimain.py - Manuscript settings → Manuscript builder: configures
novelwriter/manuscript/manuscript.py - Manuscript builder → Document builder: builds documents
novelwriter/manuscript/manuscript.py - Document builder → Export formats: exports to
- Manuscript builder → Project index: uses project index