how to typeset
an edition of lipu tenpo

Welcome to the selo repository. It contains all the files you need to typeset your own edition of lipu tenpo. This file has all the instructions you need to do that.

At least, on the long term. Because, as of now, this document is not yet complete. jan Kasape, the designer, is working on it. Please don’t trip over the ‹TODO›s.

The instructions may also change over time, because the design style of lipu tenpo is constantly being worked on. The folder structure also changed over time, because I gradually learn what works best.

preparations

To make an edition of lipu tenpo, you need

1. Scribus (version 1.5.8)
2. a vector editor like Inkscape (it’s best if you use version 1.3+, I think. TODO)
3. git

Sometimes, a bitmap-processing tool like GIMP can also be helpful. I needed it once.

working with Scribus

Scribus is the main tool that you will use. This section contains some tips for your workflow.

Turn off hyphenation.

working with Inkscape

If you use Inkscape, copy the file /lipu-tenpo.gpl to where Inkscape stores its palettes, which is probably ~/.config/inkscape/palettes if you use Linux. Then, in Inkscape, select it using TODO. Copy the template file TODO into the folder of the edition.

This table contains the entire palette. TODO

The palette is in the GIMP .gpl format. To convert the palette into CSS colours, you can use this script.

the scrapbook

panes

Properties, Item Properties, Align and Distribute, Scrapbook, TODO

TODO Show margins, boxes, text flow, rulers relative to page. Toggle these options all on or off using F11.

preparing the files

Clone the selo repository onto your device. If you already have the edition, ensure it is up-to-date using git pull.

If you make a new edition, TODO. If you make a different version of an edition, make its folder. In the root of the directory, make a new folder for the edition. Its name must be the name of the edition. For instance, /nanpa lipu. In the folder of the edition, create three folders: ijo, sitelen, and toki.

In addition, you must know the following:

1. the articles in plaintext form
2. the titles of the articles
3. the authors of the articles
4. the name of the category in which each article is
5. the images that the articles use
   1. a greyscale version
   2. a coloured version
      • If the image uses colour; otherwise, use only a greyscale version.
      • The coloured version must have the same dimensions as the greyscale version, and the positioning must be identical.

TODO use the files that you need for all editions, move them to /ali

an article

the text

import with Control + i. Line breaks are like paragraph breaks to Scribus. You must adjust them manually.

images

text wrap positioning: integers. this is for the greyscale version. illustrator: in footnote style next to the image

footnotes

Footnote in the text: regular letter (or superscript? TODO), and apply the style nanpa lili sewi TODO.

title

background shape

Every article has a title, and every title has a background shape. You must draw this background shape manually. For every article, do this:

1. Open the file ijo/ko.svg in Inkscape.
2. In Scribus, a screenshot of the title.
3. Paste the screenshot in ijo/ko.svg in Inkscape.
4. With the TODO tool, draw a path around the title.
   1. Draw a shape that fits the article, if this is possible.
      • For an article about a Toki Pona meetup in nanpa kalama, I drew three text bubbles, like a conversation.
      • For an article about coffee in nanpa sewi TODO I drew a leaf and a drop.
   2. Otherwise, draw a simple bubble or a text bubble.
5. Give the path the light background that corresponds with the colour for the category that the article is in.

Now that you have drawn all the blobs, it is time to export them.

1. Go to the Layers menu in Inkscape with Control + Shift + l.
2. Find the paths that you drew.
3. Rename each path to the title of the article that it is drawn for.
   • A name like path0053 TODO would be replaced by jan li toki pona.
4. Go to the Export menu with Control + Shift + e.
5. TODO the batch tab (Inkscape 1.3+, I think)
6. TODO prefix
7. TODO position

You now have a file for each background shape. Let’s put it in Scribus. For every article, do this:

1. Navigate to the page of an article that doesn’t have a background shape yet.
2. Go to TODO › Import Vector File… with your custom shortcut Control + Shift + i.
3. Select the right shape from the file list.
4. Click near the title that you want to place the shape on.
   • The shape will be big. I don’t know what the regularity is, but it happens.
5. Move the shape to the background using Control + End.
6. Resize the shape.
   • For precise rescaling, go to the Properties pane (F4) TODO. There, you can add an arithmetic expression to the position and scale fields.

the cover

Change the text in the textbox to the name of the edition. The textbox is positioned TODO.

the image

The proportions of the front-cover image are preferably TODO.

The front-cover image is usually in SVG format, because jan Simo usually draws it.

The second page of an edition has four parts.

the edge

The edge is a vector file. It has a bleed of 3 mm. You must make one yourself for each edition. Use one blob for each of the four colours. On either side of the cover, exactly three must be visible. Make sure that the distribution of these blobs is not the same as in the previous two editions. TODO

table of contents

Add attributes Generate Table of Contents

jan pali

The jan pali section contains the names of all people who contributed to the edition.

sorting

For each part, the names are sorted alphabetically, that is: a e i j k l m n o p s t u w, and the pseudo-letter ‹end of word› goes before all of them, as usual. But we use some extra rules, because, in Toki Pona, the structure of a name is [one or more nouns] [one or more proper names], where a noun is lowercased and the first letter of a proper name is capitalised.

These are the rules:

• Sort by proper name, not noun.

  • kije Enki < jan Kasape < akesi kon Nalasuni

• If two people have the same proper name, but a different headnoun, break the tie using the noun.

  • jan Temi < mu Temi < mun Temi < jan Temili < mun Temili < pan Temili

• If a name contains multiple proper names, ignore the spaces between them.

  • jan Ke < waso Keli < jan Ke Tami < jan Kewi

• If different people with the same name contributed, include them both.

TODO add no-break spaces in the names and after <.

If a name does not follow the structure [one or more nouns] [one or more proper names], then do what makes most sense.

If someone prefers their proper name to be spelt with a lowercase letter, then treat it as if it were capitalised.

• jan Nalu < soweli nata < palisa jelo Natan

If a name contains only a headnoun, treat it as a proper name.

• jan Lakuse < lipamanka < jan Lokan

But if a name consists of multiple words and no proper name, many orderings may make sense. You might want to ignore particles like ‹pi›, and put ‹jan pi nimi ala› before TODO, such as in nanpa TODO.

jan Nalu ? jan pi nimi ala

preparing

Once the names are sorted, do the following:

• Separate the names with a +. It resembles the ‹en› of the sitelen pona writing system.
• Put a space before the +, and a no-break space after the +.
• Replace each space in a name with with a no-break space.

A no-break space is the symbol  .

• Compose key + Space + Space, or Control + Shift + u, a0, Return.
• Alt + TODO
• In Scribus, TODO

If you don’t want to type it, break the paragraph manually with soft breaks. These move to the next line without starting a new paragraph. In Scribus, and in many other places too, you can insert a soft break with Shift + Return.

• no-break spaces between ‹li alasa e pakala toki.› and so forth.

introduction by jan Sonatan

jan Sonatan will usually break the lines for you in a good way.

First and last line is in the style toki wawa and has colour unu pimeja.

In the last line, use an en dash (–), like this: – jan Sonatan.

checklist before publishing

• manual adjustment: arrows, pini, table of contents

• images: use integers for scaling and panning, because you have to remember them

• checks

1. jan pali
   1. Are exactly all the authors mentioned before li toki?
   2. Are exactly all the illustrators mentioned before li sitelen?
   3. Are you and the designers mentioned before li sijelo e lipu?
2. order
   1. Where there are multiple articles on one page, does the order of articles correspond to the order in the table of contents?
      • If not, move some titles to the foreground.
      • select the title
   2. Does the category name next to the page number correspond with the category name of the article on it?
      • If the category changes in the middle of a page, use that category.
      • If there are multiple categories, ‹4 · toki · pilin›
   3. Does each non-poetry article start with an arrow and end with a ‹pini› symbol?
      1. If an article continues from an odd page to an even page, is there an arrow in the bottom right on the odd page?
      2. Are the first words of each non-poetry article in bold?
      3. Is the TODO
   4. Are the colours correct?
      1. For each category, is the background of the title images the same shade?
3. Is the PDF metadata correct?

exporting

• Go to File > Export as PDF TODO.
• PDF version 1.5 TODO.

the greyscale version

• SVG images, such as front cover: in Properties, set the right dimensions and position.

• images must have same dimensions and same positioning

• ungroup the front and back cover with Control + Shift + g.

• you can remove the objects that are not displayed on the page, but it’s not necessary. If you do, then the pre-flight verifier in Scribus will raise some errors like ‹Object is not on a Page TODO› before you export the document. You can ignore them.

Front cover: use your imagination; make front and back look good. Use only the colours ‹kiwen› and ‹kiwen walo›

printable versions

• Use https://tools.pdf24.org/de/pdf-seiten-sortieren to re-sort the pages in the order: 16 - 1 , 2 - 15 , 14 - 3 , 4 - 13, 12 - 5, 6 - 11, 10 - 7, 8 - 9
• open documents in your preferred pdf viewer, click on print, chose "microsoft to print", click on "two pages per page" or whatever it is in English, create pdf file
• repeat for black & white version

replacing the colours

a sitelen pona version

I have never made a sitelen pona version yet, so I don’t know what it’s like. Once I have done it, I’ll share my experiences in this document.