PechaMaker 
A Tool for Creation of Tibetan Pecha
Frequently Asked Questions
Many things are explained in the User's Guide.

Links to Questions: (Updated November 12, 2013)
- Is PechaMaker a word processor?
- Where can I get a Tibetan word processor?
- Which Tibetan typefaces does PechaMaker recognize? Update for 1.13
- How does automatic keyboard mapping work?
- Are other keyboard mapping options available?
- Where can I get Tibetan typefaces (font sets)?
- Can I put a graphic or bitmap in my document? New for 2.0
-
- How do I convert an existing document to pecha format?
- How can I change the pecha layout?
- Why are the PechaMaker layout controls so complex?
- How can I change the height and width of the pecha?
- How can I change the paper margins or orientation?
- How can I change the position of pecha pages on the sheet?
- How can I change the printer?
- How can I control automatic shad conversion?
- Why the extra space after Tibetan vowels in the annotation dialog?
- Can I create pages with two columns of text?
- What about Undo/Redo?
- What if I find a problem?
- How can I help improve PechaMaker? PechaMaker Forum
- What is the VIP code to register on the forum?
- Is PechaMaker a word processor?
PechaMaker is not really intended to be a word processor; the focus is on pecha layout and printing. It does provide some basic editing capabilities. However, you may prefer to use one of the word processors mentioned below to enter and edit your text before moving it into PechaMaker.

- Where can I get a Tibetan word processor?
The best Tibetan word processors that I know of are:
• Leigh Brasington's "UDP" which you can get for free from Potala Software.
     UDP supports many different file types and text conversions; you can see a list here.
     You can use UDP to read in a file and convert the text to a supported typeface and
     then export it directly to PechaMaker for formatting into pecha.
and
• MS Word when used with the "Nitartha-Sambhota system" from Nitartha International.
     This is a set of macros for MS Word® to provide keyboard mapping specifically for Nitartha typefaces.
     PechaMaker recognizes text in their fonts and tries to match their keyboard mapping.
and
• "TibetDoc" which you can purchase from Tibetan Computer Company.
     This word processor has many Tibetan specific features; it also has support for creating pecha.
     Newer versions include support for images and image annotations within a pecha.
     If you use TCC typefaces and need to control how characters look then this is your best bet.

Any of these will allow you to edit your text with the full power of a word processor. You can then move the text into PechaMaker with copy/paste, or by saving the text as a RichTextFormat (.rtf) file and then using PechaMaker's File>Import RTF file menu item to import the text.

- Which Tibetan typefaces does PechaMaker recognize?
  Here is the list of typefaces that PechaMaker formats using Tibetan grammar rules.
These ten typefaces also have automatic keyboard mapping support.

Five typefaces from Tibetan Computer Company with TCC1 keyboard support
(Each of these typefaces requires 5 fonts)
    TibetanMachine
    TibetanCalligraphic
    TibetanClassic
    TibetanChogyal
    DzongkhaCalligraphic

Five typefaces from Nitartha-Sambhota with your choice of Sambhota keymaps; 1, 2, or 3
(Each of these typefaces requires 29 fonts)
    Dedris
    Ededris
    Drutsa New for 1.13
    Khamdris New for 1.13
    Ume New for 1.13

•The following typefaces do not have any special keyboard mapping support,
  but PechaMaker does format them using Tibetan grammar rules.
Font sets from Tibetan Computer Company (ones with no special keyboard support)
    TibetanMachineWeb (10 fonts)
    TibetanMachineD (1 font)

Font sets from Nitartha-Sambhota (ones with no special keyboard support)
    Sama (3 fonts)
    Esama (3 fonts)

Fonts from the Tibetan Computer Resource Centre (TCRC)
    TCRC Bod-Yig (1 font)
    TCRC Youtso (1 font)
    TCRC Youtsoweb (1 font)

Fonts from the Library of Tibetan Works & Archives (LTWA)
    Monlam ouchan 1 (1 font)
    Monlam ouchan 2 (1 font)
    Monlam ouchan 3 (1 font)
    Monlam ouchan 4 (1 font)
    Monlam Dutsa 1 (1 font)
    Monlam PeyTig (1 font)
    Monlam Tigmachoug (2 fonts)
    Monlam yigchong (1 font)

Others
    Tibetan Modern A (1 font)
    Tsampa Keyboard (1 font) *
      * This font is interesting because it does not require any keyboard mapping.
        Simply change the font to Tsampa Keyboard and type away in Wylie transliteration.
        It works in any editor. Unfortunately it does not contain a glyph for the Rinchen
        pung shad character, so there is no automatic shad conversion for this font.

PechaMaker does not support Unicode or any Tibetan Unicode fonts.
PechaMaker does not support the TCC Postscript fonts for DOS.

- How does automatic keyboard mapping work?
Keyboard mapping controls which character will appear when you press a given key. PechaMaker currently supports five different maps; "QWERTY", TCC1, Sambhota1, Sambhota2, and Sambhota3. It will automatically switch to the appropriate map based on the typeface you are currently entering. See the list above for typefaces with mapping support. The TCC1 mapping is applied to the TCC fonts (unless it is disabled via the Format->TCC Typeface menu item). A Sambhota keymap is used for any of the Nitartha/Sambhota typefaces. Use the Format->Sambhota Keymaps menu item to select which Sambhota keymap will be used (or to disable mapping). The "QWERTY" map is applied to all other fonts. Check the "Keyboard Font" indicator on the Tool Bar to see which font is being entered.

- Are other keyboard mapping options available?
Here are two external keyboard mapping programs that can map keys for any application:

The Keyman program can be purchased from Tavultesoft. This works well with PechaMaker and can support any font. You can create your own key mappings or download pre-made mapping files. Be sure to disable PechaMaker's automatic keyboard mapping if you are using a TCC or Sambhota typeface.

For the TCRC Bod-Yig and TCRC Youtso fonts, a free keyboard mapping program is available. It allows you to type text in any TCRC font directly into any editor, including PechaMaker.
       You can download the installer "tcrctib.exe" from Tibetan Computer Resource Centre (TCRC)
       A map of the TCRC Keyboard Layout is here.

- Where can I get Tibetan typefaces (font sets)?
PechaMaker was originally written to be used with the Tibetan and Bhutanese typefaces from Tibetan Computer Company (TCC). Many people working with Tibetan text already own a font set from TCC. One of the TCC typefaces (TibetanMachine) is now freely available to the public under a GPL thanks to the good folks at the Trace Foundation. The TibetanMachine font set is included as an install option in the PechaMaker installer. You can also download it from The Tibetan & Himalayan Library.

Tibetan Computer Company also offers other Tibetan typefaces which are excellent. You can purchase them at http://www.tibet.dk/tcc/.

The Sambhota and Dedris typefaces can be purchased from Nitartha International.

The TCRC fonts can be freely downloaded from the Tibetan Computer Resource Centre (TCRC).
(Look for the "tcrctib.exe" installer; the fonts are included inside there.)

The Monlam fonts (and several others) can be freely downloaded from Monlam (LTWA).

The Tsampa Keyboard font can be freely downloaded from Tsampa.org.

- Can I put a graphic or bitmap in my document?
Starting with version 2.0 you can add images to your documents.
This feature uses the FreeImage Open Source library; it is built into the PechaMaker program.
There are 3 types of image support:

1) Support for Pecha-page images. When Pecha Mode is enabled you can use the Pecha>Insert Pecha-page Image menu item to attach an image to a specific point on a specific pecha page. The attachment points are within the inner or outer side boxes, or at the left or right text margin. The image will remain in the assigned position, even if the text around it is reformatted. You can move the image to a different page or position by right-clicking on it. As the name implies, these images only appear on pecha pages; they do not appear with Pecha Mode disabled.

2) Support for In-line images. In-line images are intended to be small images, about the height of a line, that are inserted in a line of text like a character. An example would be Khandro Dayig (dakini writing). These images will appear whether Pecha Mode is enabled or not. Each image is treated like a character during line formatting and cursor positioning. As text is reformatted, each In-line image will move around with the surrounding characters. Use the Insert->In-line Image menu item to insert an image at the cursor. As you insert an image you get a dialog allowing you to adjust the position and size. Right-click on any in-line image in the text to reopen the adjustment dialog for that image.

3) Support for using an In-line image for the yi-go. Use the yi-go dialog (Ctrl+Y) to select and setup a yi-go image. Right-click the thumbnail image in the yi-go dialog to adjust the displayed yi-go image. The yi-go image settings are preserved if you temporarily switch to a text yi-go or disable the yi-go. They are also preserved during a "New" operation. However, if you do a Save while the yi-go is disabled or set for text, the image settings are cleared.

Copy-Paste of images or text-with-images is also supported. If you Paste an image it will be inserted as an In-line image.

- How do I convert an existing document to pecha format?
Start PechaMaker from your "Start" menu or by double clicking on the PechaMaker.exe file. Within PechaMaker, press Ctrl+N to start a new document, and use the Pecha>Pecha Mode menu item to disable Pecha Mode. Now, start the word processor that was used to create the document and open the document file. Use the mouse to select the text you are interested in, then press Ctrl+C to copy to the clipboard. Raise the PechaMaker window and click the mouse in the edit window then press Ctrl+V to paste the text. All your text should appear in PechaMaker on one or more pages depending on how much text you paste. To allow PechaMaker to format your text for pecha pages you should remove almost all the Hard Returns. This is because PechaMaker will break each line at the appropriate place for any pecha layout you choose. Every Hard Return that is in the text will force a line break that may not be appropriate when the pecha is resized. (A Hard Return is a code that any editor puts in the text to force a line break.) You can remove Hard Returns easily by selecting a block of text then using the Format>Remove Hard Returns menu item to delete the returns. It might be easiest to use Ctrl+A to select all the text. If you have a title you will need to put in a Hard Return at the end of it (move the cursor there and press Enter).

At this point you can use the File>Save Content Only menu item to save your text in a Content file(.pxc).

If you have a pecha Template file(.pxt) already available, you should load that now with the Pecha>Load Layout Template menu item.

To create pecha just enable Pecha Mode with the Pecha>Pecha Mode menu item (or Ctrl+E). If you like the pecha style and layout you can use the File>Save menu item (or Ctrl+S) to save the content and layout information together in a Pecha file(.pxp).

You can read more about the four save modes or file types (.pxp, .pxa, .pxc, and .pxt) in the User's Guide.

- How can I change the pecha layout?
Use the Pecha>Layout Controls menu item (or Ctrl+L) to open the layout dialog. The first tab, labeled Style, defines how many Title and Fancy pages to draw before starting the Body pages. These three page types are documented in the User's Guide. You can click on the Title, Fancy, or Body tab to change the layout for a specific page type. The two Numbering tabs have controls for Folio numbers (in Tibetan) and Page numbers (in Arabic) for all three page types.

- Why are the PechaMaker layout controls so complex?
Since there is no such thing as a "standard pecha", it must be left to the user to decide what their pecha will look like. To allow as many choices as possible, a large number of controls have been provided. Sometimes the sheer number of controls may seem excessive, but this complexity allows you more choice. Hopefully the complexity will pay off as you create and reuse your pecha layout templates.

- How can I change the height and width of the pecha?
The height of pecha pages is set by the Pecha height control on the Style tab of the layout dialog (Ctrl+L). The width of pecha pages is based on the paper width minus the paper side margins (see the next question).

- How can I change the paper margins or orientation?
Use the File>Page and Printer Settings menu item to change the paper size, margins, or orientation.

- How can I change the position of pecha pages on the sheet?
Use the Pecha>Placement Controls menu item to set the position and number of pecha pages on each sheet of paper.

- How can I change the printer?
Use the File>Page and Printer Settings menu item to select the printer before you use the File>Print menu item. (NOTE: This has changed for Vista. Microsoft has disabled the Printer select button on the Page Setup dialog. So on Vista you can only choose the printer from the Print dialog. This is a problem because changing printers will change the minimum page margins, so what the printer prints on Vista may not appear as it does on the screen.)

- How can I control automatic shad conversion?
Look at the Options>Rinchen Pung Shad Conversion menu and enable or disable the Rinchen Pung Shad Conversion item. If this item is disabled then shad characters will never be converted to Rinchen pung shad. If this item is enabled then the shad character near the start of a line may be converted to Rinchen pung shad depending on the context. If you also enable the second menu item, Second (Yang) Shad Conversion, then the first shad-space-shad sequence on a line will have both shad characters converted to Rinchen pung shad if the first shad in the sequence gets converted. When this menu item is disabled, the second shad in a line will never be converted. If you uncheck the third menu item, Shad Conversion after Yi-go with Shad, then a shad within the yi-go will block any possible shad conversion within a line with a yi-go.

All of the above paragraph is true for Pecha Mode and for non-Pecha Mode. If you are in non-Pecha Mode, no shad is ever converted on the first line of the document. If you are in Pecha Mode, no shad is ever converted on the first line of any Title page. You can uncheck the fourth menu item, Shad Conversion on Pecha Title pages, to completely disable shad conversion on all pecha Title pages.

Additionally, you can use a Hard Shad "character" to get a shad that will never be converted. If the cursor is within text in a recognized Tibetan font, then you can press Ctrl+\ or use the Insert>Hard Shad menu item to insert a control code that will always appear as a shad. If you copy/paste that text or export it to a .RTF file, the character will become a regular shad. Inserting a Hard Shad is not recommended because it could move to a place where you might want it converted when lines are reformatted.

- Why the extra space after Tibetan vowels in the annotation dialog?
When you open the Annotation dialog (with the Pecha>Annotation Controls menu item) you may notice extra space after each Tibetan vowel in the text entry fields. The extra space will not appear on your pecha pages. This is a problem with older versions of the Microsoft RichEdit Control (RICHED20.DLL). It has been fixed in Service Pack 4 for Win2K and in Service Pack 2 for WinXP.

- Can I create pages with two columns of text?
It is possible to create pecha and plain pages with multiple columns. To get two columns, use the Format>Line menu item to increase the tab width to about half of the page width (for pecha it should be about half the inner box width) and use a tab to separate the two columns of text. For three columns, reduce the tab width and insert a tab between each of the three columns. If you want pecha with a single column of text and space on both sides you could just increase the side margin setting for a given page type (using the Pecha/Layout Controls menu item) but the space will appear on every page of that page type. The example file "MultiColumnExample.pxp" is included in the distribution file.

- What about Undo/Redo?
PechaMaker does not currently support Undo or Redo. A useful habit is to save changes that you like often, by pressing Ctrl+S. If you make a change that you don't like, you can use the File>Revert To Saved menu item (or Ctrl+R) to restore to your last save.

- What if I find a problem?
Please read the User's Guide closely for instructions on how to use PechaMaker. Please report failures to support@PechaMaker.com. It would be most helpful if you would describe exactly what steps cause the failure so it can be reproduced.

- How can I help improve PechaMaker?
PechaMaker is still being developed and it needs improved stability and ease of use. You can help this along by sending in your suggestions and reporting your experiences. If you are one of those rare people who is willing to read the entire User's Guide, it would be extremely helpful if you could report on the parts that you find missing, incomplete, or too confusing.

Please use the Discussion Forum PechaMaker Forum to share information with other users.
Use the VIP code word "KARMA" in cap's to register on the forum.

You can also send e-mail to
support@PechaMaker.com


Updated November 12, 2013