The main highlights are:

  • Add automatic table width calculations for tables with no embedded tables, no column spans, no row spans, and no width attributes for the default way of producing PDF. See section 11.17.1.1 ‘Known limitations of using XeLaTeX’ (first bullet point) in the user documentation.
  • Add a CreateZipFile command which creates a zip file containing the main document file as well as all included (aka referenced) files and image files. See section 11.45 ‘Create a Zip File of My Document’ in the user documentation.
  • Add ability to publisher style sheets to control the indent for the initial line of the footnote text (how much space appears before the superscript footnote number in the footnote text at the bottom of the page).
  • Add content control mechanism. See section 15 ‘Content Control’ in the user documentation.
  • Add ability to have more than one line in each word and listWord example. One can now insert an extra word element for each such extra line.
  • Rework how the automatic wrapping of interlinears works in order to fix problems where some aligned units went off the right margin and also to fix proper wrapping of long free translations.

You can obtain an installation program for Windows, Mac or Linux at http://www.xlingpaper.org/?page_id=51.

If you have already installed XLingPaper version 2.10.0 or higher and merely want to upgrade, then you will need to download and install the XLingPaper update file. See http://www.xlingpaper.org/?page_id=107. If you have modified any of the stock publisher style sheets, please be sure to make a backup of your work before running this installer. It may overwrite your modifications. In addition, you should download and install the XeLaTeX Update (see http://www.xlingpaper.org/?page_id=4#XeLaTeXUpgrade). This update is required before you can produce the default PDF if you are using the framed unit capability (added in version 2.20.0).

The recent changes are:

  • 2.22.0 11 April 2013
    • Add footnoteIndent element to publisher style sheet. It controls how much space appears before the superscript footnote number in the footnote text at the bottom of the page.
    • Add content control mechanism. See section 15 ‘Content Control’ in the user documentation.
    • Add ability to have more than one line in each word and listWord example. One can now insert an extra word element for each such extra line.
    • Fix “Click to set font info” command to not set the font-family to the default name when Spanish and French UI being used.
    • Add a CreateZipFile command which creates a zip file containing the main document file as well as all included (aka referenced) files and image files.
    • Fix section 5.8 “Headings on Examples” to mention that these headings can occur on any kind of example.
    • Make sure the language element id and the type element id have a white background (some versions of XXE showed it as the color of the preceding id background color).
    • For the default way of producing PDF (via XeLaTeX):
      • Add automatic table width calculations for tables with no embedded tables, no column spans, no row spans, and no width attributes.
      • Rework how the automatic wrapping of interlinears works in order to fix problems where some aligned units went off the right margin and also to fix proper wrapping of long free translations.
      • Make the XeLaTeXSpecial attribute value ‘pagebreak’ work on a tr element so a user can force a page break on a row. It causes the page break *before* the current row (the tr element); therefore the current row shows on the next page.
      • If an endnote has an example in it and if that endnote is in a table cell with its width attribute set, it would fail to produce the PDF. We now ignore the width attribute in such cases.
      • Fix bug: when td or th elements in the first row of a table contained width attributes and the table did not have any colspan attributes, the width was not passed down to other td and th elements. Also, this process of passing down width attributes failed to work correctly when there was a rowspan at the top. We longer try to pass the width values down when there is a rowspan at the top.
      • Fix bug: when using autowrap in interlinears and have two free elements in a row without a lang attribute set, if the first free does not have any text material in it, the PDF could fail.
      • Fix bug: when using automatic wrapping of interlinears, showing ISO codes, and when there is an example with listInterlinears that (i) have different ISO codes and (ii) have an exampleHeading before the first listInterlinear, the content of the first listInterlinear was not always shown correctly.
      • Fix bug: A blockquote in an endnote within a table could cause the PDF to not be produced.
  • If you are using version 5.3.0 of the XMLmind XML Editor and wish to use either a French or a Spanish user interface, you can go to the Downloads page and get it. There are new installers for adding a French user interface and French dictionary, a Spanish user interface and Spanish dictionary, and for German dictionaries. The dictionary files are used by the spelling checking mechanism of the XMLmind XML editor.

    The main highlights are:

    • Add ability to publisher style sheets to control the indent for any second and following interlinear line groups and to control the vertical space between any second and following interlinear line groups.
    • Add ability to control the column widths used in any automatically generated table of abbreviations used.
    • Let showLevel attribute of contents element have a value of 0 so that one can have a book whose table of contents shows chapters without any sections.
    • Enable paragraphs and continuation paragraphs between interlinears in an interlinear text.

    You can obtain an installation program for Windows, Mac or Linux at http://www.xlingpaper.org/?page_id=51.

    If you have already installed XLingPaper version 2.10.0 or higher, then you will need to download and install the XLingPaper update file.  See http://www.xlingpaper.org/?page_id=107.  If you have modified any of the stock publisher style sheets, please be sure to make a backup of your work before running this installer.  It may overwrite your modifications.

    In addition, you should download and install the XeLaTeX Update (see
    http://www.xlingpaper.org/?page_id=4#XeLaTeXUpgrade).  This update is required before you can produce the default PDF if you are using the framed unit capability (added in version 2.20.0).

    The recent changes are:

    • 2.21.0 21 February 2013
      • To publisher style sheets, add a new interlinearMultipleLineGroupLayout element to the contentLayout section. It has two attributes:
        • indentOfNonInitialGroup: the indent to use for any second and following interlinear line groups;
        • spaceBetweenGroups: the vertical space to use between any second and following interlinear line groups.
      • Add three attributes to the abbreviationsShownHere element to control the width of the abbreviation column (abbrWidth), the equals sign column (equalsWidth), and the definition column (definitionWidth). This is only used when the abbreviations are shown as a table.
      • Make sure that if the abbreviations are shown as a table and any take more than a single line, that the information aligns at the top of the row in the table.
      • Let showLevel attribute of contents element have a value of 0 so that one can have a book whose table of contents shows chapters without any sections.
      • Add useappendixlabelbeforeappendixletter attribute in contentsLayout element of publisher style sheet to allow insertion of appendix label before the appendix letter in the contents.
      • Add useperiodafterappendixletter attribute in contentsLayout element of publisher style sheet to allow insertion of a period after the appendix letter in the contents and PDF Bookmarks.
      • Add useLabel for abstract layout in publisher style sheet documentation.
      • Enable paragraphs and continuation paragraphs between interlinears in an interlinear text.
      • For the default way of producing PDF (via XeLaTeX):
        • Fix bug which caused the PDF to not be produced when a listWord or listSingle element was in an example in an endnote and that endnote was in a table cell (td element).
        • Fix bug which caused the PDF to not be produced when a period was immediately followed by a special character such as an underscore.
        • Fix a bug where using the showinlandscapemode attribute on an appendix element could cause the PDF not to be produced when not using a style sheet.
        • Fix bug which failed to show the content of a sectionRef in a secTitle in the contents and in PDF bookmarks.
        • Fix bug which caused the PDF to not be produced when using text-transform=’uppercase’ for back matter items in books.
        • Make XeLaTeXSpecial attribute value of ‘pagebreak’ work for a refWork element.
        • Make XeLaTeXSpecial attribute value of ‘pagebreak’ work for a blockquote element.
        • Fix bug which failed to show output for abbreviation definitions in an endnote.
        • Fix bug which failed to produce PDF when there was a framedType element but no framedUnit element.
      • For web pages without a style sheet, fix a bug which would cause an endnote to not show correctly in many browsers.
      • Fix bug which would cause any “textafter” material in a collCitationItem in the reference section of a publisher style sheet to be shown inappropriately when “fleshing out” the citation information.
      • Fix bug which failed to show the content of an appendixRef or exampleRef in a secTitle in the contents and in PDF bookmarks.
      • For EBook output: fix bug which would fail to produce an EBook if the file name contained an underscore character.
      • For web page with a style sheet and for EBook outputs, fix the document title so it does not include the text of any endnote. (In a web page, this title shows at the very top of the browser window; in and EBook, it shows on the cover page.)
      • Update GIAL thesis publisher style sheet.
      • Add ORCID to author element (ORCID = Open Researcher and Contributor ID; http://about.orcid.org/)
      • Add Schematron check for valid values for table cell widths.
      • Add Schematron check for two or more lines in an interlinear lineGroup with different number of wrd elements.
      • Modify Schematron check for two or more lines in an interlinear lineGroup with different number of wrd elements to make it ignore when a wrd element contains an exampleRef.

    Uppsala Universitet has recently published The Gilaki Language, a 445 page book.  This is an English translation and expansion of the original work Giljanskij jazyk by V.S. Rastorgueva, A.A. Kerimova, A.K. Mamedzade, L.A. Pireiko, and D.I. Edel’man.

    Ron Lockwood used XLingPaper to do a complete edit and reformatting of it.  He also interlinearized the texts.

    You may obtain a PDF of the book at http://uu.diva-portal.org/smash/record.jsf?pid=diva2:560728 (scroll to the bottom and click on “fullText”).

    My understanding is that the publisher took the actual PDF produced via XLingPaper and added the front matter to it.

     

    The main highlights are:

    • Add ability to produce an EBook in EPUB format (requires installing Calibre). See section 11.43 “Produce an EBook in EPUB Format” in the User Documentation.
    • Add capability to “frame” a portion of content, including margins and background color. (Uses framedUnit and framedType elements.) See section 14 “Framed Units” in the User Documentation.  To use this capability and produce the default PDF, you also need to either install a full version or get the XeLaTeX update.  See below.
    • Add a “literal” element which is like the free (translation) element but is for a literal translation. See section 5.3.6 “Using a literal translation” in the User Documentation.
    • Improve page breaking (including widow and orphan control) for the default way of producing PDF (via XeLaTeX).
    • Add a discussion in the documentation of how to handle publisher’s custom front matter (including thesis or dissertation special front matter).  See section 11.44 “Handle the Special Front Matter in a Book” in the User Documentation.

    You can obtain an installation program for Windows, Mac or Linux at http://www.xlingpaper.org/?page_id=51.

    If you have already installed XLingPaper version 2.10.0 or higher, then you will need to download and install the XLingPaper update file.  See http://www.xlingpaper.org/?page_id=107.  If you have modified any of the stock publisher style sheets, please be sure to make a backup of your work before running this installer.  It may overwrite your modifications.

    In addition, you should download and install the XeLaTeX Update (see
    http://www.xlingpaper.org/?page_id=4#XeLaTeXUpgrade).  This update is required before you can produce the default PDF if you are using the new framed unit capability.

    The recent changes are:

    • 2.20.0 2 October 2012
      • Fix bug which would use ‘prose’ gloss and langData formatting from a publisher style sheet in an interlinear-text element. It should use the same as in an example.
      • Add capability to “frame” a portion of content, including margins and background color. (Uses framedUnit and framedType elements.)
      • Add a “literal” element which is like the free (translation) element but is for a literal translation.
      • Add an attribute of spacebetween to the listLayout element in a publisher style sheet. It allows one to insert extra space between list items.
      • For a book using a publisher style sheet, include an option for a given front or back matter item to have empty headers and footers (needed by some institutions for abstracts in theses).
      • Fix a bug: When a publisher style sheet is set to remove common hundreds digits in page numbers and the page numbers are in the thousands, it failed to remove the digits.
      • Allow books to include an abstract in the front matter (e.g., in a thesis or a dissertation).
      • Add ability to produce an EBook in EPUB format (requires installing Calibre).
      • On Windows, the Program Start menu items for creating a new paper, book or references document did not work (for XXE version 4.8 or later). Now it does.
      • For the default way of producing PDF (via XeLaTeX):
        • Fix a bug which would cause some examples to have too much space after them.
        • Fix a bug which could make the bookmark in a PDF link to the first preface element when it should link to a non-first preface element.
        • Fix a bug which would use ?? for page numbers in the table of contents for any front matter items that occur before the table of contents.
        • Fix a bug which would cause the PDF to fail to be produced when an interlinear text had an interlinear with two consecutive lineGroup elements and the auto wrap interlinear option was selected.
        • In a book with a publisher style sheet, in the front matter, any space before values were not correct.
        • With a publisher style sheet, titles were not always properly centered.
        • In a book, the starting page number did not work. This is fixed.
        • Rework how block quotes are done so they work correctly. The initial text/paragraph will never have an indent, while following paragraphs will (unless they are pc elements).
        • In a book, the appendix was laid out according to the chapter layout, not the appendix layout information.
        • Improve page breaking (by adding some TeX glue to key items; sorry, I had mistakenly understood that these items already had some TeX glue, but they did not).
        • Do not show a paragraph that consists merely of a comment.
        • If one is using double spacing or space-and-a-half as well as putting table captions before the table, then there was too much vertical space between the caption and the table.
        • When there was an associated publisher style sheet, once in a great while the final page of the document would have the wrong running header and footer. This is fixed.
        • When there was an associated publisher style sheet that used double or space-and-a-half spacing for text but single-spacing for tables, when abbreviations were shown in a preface, appendix, or glossary, the abbreviations used double or space-and-a-half instead of single spacing. This is fixed.
        • Fix a bug where multiple endnotes in a free element would not format correctly.
        • Fix a bug where a li element started with text and then had a p element after it. The p was not indented correctly.
        • Fix a bug where a li element started with a p element and had another p after it. The p was not indented correctly in either case.
        • Fix a bug where a li element started with text and then had a p element after it. The content of the p element was concatenated onto the end of the initial text material.
      • For the Web page per publisher style sheet output:
        • Fix bug which caused pc elements to still have an indent.

    Sadly, today XMLmind announced that they are no longer going to offer the Personal Edition of their XML Editor program which we use.

    We can still use our older versions, of course.  I’ve changed the install pages on this web site to refer to version 5.3 which is the latest version XMLmind offered with the Personal Edition license.

    One thing this does mean, however, is that you should not update to new versions of the XMLmind XML Editor if you wish to continue using the Personal Edition.

    Today, XMLmind announced a new version of their XSL-FO Conversion Utility that some of us have used to convert XLingPaper files to either Word or Open Office format.  Until today, XMLmind has generously offered this tool via a Personal Edition License that enabled qualified users to employ their program for free.  Now, they no longer offer the Personal Edition License.  You must buy the Professional version ($275USD).

    Naturally, we find this to be disappointing, but understandable.  Business is business and we certainly want XMLmind to remain in business.

    So what do XLingPaper users need to do if they find it hard to pay the money required for the new version?

    There are two options:

    Option 1

    Follow these steps:

    1. Produce a PDF output file.
    2. Go to http://www.pdftoword.com/ and use their free PDF-to-Word service.

    The result is formatted exactly or almost exactly as the PDF was, with the exception that all internal hyperlinks are missing.  So there are no longer links to sections or examples or citations, etc.  (There is a bug report on this; hopefully some day they will fix it.)

    For Open Office, open the Word file.  It may have a few format problems, but it should be close.

    Option 2

    XMLmind still has the previous version available for download at http://www.xmlmind.com/archive/foconverter/4.6.1/.  See section 11.18 of the XLingPaper user documentation for what to do.

     

    Thanks to Joyce Wood and her dad, there is now a second macro included in the Microsoft Word Utility.  This one (Non-BreakingRow) will improve page breaking of tables.

    The main highlights are:

    The recent changes are:

  • 2.19.0 5 July 2012
    • Add command to convert selected text to a langData element. See section 11.41 “Convert selected text to langData” in the user documentation.
    • Add command to convert selected text to a gloss element. See section 11.42 “Convert selected text to gloss” in the user documentation.
    • Add an ability to override the dissertation or thesis label for an individual dissertation or thesis element.
    • Fix a bug where if a numbered table had a caption, the caption is to appear after the table, and both the table and the caption had endnotes, the endnote numbering was wrong.
    • For publisher style sheet:
      • Add Publisher style sheet documentation to menu.
      • Add an ability to insert extra space before and/or after a free element.
      • Add an useblankextrapage attribute to publisher style sheets to control whether or not any extra (even) page should be blank or should have header and footer contents (this extra page is created to make the next page be on an odd-numbered page). This attribute is only considered when startonoddpage is set to yes. This only works with the XeLaTeX way of producing PDF.
      • Added new attribute to the pageLayout element of a publisher style sheet to allow for inserting extra material (such as a space) between a footnote number and its content.
      • Add chapterNumber and sectionNumber to header and footer information in a publisher style sheet.
      • Fix a bug: If a header in a publisher style sheet used paperAuthor and the document had a shortAuthor element, no author information was included in the header.
    • Fix the Font Chooser dialog so it shows well on Mac and reasonably well on Linux (the list of fonts and styles showed only one line before).
    • In the user documentation, add how to go back to portrait mode after setting a portion to landscape mode.
    • Fix error in collection editor formatting in the SIL International References publisher style sheet.
    • For the default way of producing PDF (via XeLaTeX):
      • Fix a bug where a paragraph after a blockquote was not indented.
      • Fix a bug where a li element had two p elements to begin it and the two paragraphs were concatenated.
      • Fix bug where the text of an endnote at the bottom of the page could be missing (if the endnote was in a caption for a figure).
      • Fix a bug where an interlinearRef referenced an interlinear example in an interlinear text, there was an endnote in the free and the endnote was within a genericRef. The footnote number in the text was incorrect (the number in the footnote body was correct).
      • Fix a bug which made interlinear be justified instead of left-aligned when using the auto wrap mode, there was an interlinearSource element, and showing interlinear source after the first line.
      • Fix a bug which made free translations too narrow when using the auto wrap mode, an interlinearRef in a listinterlinear, and showing interlinear source after the first line.
      • Remove requirement that a Times New Roman font be installed.
      • Fix a bug in which a document was double-spaced but footnotes were single-spaced and tables were single-spaced and, in addition, the font size for the document and for footnotes were different. The result was when a footnote had a table, that table used the document font size, not the footnote font size (in addition, any paragraph in the footnote before the table was double-spaced).
      • Fix a bug in which a document was double-spaced but contents were single-spaced and yet the list of tables and list of figures came out double spaced.
      • Improve spacing before numbered tables when a document is double-spaced and the table is to be single-spaced.
      • Fix bug which caused the PDF process to fail when an example was embedded within a table, the text was double-spaced, and tables and examples were not also double-space.
      • Fix a bug in which a document was double-spaced but tables were single-spaced. The text after a numbered table would be single-spaced instead of double-spaced.
      • Add ways to control word- vs. sentence-spacing after periods (for abbreviations primarily). See section 11.40 “Get the default PDF output to use word-spacing after abbreviations” in the user documentation.
      • Make the contents links and PDF book mark links show the section, etc. title (and not show just underneath it).
      • Enable a way to include list of word-forming characters for the set of hyphenation exceptions.
      • Fix a bug where a <br/> element in a <gloss> element in a <listWord> could cause the alignment to be wrong.
      • For right-to-left scripts, reverse content when needed so the order is correct in the output.
      • Enable one to specify script and language special values for an Open Type font. See script and language in the footnote for XeLaTeXSpecial attributes in the user documentation.
      • Enable one to specify script and language special values for an Open Type font and have it work also for when one uses a percentage font size.
      • Fix bug: endnotes in listDefinition and listSingle did not use the correct number in the footnote itself.
      • Fix bug: if an endnote in a listDefinition contained a langData element and one was showing ISO codes in examples, the example for the listDefinition gave the ISO code. It should not have.
      • Added a note to user documentation that the XeLaTeX way of producing PDF does not handle .odg graphic files. Also added a validity test to indicate that .odg files are not supported.
      • Fix a bug: when a pc element was not the first item in an endnote, it could cause extra space to appear before the next footnote on the same page.
      • When interlinear reference is set to show after the first line and one is using auto wrap and referring to a text within the document, could get incorrect alignment of the beginning of the interlinear. Also, sometimes in an endnote the free translation would appear on top of the interlinear.
      • For Appendices in a paper, enable the XeLaTeXSpecial attribute to use ‘pagebreak’ to force a page break before the appendix begins.
      • Fix a bug: In list interlinear examples that had example headings, the horizontal alignment could differ between such examples that used an interlinearRef element from those that did not.
      • Fix a bug: In a book, if the body header and footer layout did not have a first page layout, the PDF would fail to be produced.
      • Improve how the headheight value was handled.
      • If an interlinear lineGroup has but one line in it and one is using the automatic wrapping method, there was still an extra space output when lines wrapped. This extra space is now removed.
      • Fix bug: if a listInterlinear contained an interlinearRef and one was using the interlinear source style of “Show after first line” and one was using the auto-wrap capability, the reference would not show in the correct position.
      • Fix a bug: if a publisher style sheet said to have the first paragraph of a chapter not be indented, it still did a regular indent.
      • Fix some bugs for showing interlinear with a text reference in a footnote when using automatic wrapping.
    • For the web page output with a publisher style sheet:
      • Fix a bug: If the title was empty, the output might be blank.
    • Fix a bug where interlinearRefCitations in style sheet outputs could include extra square brackets.
    • Fix a bug: the row counter element would start over at 1 if a table contained an embedded table between counter elements.
    • Add externalID attribute to single, listSingle, word, and listWord elements. It provides a place to indicate one or more external identifiers which can be used to indicate where a particular piece of data comes from (and to process it potentially).
    • Update link to web site in About XLingPaper page.
    • Add information in the user documentation on how to make an image file larger or smaller in the output.
    • Fix a typo in section 11.39 “Get the default PDF output to hyphenate for a non-English language” of the user documentation.
    • Add a warning message when producing Word or Open Office Writer output and there is at least one endnote containing a table or an example. The converter tool throws away tables in footnotes (and they do not plan to fix it; sigh).
    • Fix some bugs in the Zotero (MODS) to XLingPaper references conversion.
  • If you are using version 5 (something) of the XMLmind XML Editor, when you update to a new version, it will probably ask you if you want to update your configuration files.  If you tell it to do so (which is a good idea, by the way), it may report that the XLingPaper configuration files are obsolete and ask if you want to delete them.

    If you run into this, you should *not* delete the XLingPaper configuration files.  What you can do, however, is go to http://www.xlingpaper.org/?page_id=107 and get the update installer for your operating system.  Run it.  It contains a fix so this problem should not happen again.

    © 2011 SIL International Best when used with the XMLmind XML Editor Suffusion theme by Sayontan Sinha