Pathway 1.15.3
November 30, 2016 

Prerequisites
•	(The bootstrap program will install necessary software but not update Libre Office settings.)
•	Pathway should be working with the latest version of Libre Office but was last tested with version 4.3.1.2 (http://www.libreoffice.org/download) and although version 3.6.5 (http://www.oldapps.com/libreoffice.php?old_libreoffice=11815?download) will work as well.
•	In Libre Office, use Tools, Options, Security, Macro Security to set the security level to medium.
•	In Libre Office, use Tools, Options, Languages and set CTL font support of you are in a region with right-to-left writing systems (use Asian if you need those writing systems). See help for more explanation.
•	Pathway can have problems if old versions are not removed. Some users have had two old versions and have had very unusual problems. You can go to the Windows Control Panel and look for Programs (or Add / Remove Programs on Windows XP) to check if old versions of Pathway are installed. If you find them, you will want to uninstall each of them and then reinstall the latest version.
•	PDF reader (either Adobe http://get.adobe.com/reader/ or PdfXChange http://www.tracker-software.com/product/pdf-xchange-viewer)
•	The Java JDK (http://www.oracle.com/technetwork/java/javase/downloads) is required for some outputs (Dictionary for Mids and Go Bible for example). It is also used to add the copyright and license to PDF files.

Process Notes
•	In Fieldworks, use Format, Styles, Normal, Font to set a default font for each writing system. Then use Tools -> Configure Dictionary to set the fonts, sizes, styles, characters before and after fields, and field order. From the Lexicon view of the Lexicon, make sure the data is sorted by the headword field and that any filters have been applied so the data that appears in the dictionary view is actually the data to print.
•	The conversion allows the user to customize the process. One solution is to add an XSLT (1.0) file to the Program Files\SIL\pathway7\Styles\Preprocessing folder. Another method uses a folder called ‘Process’ that is a sibling of where the exported file will be. In that folder it looks for a batch file called BeforePwConvert.bat. This file is passed the name of the file exported from Flex. The user can write a script to be executed on the file as long as the result remains valid XHTML, the conversion will process it.

Work arounds
•	The OdtXslt program is available at http://pathway.sil.org/wp-content/sprint/SetupOdtXslt-1.13.msi. It will apply a transformation inside the resulting LibreOffice output or Epub.
•	If you want to have the first header guide word on the page to be the first entry on the page instead of the entry that spans the page break, the procedure is written up here: http://pathway.sil.org/making-header-guide-words-the-first-entry-headword-in-libre-office/.
•	In order to hyphenate the Libre Office output, a separate hyphenation dictionary will need to be installed. Those hyphenation dictionaries are available here: http://extensions.services.openoffice.org/dictionary.  
•	It is possible to put the guide words into the header in multiple writing systems. Create a separate field with the headword and position it after the normal headword. Set the writing system so that it looks correct in the Language Explorer preview. Then after exporting, Press F11 and click on the second icon in the style dialog tool bar. This is the one that displays the list of character styles. Now click into the second headword and make. The style name for this headword will be highlighted in the style dialog. Right click on it and choose Modify. Then change the name so that it begins with “headword_”
•	There is a SetupMsWordExport.msi available at http://pathway.sil.org/wp-content/sprint/SetupmsWordExport-1.4.msi. It will take the XHTML export from Flex and open it in Word.
•	In Word, you can create a header using the StyleRef field code. StyleRef is covered in the Word help file.
•	If the line spacing varies and you would like to lock it down, you can use the –ps-fixed-line-height property to specify the line height.
•	If the embedded spans feature is selected, the snippet may need to be edited to change the language codes to those valid for your project.
•	Try breaking long documents into pieces (by letters or every two letters). 
•	We have provided a check box to allow the styles to be “hard coded” rather than using the style sheet. Generally this is undesirable but if Libre Office is crashing (which is very rare with the latest version), checking this box may prevent the crash.
•	When exporting to Pathway from Paratext, any introductory text that occurs before an introductory section heading marker (\is#) will be lost in the conversion process. To address this issue, place an introductory section heading marker (\is#) immediately after any major title lines. For example:
\h Luke
\toc1 The Gospel according to Luke
\toc2 Luke
\mt2 The Gospel
\mt3 according to
\mt1 LUKE
\is Introduction
\ip This is an introduction paragraph for \bk The Gospel according to LUKE\bk*.

Known issues
•	Issues identified by test team, Dictionary for MIDs Reversal, Provide Student Manual and more help online.
•	Spanning Scripture chapter headers won’t show up in the Preview created by PrinceXml. If you uninstall PrinceXml, LibreOffice will be used to create the Preview and spanning headers will show up.
•	Libre Office will not allow dashed borders
•	Libre Office cannot balance double column text when footnotes are on the bottom of the page.
•	Libre Office has a different list of styles for character styles and paragraph styles. Different kinds of styles (paragraph, character, frame, page, and list) are selected on the tool bar. Word puts all the styles in one list. 
•	The ability to add extra space between words (the css word-spacing feature) does not exist in Libre Office.

Recent Changes
•	11/30/2016 split out a process to avoid memory errors, use .net 4.6.1, nuGet packages, epubcheck 4.0.1
•	6/24/2016 changes to support Flex 8.3 and Linux 16.04 (xenial)
•	4/29/2016 hot fix to retain space after etymology and usage
•	4/22/2016 hot fix to include Sword builder files on Windows
•	3/18/2016 stable release including SE fix, remembering settings, avoid header conflicts, letter header style
•	2/22/2016 Mexico style sheet, update Linux build and Windows packaging, Update CSS parser for Fw8.3, page number position, misc bugs.
•	12/11/2015 Add Sword export, Add special style for Mexico including title centered in header and special page size. Update installer to Wix3.
•	8/26/2015 Upgrade Pathway to use latest L10nSharp, add French and Tamil localizations, enable hyphenation in Libre Office, Begin update for embedded styles, fix TOC logic in XeLaTeX
•	6/12/2015 remove registered trade mark symbols from package description
•	6/10/2015 update localization to L10NSharp, add partial French localization, update font embedding
•	9/12/2014 adjustments to recent output
•	9/9/2014 Add glossary linking to E-pub and theWord/MySword. Fix End note and References logic. Bug fixes and user interface adjustments.
•	8/11/2104 Hotfix for Scripture content missing if id line blank
•	8/6/2014 Epub3 output, Implement MySword conversion on Linux
•	5/22/2014 Support spanning Scripture headers, Fix picture formatting, Support Go Bible partial books, Upgrade to XeLaTeX that uses TeX Live 2013, Add reset to tool bar, various improvements and fixes
•	3/14/2014 Primarily a bug fix release after testing by the test team. Particular focus has been given to stabilizing Libre Office and Epub outputs. theWord / MySword now hyperlink parallel references.
•	1/13/2014 Handle out of memory errors, and picture placement. Remove extra spaces inserted in reversal. Handle very long guide words. Update for 4.1.x version of Libre office. Adjust theWord for formatting errors. Fix XeLaTeX export ramp package. Add prototype for Sword export.
•	11/8/2013 The key changes in this sprint were to add the creation of Reap archive packages, including      checking the rights statements and cleaning up the folder. theWord/MySword output was also added in this sprint. We also moved the repo to a new location on github.
•	8/20/2013 The main feature is inserting copyright and license information into PDF files. We have also updated the SIL logo and provide support for PrinceXml 9.0. Many bug fixes and improvements.
•	6/21/2013 Handle many out of memory cases, move InDesign to test release, address issues identified by test team, add DictionaryForMIDs export to test release
•	5/22/2013 Working toward a stable release: handle //, line breaks, different footnote and cross reference callers, minor entry guide words, quotation indentation. Fix logo and edge case crashes.
•	2/20/2013 Added reference format topic to help, In Linux, fix icon on menu, associate epub type, create registry key, Fix error boxes, Improve picture formatting, hard page break, quote indents 1-4, end note reference format, caption format, embedded quote conversion, picture removal on epub, Java search, page size, fix picture formatting, closing quotes, table processing, header processing, footnote callers
•	11/12/2012 Process USFM from pathwayB, reset settings when started with shift down, front matter and header formatting, style sheet and user interface fixes.
•	10/24/2012 Update help topics on Kindle output, Remove gsdll32.dll and modify preview, Fix Help Improve logic, Fix Libre Office column balance, pictures, page number, TOC, Page breaks, footnotes, Fix E-book rights page, out of memory, Book title, chapter linking.
•	10/1/2012 Update to handle FieldWorks 7.2.7 XHTML format. Update student manuals and help. Bug fixes for Linux. Add project URL to rights page.
•	9/11/2012 Fix Pictures and font size on French Windows, Linux: enable help, XeLaTeX working, fix pictures, various bug fixes, E-Book: fix footnotes and cross references, handle hard line breaks, Go Bible updated
•	8/20/2012 Epub: Fixed duplicate cross references, option to ignore illustrations; Go Bible: localize, 
      latest Go Bible code; Libre Office: each book on a new page, number all pages, Fix TOC, orphan and widow control
•	7/27/2012 Fix epub boxes & spacing, Linux epub, pictures in epub, don't require Flex for Paratext
•	7/14/2012 Scripture epub navigation, Linux Scripture and epub export, CadreBible destination, bug fixes
•	6/20/2012 fixed Libre Office line height, line breaking, treat tilde as fixed space from Paratext, use * for footnote marker if none given, allow bulleted sense paragraphs, enable removal of letter headers, make sure footnote callers not too small, add a Help Improve check box on the about menu, create Linux packages.
•	5/23/2012 Allow users to post their dictionary data to a Webonary web site.
•	4/26/2012 Update license and copyright dates, Update headers to put first headword in left header, Update e-pub table of contents, fix padding additions and punctuation losses, add blank pages to front matter when need
•	4/12/2012 Add organization to common list, allow GoBible collections changes, Adjust front matter for InDesign, LibreOffice, Adjust table of contents for epub, reset title when changing projects, other bug fixes
•	3/13/2012 Add control of downloads to bootstrap, Fix out of memory errors, Add InDesign front matter, Add table properties to Libre Office, Same reversal if exported together with main, Add xslt pre-processing, YouVersion export option, Usage data collection option
•	2/13/2012 memory error fixed, fixed links in Epub and Libre office, added XeLaTex reversal index
•	1/27/2012 Bootstrap program tested and updated, Epub launches viewer, InDesign creates table of contents, Open Office out of memory error and height of guidewords for non-roman cases, XeLaTeX has front matter and accepts picture path names.
•	1/11/2012 Improve bootstrap with icon, epub, clean up, and version checks; Open Office/Libre Office: fix guide word box, page number overlap, spaces around pictures, header fonts; Configuration tool: Fix French locale crash, preview page size; InDesign: fix empty footnotes; XeLaTex: fix export crash
•	12/22/2011 Add Bootstrap for installer, Open office: front matter, guide words, page numbers, Complex Text Layout and subentries, E-book: links, preview, InDesign: captions, XeLaTeX: tif images, Configuration Tool: units, sort destinations
•	12/1/2011 Add tables, sanitize rights fields, enable PrinceXml export if Prince is installed. Fix bugs related to missing information, crashes related to locked files, spacing, display on Chrome, boxes in headers, page numbers, pictures, root based dictionary export, and writing system processing.
•	11/17/2011 Fix style merging, adjust default copyrights, allow punctuation in organization name, fix out of memory error, fix user interface crashes, move settings folder to user's profile, add styles to reversal homograph and sense numbers, optimize gigantic E-Book conversion, Remove BOM from Go Bible, Use font name from Xhtml meta tag (especially for non-Latin cases)
•	11/2/2011 Update command line interface to handle dictionary with reversal and accept input from USFM. Bug fixes related to stable release. Adjust spacing between words, fields and lines.
•	10/21/2011 Bug fixes: Configuration tool, Epub, Libre Office, ParaTExt, crashing. 
•	10/4/2011 Remember ConfigurationTool settings, Libre Office centered page numbers and corrected guidewords, Linux simulated install, Paratext USX format update, Webonary synonyms & homograph numbers, XeLaTeX padding, indenting, emphasized text, and make pictures appear.
•	9/20/2011 Configuration Tool, Epub, Go Bible, Libre Office exports working on Linux (pre-alpha stage: we are still working out permissions and have no package installer), Localization and Semantic Domain linking added to Webonary, XeLaTeX install updated to also include Paratext Draft printer, Libre Office space before punctuation, and keep sub-entry with main entry, Unused destinations removed from Pathway
•	8/23/2011 Libre office: guideword formatting, missing spaces, picture formatting, first page; Epub: separate notes; Go Bible: character formatting; Web: complex sub-entries, variant forms, custom fields, example sentences
•	8/10/2011 Fix Words of Christ and interaction with BlueTooth wizard, Libre Office guide word bugs, Webonary Charis font and image conversion, XeLaTeX font: family, size, style, weight, super & subscript.
•	7/26/2011 Epub: comma in verse #, reversal index, title page, table of contents, style sheets, Go Bible handle Scripture with pictures, adjust organization choices in SE version, add hard spaces, bug fixes, XeLaTeX on XP in trial version
•	7/5/2011 use css for epubs, detect if Libre Office not installed, InDesign macro doesn’t affect PublishingAssistant documents, Webonary plug-in and sub-site completed, hard space after verse number
•	6/21/2011 Libre Office to Libre Office, Guide Words in two languages, 15pt base font (esp. for non roman), E-pub punctuation, Keep-with-next on Scripture headers, YouVersion poetry, Update license, logo, help and E-pub validation
•	6/8/2011 Add space to Go Bible spelling, update help, Add license, readme, help, and student manual to menu, add help button to ConfigurationTool, Add boiler plate SIL licenses and copyrights to Epub, Implement font fall back for Unicode code point ranges
•	5/26/2011 replace PrintVia dialog with ExportToPathway dialog, update headers to user variables for dictionaries, update help files
•	5/10/2011 add meta data to Libre Office, InDesign, Epub and Go Bible, update reports to use new web site, reset footnote callers at new book.
•	4/12/2011 add parenthesis around picture caption, add ability to accept multiple books from Paratext export, update help files for new web site, YouVersion mobile offline format, adjust homograph number size, add page numbers in style sheet, bug fixes
•	3/22/2011fix footnote refs, picture captions, verse # size, epub configuration items, macro headers, \b marker, minor entry bullets
•	3/1/2011 fix InDesign & Libre Office footnote & Scripture header formatting. Add YouVersion output. Scale images and provide multi-level TOC in Epub. Update help files. Fix export of main & reversal together.
•	2/15/2011 multiple level epub dictionaries, allow book codes in Scripture headers, fix columns in Paratext, cross references, reversal headers, some meta data label changes.
•	2/3/2011 paper properties bug, abbreviations in scripture header, picture box, epub progress bar & memory uses, InDesign text placement and macro installation errors, reversal headers, change tool tip, footnote rule length, superscript font size, zero length files removed from installer, use left & right pages, import Paratext pictures
•	1/19/2011 superscript verses, can run macros later, pictures in pdf, epub content going to browser, epub validation adeed, removed Word output (simple export from Libre Office is inadequate)
•	1/5/2011 Gondwana data export and other bugs
•	12/23/2010 Paratext convert includes pictures and styles, Epub embeds fonts, adds cover and splits large files, InDesign included for Scripture, Libre Office macro progress bar & bug fixes, fix send button
•	12/1/2010 generate email for Logos output (w/Scripture only), Go Bible work with Paratext, progress bar while Libre Office macro runs, styles for Paratext output, enlarge footnote text, orient user to intellectual property issues, various bug fixes
•	11/16/2010 allow page # at bottom of page, adjust tool tips, preview as tab in ConfigurationTool, handle Gondwana, create global ids for logos publications, add font support to epub, check for duplicate book names in Go Bible and fix icon, 
•	11/3/2010 Fix book name disappearing, Set layouts based on backend choice, fix font size of first paragraph, fix irregular line spacing, Unhide document after macro even if error, fix resource permission error, turn off non-printing characters before pagination, fix lost styles, add footnotes to preview (page 2).
•	10/20/2010 macro handle empty document, preview pages even for custom style sheets, remove extra spaces around punctuation and before entries with pictures, reversal margins corrected, edit style sheet in preview can only be activated once, style names can start with numbers, various bugs in Configuration Tool interface
•	10/5/2010 style names reduced and simplified in Libre Office, Indic scripts work with Libre Office 3.3 beta, vertical divider line, bugs related to setting configuration parameters
•	9/28/2010 Update installer for Win7 64-bit, fix bug causing re-opened file to be different, create corporate release build, use spelling dictionary from Flex, fix picture placement, fix validation error when both 6.0.4 & 7.0 versions installed, fix descender chopping, InDesign bug on Flex export fixed, 
•	9/11/2010 update WordPress, Logos Libronix alpha, suspend auto save during macro, quote marks in before and after text, update application style description to include Paratext
•	8/24/2010 Pdf for 64-bit, Spurious margin errors, Fw 6.0.4 & 6.9 version co=exist, InDesign header multiple writing systems, Macro bugs, Change term: Plug-in -> Utility, Spurious settings file error, styles before text.
•	8/10/2010 column gap error adjusted, picture location corrected, macro speed up, simplify styles list, layout dialog help, other small bugs.
•	7/17/2010 macro bug fix & improvements, page margin validation, Unique layout names, short cut keys & tab order, Hide Approved by for custom, text file compare for linux, Validate save path, Copy & Edit error fix, Remove maximize box & disable resize, add unicode-bidi, Update installer scripts, Paratext support, Link PrintVia to Configuration Tool, Handle multiple pictures float to top, Produce one document per book
•	7/5/2010 cosmetic changes, copy style, check before rerunning macros, Go Bible bug fixes, Wordpress output alpha XeTeX handle rtl dictionaries, improve Go Bible performance, Improve Pathway - Flex compatiblity test, latest version of ANTLR, update documentation
•	6/18/2010 output to Word and Pdf via Libre Office. Go Bible Properties. InDesign file saved. Split dictionary into files by letter. Format Reversal using Flex styles. Monolingual rtl for XeTeX. Verse styles
•	6/4/2010 properties for Go Bible, Verse style bug, InDesign macro from current page forward, Start with shift down to reset, check version compatibility with Flex, remove InDesign macro on exit, simplify InDesign style namesInDesign major language hyphenation
•	5/24/2010 Add Other category, PrintVia selection limits stylesheet options, InDesign footnotes, InDesign Picture Caption bug, migrate styleSettings.xml, fix picture path bug, XeTeX font support
•	5/7/2010 Fix Pictures and Captions. Build for Fieldworks 6.0.4. Vertical justification, bug fixes
•	4/27/2010 Add Go Bible backend
•	4/23/2010 Page size & margins in InDesign, add extra processing to InDesign
•	4/12/2010 Handle picture overlap, validate settings file, right to left style sheet, verse 1, chapter 0, preview button, homograph # in header, XeTeX output, updated help, add tutorial
•	3/24/2010 fix decender cut-off by forcing background color to transparent
•	3/19/2010 check for old settings, fix InDesign crash from FW, stablize
•	3/12/2010 Pathway 0.5.5 improved UI
•	3/5/2010 Pathway 0.5.4 improve display properties, add help
•	2/26/2010 Pathway 0.5.3 refine style sheets, configuration tool ui fixes, fix macro for OO3.2 InDesign refs.
•	2/19/2010 Pathway 0.5.2 update style sheets, retain column widths, fix SE buttons
•	2/12/2010 Pathway 0.5.1 (version number lowered since it is a new user interface). Undo / redo.
•	2/2/2010 Pathway 2.0 created from PublishingSolution 1.5.19