{"id":508,"date":"2017-04-20T18:48:01","date_gmt":"2017-04-20T18:48:01","guid":{"rendered":"http:\/\/software.sil.org\/wesay\/?page_id=508"},"modified":"2024-07-19T20:26:52","modified_gmt":"2024-07-19T20:26:52","slug":"printing-dictionaries-with-wesay","status":"publish","type":"page","link":"https:\/\/software.sil.org\/wesay\/printing-dictionaries-with-wesay\/","title":{"rendered":"Printing Dictionaries with WeSay"},"content":{"rendered":"<p>There are many ways to make a print dictionary using WeSay. Below, they are ordered from most powerful\/flexible down to the most simple. You might end up using a combination of methods. For example, you might use the \u201cMake PDF Dictionary\u201d for regular printouts used to include a wider group of people in the process of spell checking, example checking, etc., using paper. Later, when you want to actually publish a dictionary, you\u2019re likely to want to import the WeSay dictionary into our Linguist-oriented power tool, <a href=\"https:\/\/software.sil.org\/fieldworks\/\">FLEx<\/a>.<\/p>\n<h2>FLEx+PathWay (most powerful)<\/h2>\n<p>This has many steps, but it is best path for serious dictionary layout. You\u2019ll be using two other free programs from SIL International: <a href=\"https:\/\/software.sil.org\/fieldworks\/\">FLEx<\/a> and <a href=\"https:\/\/software.sil.org\/pathway\/\">PathWay<\/a>. You may also need some supported word processor, depending on how you want to publish.<\/p>\n<ol>\n<li>Install <a href=\"..\/..\/fieldworks\/download\">FieldWorks Language Explorer<\/a> (FLEx).<\/p>\n<\/li>\n<li>\n<p>Install the <a href=\"..\/..\/pathway\/resources\/how-to-install\">Pathway<\/a> add-on to FLEx.<\/p>\n<\/li>\n<li>\n<p>Create a new project. (<strong>NOTE:<\/strong> <em>In <a href=\"https:\/\/software.sil.org\/fieldworks\/\">FLEx<\/a> 7.3, you will be able to do steps 3 &amp; 4 together.<\/em>)<\/p>\n<\/li>\n<li>\n<p>Do a Send\/Receive to synchronize your WeSay dictionary with <a href=\"https:\/\/software.sil.org\/fieldworks\/\">FLEx<\/a>. (<em>You can also just do an import, but then any changes you make in <a href=\"https:\/\/software.sil.org\/fieldworks\/\">FLEx<\/a> won\u2019t get back to WeSay.<\/em>)<\/p>\n<\/li>\n<li>\n<p>In the <em>Dictionary<\/em> area of the <a href=\"https:\/\/software.sil.org\/fieldworks\/\">FLEx<\/a> lexicon, configure to your heart\u2019s desire. At this point you can do some printing if you want.<\/p>\n<\/li>\n<li>\n<p>Choose <em>File | Export\u2026<\/em><\/p>\n<\/li>\n<li>\n<p>Select <em>Dictionary, Reversal Index<\/em>, and click <em>Export\u2026<\/em>.<\/p>\n<\/li>\n<\/ol>\n<p>This will open Pathway, which will let you create files for Adobe InDesign, Word, Open\/Libre Office, PDF, and E-Book.<\/p>\n<h2>Make OpenOffice Document<\/h2>\n<p>One advantage of using OpenOffice\/LibreOffice is that you can add a cover page and make other changes. Another is that it supports a wide range of scripts, including those in Southeast Asia. The downside is that the code that does this was contributed to us, and tends to not get much attention from the WeSay programmers. It does not support custom fields. To use it, just make the the \u201cMake OpenOffice Document\u201d button visible in WeSay, using the WeSay Configuration Tool | Actions tab.<\/p>\n<h2>Lexique Pro via SFM<\/h2>\n<p><a href=\"https:\/\/software.sil.org\/lexiquepro\/\">Lexique Pro<\/a> is a separate free program (Windows Only) which can export to word processing programs, and also to make static web pages. In this method you use WeSay\u2019s <em>Export a SFM (Toolbox) file<\/em> button, and then open the the SFM file it produces in <a href=\"https:\/\/software.sil.org\/lexiquepro\/\">Lexique Pro<\/a>.<\/p>\n<h2>The <em>Open in Lexique Pro<\/em> Button<\/h2>\n<p>This is a simple, one-button way to get into <a href=\"https:\/\/software.sil.org\/lexiquepro\/\">Lexique Pro<\/a>. Unfortunately, as of writing this in Jan 2013, several of <a href=\"https:\/\/software.sil.org\/lexiquepro\/\">Lexique Pro<\/a>\u2019s features have not yet been upgraded to work with LIFT dictionaries (the XML format used by WeSay).<\/p>\n<h2>The <em>Make PDF Dictionary<\/em> Button (most simple)<\/h2>\n<p>The advantage of this approach is that it is fast, easy, and fairly good-looking. Disadvantages include:<\/p>\n<ul>\n<li>Because it is PDF, you can\u2019t make changes, add title pages, etc.<\/li>\n<li>Making even small tweaks requires someone proficient in the style-sheet language of the Web, Cascading Style Sheets (css).<\/li>\n<li>This feature uses a fantastic PDF-creation engine which you can install freely. This engine, <a href=\"https:\/\/www.princexml.com\/\" title=\"\" class=\"external\" target=\"_blank\" rel=\"noopener\">PrinceXml<\/a> (as of version 8.1), cannot render Burmese, Khmer, or Lanna. It does support Arabic, Chinese, Japanese, Cyrillic, Hebrew, Devanagari\/Hindi, Bengali, Gurmukhi\/Punjabi, Gujarati, Oriya, Tamil, Telugu, Kannada, and Malayalam.<\/li>\n<\/ul>\n<p><img decoding=\"async\" src=\"\/wp-content\/uploads\/sites\/35\/2017\/04\/PrintFromDashboard.png\" alt=\"Print from Dashboard\" title=\"Print from Dashboard\" \/><\/p>\n<p>Under the hood, WeSay uses an engine called <a href=\"https:\/\/www.princexml.com\/\" target=\"_blank\" rel=\"noopener\">PrinceXml<\/a> for creating PDF documents. You can <a href=\"http:\/\/www.princexml.com\/download\/\" title=\"\" class=\"external\" target=\"_blank\" rel=\"noopener\">download it for free<\/a>, but if you use this feature for any commercial purposes, you\u2019ll need to get a license from the authors of <a href=\"https:\/\/www.princexml.com\/\" target=\"_blank\" rel=\"noopener\">PrinceXml<\/a>. Here\u2019s what the output looks like:<\/p>\n<p><img decoding=\"async\" src=\"\/wp-content\/uploads\/sites\/35\/2017\/04\/594px-SamplePrintOut.png\" alt=\"Sample PDF output\" title=\"Sample PDF output\" \/><\/p>\n<div class=\"announcement\"><p class=\"bold\">NOTE:<\/p><p>While PrinceXml itself is extremely flexible and powerful, WeSay only uses it for printouts using just the most common fields. If you need more power, you need to go the FLEx+PathWay route described previously.<\/p><\/div>\n<p>To enable this feature:<\/p>\n<ol>\n<li>Quit WeSay.<\/li>\n<li>Download and install <a href=\"http:\/\/www.princexml.com\/download\/\" title=\"\" class=\"external\" target=\"_blank\" rel=\"noopener\">PrinceXml<\/a>.<\/li>\n<li>In the WeSay Configuration Tool, go to <em>Actions<\/em>, and enable the <em>Make PDF Dictionary<\/em> button.<\/li>\n<\/ol>\n<h3>Multigraphs<\/h3>\n<p>Starting with version 1.1, if you have digraphs (or trigraphs) that you would like to group together, do this:<\/p>\n<ol>\n<li>Ensure that the sort order you\u2019ve set up accounts for the multigraphs.<\/li>\n<li>Create a text file named <code>multigraphs.txt<\/code> in the <em>Export<\/em> folder.<\/li>\n<li>In that file, list your multigraphs, one per line, like this:<\/li>\n<\/ol>\n<pre><code>ch\nth\nng\n<\/code><\/pre>\n<h3>Customizing<\/h3>\n<p>If you like what comes out, great. If you want to do some tweaking, then look in the <em>Export<\/em> folder of your WeSay project. There, you\u2019ll see two files which you can edit: <code>customLayout.css<\/code> and <code>customFonts.css<\/code>. These are simply <em>Cascading Stylesheet (CSS3)<\/em> files. The web is full of free references and tutorials on CSS. The way this works is that WeSay first generates a \u201cplift\u201d XML file (also in this <em>Exports<\/em> directory). It then converts that to XHTML. Finally, it asks PrinceXML to create the PDF, using the four stylesheets. The precedence of these is such that the \u201ccustom\u201d ones overrule the \u201cauto\u201d ones.<\/p>\n<p>If you have custom fields you want to print, you\u2019ll need to add those to the <code>customLayout.css<\/code>. TODO: show how.<\/p>\n<div class=\"announcement\"><p class=\"bold\">NOTE:<\/p><p>If you find that you need extensive customizations, you\u2019re probably better off using <a href=\"https:\/\/software.sil.org\/fieldworks\/\">FLEx<\/a>+<a href=\"https:\/\/software.sil.org\/pathway\/\">PathWay<\/a> to do your actual printing. Again, this built-in printing is only intended to be good enough for quick printouts that you can hand out for checking in the community.<\/p><\/div>\n<h3>PrinceXml Version<\/h3>\n<p>The most recent version of <a href=\"https:\/\/www.princexml.com\/\" target=\"_blank\" rel=\"noopener\">PrinceXml<\/a> with which we have tested WeSay is 8.1.<\/p>\n<div class=\"top border\"><a href=\"#top\">top<\/a><\/div>\n","protected":false},"excerpt":{"rendered":"<p>There are many ways to make a print dictionary using WeSay. Below, they are ordered from most powerful\/flexible down to the most simple. You might end up using a combination of methods. For example, you might use the \u201cMake PDF Dictionary\u201d for regular printouts used to include a wider group of people in the process [&hellip;]<\/p>\n","protected":false},"author":29,"featured_media":0,"parent":0,"menu_order":8,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"hide_sidebar":false,"hide_h1":false,"footnotes":""},"class_list":["post-508","page","type-page","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/software.sil.org\/wesay\/wp-json\/wp\/v2\/pages\/508","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/software.sil.org\/wesay\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/software.sil.org\/wesay\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/software.sil.org\/wesay\/wp-json\/wp\/v2\/users\/29"}],"replies":[{"embeddable":true,"href":"https:\/\/software.sil.org\/wesay\/wp-json\/wp\/v2\/comments?post=508"}],"version-history":[{"count":15,"href":"https:\/\/software.sil.org\/wesay\/wp-json\/wp\/v2\/pages\/508\/revisions"}],"predecessor-version":[{"id":1044,"href":"https:\/\/software.sil.org\/wesay\/wp-json\/wp\/v2\/pages\/508\/revisions\/1044"}],"wp:attachment":[{"href":"https:\/\/software.sil.org\/wesay\/wp-json\/wp\/v2\/media?parent=508"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}