.. include:: /_static/inc_styles.txt .. index:: release notes Release Notes ============= .. contents:: :local: :depth: 2 ----- .. _about_release_3.0: 3.0 ^^^ USFM 3.0 additions or revisions are highlighted throughout this documentation using the badge |badge_3.0| *April 2018* **Marker Additions** * USFM version identifier: :ref:`\\usfm ` * Alternate language table of contents texts: :ref:`\\toca# ` * List of witnesses in footnotes (for crtical editions): :ref:`\\fw ...\\fw* ` * Target references "added" text: :ref:`\\xta ...\\xta* ` * Superscript: :ref:`\\sup ...\\sup* ` * Translator's section (chunk) milestones: :ref:`\\ts-s\\* and \\ts-e\\* ` **Marker Revisions** * Revised syntax for ruby glosses (CJK texts): :ref:`\\rb ...\\rb\* ` * Add :doc:`descriptive attribute ` ``gloss`` for :ref:`\\rb ...\\rb\* ` * Added default ``link-href`` :doc:`linking attribute ` for :ref:`\\xt ...\\xt\* ` * Changed common :ref:`attributes for milestones `: * Replace single ``id`` with separate start ``sid`` and end ``eid`` milestone attributes. |br| This update aligns USFM with the corresponding single ` `_ milestone element in USX, where the ``id`` attrubute content would not be unique for ` `_. * Changed name of :doc:`linking attribute ` ``link-name`` to ``link-id``. * *Restored* :ref:`\\pr ` for use as "text refrain". **Syntax and Features** * Clarify and support syntax for :ref:`standalone milestones `. * Document best practice for attributes containing :ref:`multiple values `, or :ref:`multiple parts ` (see the ``gloss`` attribute for :ref:`\\rb ...\\rb\* `) .. _about_release_3.0rc1: 3.0rc1 ^^^^^^ *October 2016* **Marker Additions** * Letter opening: :ref:`\\po ` * List header and footer elements: :ref:`\\lh ` and :ref:`\\lf ` * Embedded list: :ref:`\\lim# ` * Hebrew note: :ref:`\\qd ` * Semantic division: :ref:`\\sd# ` * Aramaic wordlist entry: :ref:`\\wa ...\\wa\* ` * Geographic proper name (Chinese texts): :ref:`\\png ...\\png\* ` * Target references "added" text: :ref:`\\xta ...\\xta\* ` * Published cross reference origin text: :ref:`\\xop ...\\xop\* ` * Structured list items: :ref:`\\lik ...\\lik\* ` and :ref:`\\liv# ...\\liv#\* ` * List item total: :ref:`\\litl ...\\litl\* ` * Link text: :ref:`\\jmp ...\\jmp\* ` * Common peripheral :ref:`identifiers ` * Ruby glosses (CJK texts): :ref:`\\rb ...\\rb\* ` * Quotation start / end milestones: :ref:`\\qt#-s\\* and \\qt#-e\\* ` **Marker Revisions** * Support citation form for wordlist / glossary text (update :ref:`\\w ...\\w\* `). * Support for explicit :ref:`table cell ` column :ref:`spanning `. * Revised syntax for figures / illustrations applying descriptive :doc:`attributes `: :ref:`\\fig ...\\fig\* ` * *Deprecated* cross reference and footnote DC content markers: :ref:`\\xdc ...\\xdc\* ` and :ref:`\\fdc ...\\fdc\* ` * *Deprecated* combined marker for proper name within translator's addition: :ref:`\\addpn ...\\addpn\* ` * *Deprecated* numbered running header: :ref:`\\h# ` * *Deprecated* pronunciation info marker: :ref:`\\pro ...\\pro\* ` in favour of :ref:`ruby annotations ` proposal. **Syntax and Features** * Syntax for assigning word-level :doc:`descriptive attributes `. - Descriptive attributes for :ref:`\\w ...\\w\* ` - Descriptive attributes for :ref:`\\fig ...\\fig\* ` * Syntax for assigning word-level :doc:`linking attributes `. * Syntax for :doc:`milestones `. - Quotation start / end milestones: :ref:`\\qt#-s\\* and \\qt#-e\\* `. * Syntax for peripheral (:doc:`\\periph `) :ref:`identifiers `. **Standard Reference** * Clarify and document specification regarding :ref:`whitespace ` and :ref:`new lines `. .. _about_release_2.5: 2.5 ^^^ *October 2013* Validation (stylesheet) configuration update for ParaTExt 7.5 release. .. _about_release_2.4: 2.4 ^^^ *June 2013* **Marker Additions** * Support for :doc:`nesting character markup `. Full support for the nested character markup syntax has been included in Paratext >=7.4, Publishing Assistant >=4.1, and the XML export format from Paratext known as "USX". .. _about_release_2.35: 2.35 ^^^^ *February 2012* Primarily a documentation update. Paratext 7.3 and beyond provides support for study Bible content authoring, within a single project text, through an enhanced multi-pane editing window. Earlier USFM documentation releases discussed study Bible content markup using one or two additional related project texts. This multi-project authoring configuration is no longer recommended now that there is workable authoring environment supporting a single-project study Bible text. Information relating to study Bible content markup and authoring practice in this documentation supersedes any reference to separate notes or sidebar projects in the earlier release notes (below). * Deprecated ``\fs`` (footnote summary text) - not required when working within a single project study Bible text. .. _about_release_2.3: 2.3 ^^^ *July 2010* Version numbers for the base USFM stylesheet and the study Bible notes and sidebars stylesheets have been synchronized to 2.3. This reflects the readiness of the ParaTExt 7.1 editor to support study Bible authoring. **Marker Additions** * Added study Bible cross reference marker :ref:`\\ex ` for adding additional cross-references to the notes project. **Marker Revisions** * *DEPRECATED* - Study Bible footnote marker ``\fs`` for marking a footnote summary text. * Permit cross references to be added to the study Bible notes project. * Revised markup specification for study Bible sidebars (now use any title, paragraph, poetry, table, or special text marker elements). .. _about_release_2.2: 2.2 ^^^ *October 2008* **Marker Additions** * Added character markers :ref:`\\xot ...\\xot\* ` and :ref:`\\xnt ...\\xnt\* ` for uniquely marking target references to OT and NT passages (use of these markers is optional) * Added :ref:`\\iqt ...\\iqt\* ` to mark (scripture) quotations appearing in the introduction. **Marker Revisions** * :ref:`\\imte# ` now includes an optional numeric variable (multiple levels). * No-break space should now be marked using ~ (tilde), not !$ .. _about_release_2.1: 2.1 ^^^ *April 2007* **Marker Additions** * Added :ref:`\\ili ` for marking introduction list items. * Reviewed and finalized Peripheral content markup: - Added new :doc:`back matter ` books CNC, GLO, TDX, NDX. - Added INT book for scripture division :doc:`Introductions `. - Updated scheme for marking content divisions in FRT, INT, BAK, OTH - Added various new content division markers. **Marker Revisions** * Finalized :doc:`Study Bible Content ` markup. * Reviewed and finalized Peripheral content markup (see "Marker Additions" above). * Changed :ref:`\\rq ...\\rq\* ` from paragraph to character level markup. * Changed :ref:`\\ca ...\\ca\* ` from paragraph to character level markup. .. _about_release_2.05: 2.05 ^^^^ *June 2006* **Marker Additions** * Added :ref:`\\rq ` for marking inline quotation references. .. _about_release_2.04: 2.04 ^^^^ *October 2005* **Marker Additions** * Added :ref:`\\toc3 ` for providing the standard abbreviation for a book. .. _about_release_2.03: 2.03 ^^^^ *August 2005* **Marker Additions** * Added :ref:`\\toc1 ` and :ref:`\\toc2 ` for providing and marking long and short table of contents texts. * Added :ref:`\\fl ` for marking footnote "label" text items. * Added :ref:`\\fp ` for marking footnote additional paragraphs. .. _about_release_2.0: 2.0 ^^^ *October 2004* The following sections outline changes in USFM from 1.53 to 2.0. **Marker Revisions** * Removed ``\pdi`` and ``\pde``, and substitute with embedded text markup (under additions, below) * Removed ``\wr ...\wr*``. This was really a duplicate of :ref:`\\w ...\w\* ` used for marking words in the scripture text which are included in the wordlist. * Removed ``\ps``. This is used in conjunction with :ref:`\\nb ` to indicate that the paragraph spans the chapter boundary. It should be sufficient to just start the new chapter with :ref:`\\nb ` and use the appropriate paragraph marker for the previous chapter (:ref:`\\p `, :ref:`\\m ` etc.) **Marker Additions** * Add character style :ref:`\\em ...\\em\* ` for "emphasis". * In Peripherals: - Add \\intro section to Front Matter (in addition to Preface). - Add \\maps (Maps Index) section to Back Matter. - Paratext will be adjusted to include predefined "standard" books for FRT, BAK, and OTH rather than using the book names XXA, XXB, and XXC for these materials. * Add :ref:`\\sr ` for marking the text references range listed under a section heading :ref:`\\s `. * Add the following markers for "embedded text" (see example references – not all versions mark these items the same). - :ref:`\\pm ` - Embedded text paragraph - :ref:`\\pmo ` - Embedded text opening - :ref:`\\pmc ` - Embedded text closing - :ref:`\\pmr ` - Embedded text refrain - :ref:`\\qm# ` - Embedded text poetic line * Add character style :ref:`\\pro ...\\pro\* ` for indicating pronunciation (in CJK texts). * Add character style :ref:`\\wj ...\\wj\* ` for marking words of Jesus.