Project homepage > Index > User guide
The novx_xtg Python script runs through all chapters and sections of a novelibre project and fills XTG templates.
The included installation script prompts you to create a shortcut on the desktop. You can launch the program by dragging a novelibre project file and dropping it on the shortcut icon.
Alternatively, you can
usage: novx_xtg.py [--silent] Sourcefile
Sourcefile
The path of the novelibre project file.
--silent suppress error messages and the request to confirm the use of
default values
The XTG file format uses the XPress Tags language, the knowledge of which is assumed. You canownload the manual A Guide to XPress Tags for your program version from the Quark web site.
Bold and italics are supported. Other highlighting such as underline and strikethrough are lost.
It is assumed that quotation marks and punctuation marks are already set correctly; this is best done in advance with a word processor, e.g. via novelibre’s “proof read” function.
c:Users\<user name\>.novx\novx_xtg\config is used
prior to the script’s default configuration data.Hint
You find the a sample configuration folder with templates and the novx_xtg default values in the novelibre installation directory under
c:\Users\<user name>\.novx\novx_xtg\sample\
You best make a copy and edit it.
This is the configuration file explained:
[STYLES]
first_paragraph = @Text body:
# XPress tag for paragraphs preceded by a heading or a blank line.
indented_paragraph = @Text body indent:
# XPress tag for indented paragraphs.
other_paragraph = @First line indent:
# XPress tag for regular paragraphs.
italic = <@Emphasis>
# XPress tag opening italic sections.
italic0 = <@$p>
# XPress tag closing italic sections.
bold = <@Strong emphasis>
# XPress tag opening bold sections.
bold0 = <@$p>
# XPress tag closing bold sections.
acronym =
# XPress tag opening acronyms.
acronym0 =
# XPress tag closing acronyms.
figure =
# XPress tag opening figure groups.
figure0 =
# XPress tag closing figure groups.
[OPTIONS]
adjust_digits = Yes
# If Yes, adjust digit-separating blanks.
space_points = Yes
# If Yes, space digit-separating points.
per_chapter = No
# If Yes, create one XTG file for each chapter.
# If No, create one XTG file for the entire document.
textbody - The QX paragraph style applied to all paragraphs in a
section, except the first. The first paragraph’s style can be set
in the section level templates.italic - The opening tag to replace novelibre’s italic
formatting.italic0 - The closing tag to replace novelibre’s italic
formatting.bold - The opening tag to replace novelibre’s bold formatting.bold0 - The closing tag to replace novelibre’s bold formatting.acronym - The opening tag to format sequences of uppercase
characters (e.g. set a slightly smaller font size).acronym0 - The closing tag to format sequences of uppercase
characters.figure - The opening tag to format figures (e.g. switch the font
to get “osf” text figures).figure0 - The closing tag to format figures.adjust_digits - Replace regular spaces between digits with thin
spaces.space_points - Insert a thin space after each point that separates
digits.per_chapter - Generate one XTG file per chapter. The file names
consist of the chapter’s number and title. the files are written to
the XTG_Chapters subdirectory.You can define styles in fileHeader.XTG, but it is preferable to use
the names of styles that already exist in the QX book project instead.
fileHeader.XTG - This template must contain at least the version
code and encoding indication.partTemplate.XTG - Chapter header; applied to chapters marked
“section beginning”.chapterTemplate.XTG - Chapter header; applied to all “used” and
“normal” chapters unless a “part template” exists.firstSectionTemplate.XTG - Applied to sections at the beginning of
the chapter.sectionTemplate.XTG - Applied to “used” sections within
“normal” chapters.sectionDivider.XTG - Section divider placed between sections.appendedSectionTemplate.XTG - Applied to sections to be appended
to the previous section.There are two options:
$Placeholder - If the placeholder is followed by a character that
is clearly recognizable as a separator, e.g. a blank.${Placeholder} - If the placeholder is followed by a character
that is not recognizable as a separator.$Title - Project title$Desc - Project description$AuthorName - Author’s name$Language - Language code acc. to ISO 639-1$Country - Country code acc. to ISO 3166-2$CustomPlotProgress - Custom “Plot progress” field title$CustomCharacterization - Custom “Characterization” field title$CustomWorldBuilding - Custom “World building” field title$CustomGoal - Custom “Goal” field title$CustomConflict - Custom “Conflict” field title$CustomOutcome - Custom “Outcome” field title$CustomChrBio - Custom character “Bio” field title$CustomChrGoals - Custom character “Goals” field title$ID - Chapter ID,$ChapterNumber - Chapter number (in sort order),$Title - Chapter title$Desc - Chapter description$Epigraph - Epigraph$EpigraphSrc - Epigraph source$Notes - Chapter notes$ProjectName - URL-coded file name without suffix and extension$ProjectPath - URL-coded fpath to the project directory$Language - Language code acc. to ISO 639-1$Country - Country code acc. to ISO 3166-2$ManuscriptSuffix - File name suffix of the manuscript$ID - Section ID,$SectionNumber - Section number (in sort order),$Title - Section title$Desc - Section description$WordCount - Section word count$WordsTotal - Accumulated word count including the current section$Status - Section status (Outline, Draft etc.)$SectionContent - Section content$Date - Specific section date (YYYY-MM-DD)$Time - Time section begins: (hh:mm)$OdsTime - Time section begins: (PThhHmmMssS)$Day - Day section begins$ScDate - Date or day (localized)$DateYear - Year$DateMonth - Month (number)$DateDay - Day (number)$DateWeekday - Day of the week (name)$MonthName - Month (name)$LastsDays - Amount of time section lasts: days$LastsHours - Amount of time section lasts: hours$LastsMinutes - Amount of time section lasts: minutesDuration - Combination of days and hours and minutes$Scene - The sections’s kind of scene, if any$Goal - The section protagonist’s goal$Conflict - The section conflict$Outcome - The section outcome$Tags - Comma-separated list of section tags$Characters - Comma-separated list of characters assigned to the
section$Viewpoint - Viewpoint character$Locations - Comma-separated list of locations assigned to the
section$Items - Comma-separated list of items assigned to the section$Notes - Section notes$ProjectName - URL-coded file name without suffix and extension$ProjectPath - URL-coded fpath to the project directory$Language - Language code acc. to ISO 639-1$Country - Country code acc. to ISO 3166-2$ManuscriptSuffix - File name suffix of the manuscript$SectionsSuffix - File name suffix of the section descriptions$CustomPlotProgress - Custom “Plot progress” field title$CustomCharacterization - Custom “Characterization” field title$CustomWorldBuilding - Custom “World building” field title$CustomGoal - Custom “Goal” field title$CustomConflict - Custom “Conflict” field title$CustomOutcome - Custom “Outcome” field titleThe setup script installs novx_xtg.py in a defined place. This is the installation path on Windows:
c:\Users\<user name>.novx\novx_xtg
Copyright (c) 2025 by Peter Triesberger. All rights reserved.