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.

cloning the repository

TODO not the whole repository

working with Scribus

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

Turn off hyphenation. Enable snapping.

panes

During the layout process, you will frequently need to use certain panes. It is useful to have them docked on the side of the window, like so:

TODO image

We suggest the following layout. A top pane about a third the vertical height with the tabs Properties and Align and Distribute. And a bottom pane about two thirds the vertical height with the tabs Content Properties and Scrapbook.

TODO is it better to put Align and Distribute in another pane? Properties and Content Properties can best be separated, but so can Properties and Align and Distribute, I think.

(The tab Content Properties changes its name to Text Properties, Image Properties, etc. depending on the item that’s currently selected.)

You can manage them in the Windows menu.

TODO Show margins, boxes, text flow. And enable ‘rulers relative to page’. Toggle these options all on or off using a custom shortcut, like \, to preview.

the scrapbook

A scrapbook is a collection of reusable elements. While layouting in Scribus, you can click on an element in the scrapbook to immediately put it on the page, with proper positioning. This saves a lot of time.

The scrapbook for lipu tenpo is the /jo directory. You can load it in Scribus as follows:

1. Go to the Scrapbook pane.
2. At the top of the pane, click the first, rectangle-shaped icon.
3. Navigate to the selo repository on your computer.
4. Select /jo.
5. Click Choose.

Now, the jo scrapbook is loaded in Scribus. It will remain loaded the next time you TODO.

TODO what’s in the lipu tenpo scrapbook?

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.

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.

Make the cover image in /nanpa x/ijo/selo.svg, with the following restrictions:

• Three colours on the front side.
• Three colours on the back.
• Always four colours in total.
• Always white on both sides.
• The selection of three front colours must not have been used in the two previous editions’ front covers.

The colours are made by blobs (Bézier tool). Put all four of them on the background. Then, make four rectangles the size of the page. Then, for each colour, select a rectangle and Ctrl + * to intersect the two shapes. This way, all four coloured blobs will be cut to the boundaries.

Dimensions:

• height: 216 mm
• width: 303 mm
• Hint: lock the dimensions with the chain icon and only type in one of the dimensions.

Front side:

• x position: −152 mm
• y position: −3 mm

Back side:

• x position: −3 mm
• y position: −3 mm

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

TODO

• Add attributes
• Generate Table of Contents

The tool will spit out the list of all articles with the page numbers they start on. We separate them with newlines TODO.

Then, we place the category markers before. They are text boxes with a built-in right margin. We need to calculate the height of each. Then, we place them after each other. Per category, do the following:

• Add up all the points for each entry.
  • A 1-line entry gets 3 points.
  • A 2-line entry gets 5 points.
  • A 3-line entry gets 7 points.
• Add 2 points to that.
• In the Properties tab, in the X, Y, Z category, in the Height field, type this number followed by *2,25.

EXAMPLE

Snap the text boxes together.

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

TODO simplify this to ‘sorting keys’, like Wikipedia does: ‹jan Kasape› is sorted like ‹Kasape, jan›, and the sorting order is ‘end of string’ < a < A < e < E < … < u < U < w < W < ‘comma’. all the other characters come just before comma? See notes on mobile.

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, you can go to Insert > Spaces & Breaks > Non Breaking Space or type Control + Space.

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.
• bleed TODO.
• only for the printable version:
  • select Use Document Bleeds.
  • check ‘crop marks’, set the offset to 2 mm.

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 ‹kapesi walo› and ‹kapesi ante›.

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

Please see #2

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.