Getting Started with Paligo

Creating tables

Create a table, using one of the alternatives below: 

Insert a quick default table
  • Select element table in the Element context menu (AltEnter).

    A default table with title heading row, 1 row and 2 columns) will be inserted.

Tip

You can also insert an informaltable from the Element context menu. The informaltable is just a table without a title.

Insert a table using the wizard dialog
  • In the Insert tab, click the Table icon (or use keyboard shortcut AltShiftA):

    1. In the menu, select Insert new table. The dialog Insert new table opens.

    2. In the dialog, select the number of rows and columns. In the drop-down lists below, select whether you want a frame around the table, and if you want rules inside it. Select Border for the first, and All for the second if you want a regular framed table. Click Insert to insert the table.

Tip

If you do not give the table a title, it will become an informaltable. You can always easily convert between a table and informaltable by just toggling the title using the H toolbar icon or its keyboard shortcut (AltShiftH).

Editing Tables
  1. Write the contents of the table in each cell. Use the tab key to easily navigate between cells.

    Note

    Note that each cell by default has a para element (paragraph) inside it, where you normally enter text. If you want to just have an image or the like in the table cell, first put the cursor outside the para, and add the image, and then remove the para.

  2. Use the Table menu or the Element context menu (by right-clicking the table) to manipulate the table, e.g to add or remove rows. 

  3. Select Edit table settings for setting table width and column widths in percent.

  4. To create more complex tables, with merged cells, you have the Merge and Split commands in the Table menu.

    1. To merge cells, first put the cursor in a cell. Then select the cells you want to merge holding down the Shift key. The cells will be highlighted:

    2.  Then select Merge cells from the table menu, or use the keyboard shortcut shown in the menu.

    3. If you have cells you have merged that you want to split back into two cells, place the cursor in the merged cell and select the Split cells command.

Tip

To move table rows up or down, see Moving table rows.

Adding Row Headers and Other Headers

Besides the standard top header, you can also add headers in different locations of a table. One of the most common is a so called "row header", i.e having the first column act as a vertical header.

Add a row header
  1. Select the table element (table or informaltable), either through the structure menu (Go to element), or the element dropdown in the Element attributes panel.

  2. Add the attribute tabstyle. Give it the value "rowheader-firstcol".

Make any individual table cell a header

It's also possible to make any cell a header, either by an attribute or changing the cell element.

  1. Select the table cell you want to make into a header (td).

  2. Then do one of the following:

    • add a class attribute and give it the value "tableheader" (recommended method)

    • or open the XML source code editor and change the td to a th (both start and end tag)

Caution

You can of course make a rowheader by changing each first table cell to a th element as well, but doing it like that in the source code editor requires that you are really careful to change both the start and end tag properly, or you will make the XML invalid.

Background for individual cells

In single-sourcing, you should really not apply any styling to your source content, but rather keep content and layout separately.

In some rare cases you may still find the need to give a certain cell a different background color. But if you were to apply a specific color, and doing this in multiple places, it would be hard to change it later. Instead you can apply a generic value that can be set in the Layout Editor: 'bg1', 'bg2', or 'bg3'. This way you can determine in the Layout Editor what the color should be and change it everywhere you've used it.

  1. Select the table cell you want to make into a header (td).

  2. Add a style attribute, and set the value to 'background-color:bg1' (or 'bg2' or 'bg3' depending on which ones you will set in the Layout Editor.

  3. Open your custom layout in the Layout Editor, and choose the color in the Table/General section.

    Note

    This is only necessary for PDF layouts. In HTML layouts you will get the value as a class name, and can use that in your CSS to style it.

(Should you still want to set a specific background color as a one-off, that's also possible.)

Copying Excel or Other Spreadsheet Data To Paligo

If you have the (optional) Oxygen XML editor, you can easily convert data from Microsoft Excel into a Paligo table only by copying and pasting directly from Excel (or other spreadsheets, like Google sheets).

  1. In your spreadsheet, select the parts you want to copy into Paligo.

  2. Open Oxygen XML Editor and create a new DocBook5 document (article or section)

  3. Select "Author" mode if not already selected, and paste the spreadsheet data after the para tag.

    This converts to the spreadsheet data into an XML table.

  4. Go to the "Text" mode, select the whole informaltable section, and copy the text.

  5. Inside the Paligo editor, paste it anywhere in the editor, and you will have a valid table there.