Editing Documentation/Maemo Documentation Guidelines/Formatting in LaTeX

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

This chapter includes information about how to format Maemo documentation text in LaTeX environment.

Basic instructions on how to use LaTeX can be found here: [http://en.wikibooks.org/wiki/LaTeX/ WikiBooks LaTex].

To be able to create a reference to a specific element in a document, you must label that element with the unique LaTeX special characters and especially spaces in the label name. Position <code>\label</code> tag on the next row after the referenced element tag (like <code>\section</code>).

For references, use <code>\ref</code> tag with a unique label.

== Using LaTeX formatting commands ==

=== Using list of tables ===

Use <code>\listoftables</code> to create a list of tables automatically. Used for PDF documents to get a more book like result.

=== Using list of figures ===

Use <code>\listoffigures</code> to create a list of figures automatically. Used for PDF documents to get a more book like result.

=== Using LaTeX special characters ===

LaTeX has special characters <code>_$#%{}^~{}</code> that need to be handled in text with a special marking like <code>\_</code>, <code>\$</code>, <code>\#</code>, <code>\%</code>, <code>\{</code>, <code>\}</code>, <code>\^</code> and <code>\~{}</code>.

=== Using highlight for example code ===

Use <code>\textraw{Example text}</code> or <code>\verb|Example text|</code> to highlight command line examples, function names, and file names in base text. The difference between these two is that <code>\textraw</code> allows normal LaTeX commands inside text will be ignored and handled as plain text.

Both <code>\textraw</code> and <code>\verb</code> will display given text in an appropriate fixed-width font.

{|
|-
| [[Image:dialog-information.png]]
| '''Note:''' <code>\textraw</code> is a Maemo-specific definition and is usable only in the Maemo environment.
|}

For example:

* Function <code>\textraw{example\_function\_name()}</code>.
* Function example_function_name().

* Command <code>\textraw{\$ mkdir \~{}/folder}</code>.
* Command $ mkdir ~/folder.

* File <code>\verb|~/folder/example_file.txt|</code>.
* File <code>~/folder/example_file.txt</code>.

=== Using highlight for important words ===

Use ''Italics'' for other than command line examples and function or file names.

For example:

* This is <code>\textit{important example text}</code>.
* This is ''important example text''.

=== Using highlight for user interface component names ===

Use '''Bold''' for UI element names in text. UI element name in text is the same as UI element caption in UI.

For example:

* This is <code>\textbf{UI Element Caption}</code>.
* This is '''UI Element Caption'''.

=== Using normal headings ===

Use the chapter tag for level 0 chapters (a) together with a unique label. Use the section (for a.b), subsection (for a.b.c) or subsubsection (for a.b.c.d) tag together with unique label for other headings.

For example:

Chapter:
 <code> \chapter{Example chapter title}</code>
 <code> \label{cha:example-chapter-title}</code>

Section:
 <code> \section{Example section title}</code>
 <code> \label{sec:example-chapter-title-example-section-title}</code>

Subsection:
 <code> \subsection{Example subsection title}</code>
 <code> \label{sec:example-chapter-title-example-subsection-title}</code>

Subsubsection:
 <code> \subsubsection{Example subsubsection title}</code>
 <code> \label{sec:example-chapter-title-example-subsubsection-title}</code>

=== Using level 4 headings ===

Use '''Bold''' without a label for level 4 (a.b.c.d.e) headings. This way, level 4 titles are not numbered or included in the table of contents.

For example:

* <code>\textbf{Example level 4 title}</code>
* '''Example level 4 title'''

=== Using command line and screen output examples ===

Use <code>{graybox}</code> environment for command line and screen output examples that require more than one row.

{|
|-
| [[Image:dialog-information.png]]
| '''Note:''' <code>{graybox}</code> is a Maemo-specific definition and is usable only in the Maemo environment.
|}

Explicit new lines (<code>\\</code>) need to be given inside <code>{graybox}</code> environment to separate different rows. LaTeX special characters (<code>_$#%{}^~{}</code>) need to be handled in text with special marking unless they are used inside <code>\verb</code> command.

For example:

&lt;empty line is required before graybox&gt;
 <code>\begin{graybox}</code>
 <code> \$ First command line</code>
 <code> \textraw{\$ Second line in TextRaw}</code>
 <code> Third line has underscore (character '\_') and dollar sign (character '\$')</code>
 <code>\end{graybox}</code>

$ First command line
 $ Second line in TextRaw
 Third line has underscore (character '_') and dollar sign (character '$')

=== Using notes ===

Use <code>{notebox}</code> environment for notes that require whole sentence or paragraph to be highlighted.

{|
|-
| [[Image:dialog-information.png]]
| '''Note:''' <code>{notebox}</code> is a Maemo-specific definition and is usable only in the Maemo environment.
|}

Explicit new lines (<code>\\</code>) need to be given inside <code>{notebox}</code> environment to separate different rows. LaTeX special characters (<code>_$#%{}^~{}</code>) need to be handled in text with special marking unless they are used inside <code>\verb</code> command.

For example:

<code>\begin{notebox}</code>
 This is note text inside a yellow box
 <code>\textraw{Second line in TextRaw}</code>
 <code>Third line has underscore (character '\_') and dollar sign (character '\$')</code>
 <code>\end{notebox}</code>

{|
|-
| [[Image:dialog-information.png]]
| '''Note:''' This is note text inside a yellow box Second line in TextRaw Third line has underscore (character '_') and dollar sign (character '$')
|}

=== Using code listings ===

Use <code>\lstset</code> and <code>\lstinputlisting</code> for listing source code for C/C++, CSS, HTML, Java, JavaScript, Latex, Pascal, Perl, PHP, Postscript, Python, Ruby, SQL, Tcl, Properties files, Makefile, XML, Log files, Ini files and Shell scripts.

For example:

<code>\lstset{language=C}</code>
 <code>\lstinputlisting{chapters/DocumentationGuidelines/snippets/example_source.c}</code>

<source lang="c">
/*
* example_source.c, an example source code for kernel module
*
* Copyright (C) 2010 Nokia Corporation. All rights reserved.
*
* This maemo code example is licensed under a MIT-style license,
* that can be found in the file called "COPYING".
*
*/

#include <linux/module.h> /* needed by all kernel modules */
#include <linux/init.h> /* needed for custom init/exit functions */
#include <linux/kernel.h> /* needed for KERN_ALERT macro */

/* Special macro to indicate license (to avoid tainting the kernel) */
MODULE_LICENSE("Dual MIT/GPL");

static int hello_init(void) {
printk(KERN_ALERT "Hello, world\n"); /* top priority message */
return 0;
}

static void hello_exit(void)
{
printk(KERN_INFO "Goodbye, world\n");
}

/* macros to mark modules init/exit funcs (run on insmod/rmmod) */
module_init(hello_init);
module_exit(hello_exit);
</source>

=== Using figures ===

Use <code>\includegraphics</code> for figures without a file name extension. For example, use image_file_name instead of image_file_name.png.

Use option <code>[H]</code> for figure environment if the position of the figure related to base text cannot be changed by LaTeX . For example <code>\begin{figure}[H]</code>.

{|
|-
| [[Image:dialog-information.png]]
| '''Note:''' Use maemodoc-scaleimage command line tool to scale down figure files that are bigger than recommended maximum size of 600 x 1200 (width x height) pixels. Use option <code>[width=\textwidth]</code> when including figures in LaTeX that are wider than 340 pixels.
|}

All figures must be centered and have both a caption and a label.

For example:

<code>\begin{figure}[H]</code>
 <code> \caption{Example picture}</code>
 <code> \label{fig:example-chapter-title-example-picture}</code>
 <code> \centering</code>
 <code> \includegraphics[width=\textwidth]{folder/images/LaTeX_logo}</code>
 <code>\end{figure}</code>

{| summary="Example picture"
|+ align="BOTTOM" |'''Figure 4.1:''' Example picture
|-
|
[[Image:LaTeX_logo.png|Image LaTeX_logo]]
|}

=== Combining small tables and figures ===

You can arrange small tables and figures side-by-side within the page width limitation.

The following figure environment arranges two small figures side-by-side and creates individual captions for each figure and one common caption for the whole figure environment.

<source lang="latex">
\begin{figure}[H]
\caption{Example logos}
\label{fig:example-chapter-title-example-logos}
\centering
\subfloat[ESbox]{
\includegraphics{chapters/DocumentationGuidelines/images/esbox_logo}
}
\subfloat[PluThon]{
\includegraphics{chapters/DocumentationGuidelines/images/pluthon_logo}
}
\end{figure}
</source>

{| summary="Example logos"
|+ align="BOTTOM" |'''Figure 4.2:''' Example logos
|-
|
[ESbox] [[Image:esbox_logo.png|Image esbox_logo]] [PluThon] [[Image:pluthon_logo.png|Image pluthon_logo]]
|}

=== Referring to a section ===

Use a standard reference <code>\ref</code> to refer to a section in base text. Use a unique label in a reference and refer only to sections inside the same level 1 section (a.b).

{|
|-
| [[Image:dialog-information.png]]
| '''Note:'''  Referring to the level 0 chapters (a) is not allowed because references can be used only inside same level 1 section (a.b).
|}

For example:

* For more information on example topic, see chapter <code>\ref{sec:example-chapter-title-example-section-title}</code>.
* For more information on example topic, see chapter [[#Using LaTeX formatting commands]].

=== Referring to a figure ===

Use standard reference <code>\ref</code> to refer to a figure in base text. Use a unique label in a reference and refer only to sections inside the same level 1 section (a.b).

For example:

* For more information on example topic, see figure <code>\ref{fig:example-chapter-title-example-picture}</code>.
* For more information on example topic, see figure [[#fig:formatting-in-latex-example-picture|4.1]].

=== Referring to a table ===

Use standard reference <code>\ref</code> to refer to a table in base text. Use a unique label in a reference and refer only to sections inside same level 1 section (a.b).

For example:

* For more information on example topic, see table <code>\ref{tab:example-chapter-title-example-table}</code>.
* For more information on example topic, see table 4.1.

=== Using HTML links ===

Use <code>\htmladdnormallink</code> for external references that are not included in the Maemo bibliography database. Notice that link text is normal LaTeX text and characters <code>_$#%{}^~</code> need to be handled with special marking but URL can be any normal HTTP link.

For example:

* For more information on example topic, see <code>\htmladdnormallink{maemo.org}{http://www.maemo.org}</code>.
* For more information on example topic, see [http://www.maemo.org maemo.org].

=== Using Maemo bibliography database ===

Use <code>\cite</code> for external references from Bibliography database. All references to external documents that are other than product version specific documents (documents that are not expected to change regularly) must use Maemo bibliography database. Use LaTeX tag <code>\htmladdnormallink</code> for references to product version specific documents.

Give document name in ''Italics'' before citation from bibliography database and join document name and citation together with tilde (~). Tilde prevents LaTeX to break row between document name end and citation link.

For example:

* For more information on example topic, see document <code>\textit{Maemo Documentation Guidelines}</code><code>~\cite{bibliography-key}</code>.
* For more information on example topic, see document ''Maemo Documentation Guidelines'' <ref name=r4>Maemo Documentation Guidelines. http://library.maemodocs.nokia.com</ref>.
* For more information on example topic, see document <code>\textit{Maemo Documentation Guidelines}</code><code>~\cite[Formatting in LaTex]{bibliography-key}</code>.
* For more information on example topic, see document ''Maemo Documentation Guidelines'' [[/node7.html#maemo-documentation-guidelines 4], Formatting in LaTex].

=== Using normal tables ===

Use <code>\tabular</code> and <code>\table</code> to create tables. For example to create a table with two half-page-wide columns that can expand to new lines, use the following definition:

<source lang="latex">
\begin{tabular}{|p\{0.5\textwidth}|p{0.5\textwidth}|}
</source>

To set the width for the whole table, use <code>{tabular*}</code> with option <code>\textwidth</code><nowiki>: </nowiki>

<source lang="latex">
\begin{tabular*}{\textwidth}{|c|p{0.5\textwidth}|}
</source>

To reduce column width use <code>@{}</code><nowiki>: </nowiki><code>\begin{tabular}<nowiki>
{|@</nowiki>{}c@{}<nowiki>|c|}</nowiki></code>.

To add horizontal lines between cells, use <code>\hline</code>. To separate cells, use <code>&</code>. To change row, use <code>\\</code>.

Use option <code>[H]</code> for table environment if LaTeX cannot change the position of the table related to base text: <code>\begin{table}[H]</code>.

All tables must be centered and have both a caption and a label.

For example:

<source lang="latex">
\begin{table}[H]
 \caption{Example normal table}
 \label{tab:example-chapter-title-example-table}
 \centering
 \begin{tabular}{|p{0.45\textwidth}|p{0.45\textwidth}|}
 \hline\hline
 \textbf{Column 1} & \textbf{Column 2} \\
 \hline
 % Table data starts from here
 %
 1 & 2 \\ \hline
 3 & 4 \\ \hline
 5 & 6 \\ \hline
 \hline
 \end{tabular}
\end{table}
</source>

{| class="wikitable"
|+ Table 4.1: Example normal table
|-
! Column 1
! Column 2
|-
| 1
| 2
|-
| 3
| 4
|-
| 5
| 6
|}

=== Using multi-column table rows ===

Use <code>\multicolumn</code> to widen a table row to cover multiple columns. Avoid using multi-column cells for other purposes than creating subheadings for the table. If complex tables are needed create them outside LaTeX as images.

For example:

<source lang="latex">
<code>\multicolumn{2}{|l|}{\textbf{\textit{Table SubHeader}}} \\ \hline
</source>

{| class="wikitable"
|+ Table 4.2: Example multicolumn table
|-
! Column 1
! Column 2
|-
| colspan="2" align="left" | '''''SubHeader Left'''''
|-
| 1
| 2
|-
| colspan="2" aling="center" | '''''SubHeader Center'''''
|-
| 3
| 4
|-
| colspan="2" align="right" | '''''SubHeader Right'''''
|-
| 5
| 6
|}

=== Using long tables ===

Use <code>{center}</code> and <code>{longtable}</code> environments to create tables that require multiple pages. For example, to create a table with two half-page-wide columns that can expand to new lines, use the following definition:

<source lang="latex">
\begin{longtable}{|p{0.45\textwidth}|p{0.45\textwidth}|}
</source>

To reduce column width use <code>@{}</code>:
<source lang="latex">
\begin{longtable}{|@{}c@{}|c|}
</source>

To add horizontal lines between cells, use <code>\hline</code>. To separate cells, use <code>&</code>. To change row, use <code>\\</code>.

All tables must be centered and have both a caption and a label.

For example:

<source lang="latex">
\begin{center}
 \begin{longtable}
{|p{0.45\textwidth}|p{0.45\textwidth}|}
 \caption{Example long table}
 \label{tab:example-chapter-title-example-long-table}
 % FirstHead
 \hline\hline
 \textbf{Column 1} &amp; \textbf{Column 2} \\ \hline
 \endfirsthead
 % Head
 \hline\hline
 \multicolumn{2}{|l|}{\small\tablename \thetable{}
 Continued from previous page} \\
 \hline\hline
 \textbf{Column } &amp; \textbf{Column 2} \\ \hline
 \endhead
 % Foot
 \multicolumn{2}{|r|}{\small\tablename \thetable{}
 Continued to next page} \\
 \hline
 \endfoot
 % LastFoot
 \hline\hline
 \endlastfoot
 % Table data starts from here
 %
 1 & 2 \\ \hline
 3 & 4 \\ \hline
 5 & 6 \\ \hline
 ... & ... \\ \hline
 \end{longtable}
\end{center}
</source>

{| class="wikitable"
|+ Table 4.3: Example long table
|-
! Column 1
! Column 2
|-
| 1
| 2
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 0
|-
| 1
| 2
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 0
|-
| 1
| 2
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 0
|-
| 1
| 2
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 0
|-
| 1
| 2
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 0
|-
| 1
| 2
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 0
|-
| 1
| 2
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 0
|-
| 1
| 2
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 0
|-
| 1
| 2
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 0
|-
| 1
| 2
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 0
|-
| 1
| 2
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 0
|-
| 1
| 2
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 0
|-
| 1
| 2
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 0
|-
| ...
| ...
|}

=== Reducing the size of tables and figures ===

You can reduce the size of tables and figures that do not fit on the page without scaling them down.

{|
|-
| [[Image:dialog-information.png]]
| '''Note:'''  Scaling and rotating does not work with tables, and reducing font size does not work with figures.
|}

If the object is too long or wide, you can:

* reduce the size of the table font
* rotate the figure
* scale down the figure

==== Reduce the size of the table ====

To reduce the size of the table use the font size command inside the table environment to reduce the size of the table font. Font size commands in order from biggest to smallest are:

Huge, huge, LARGE, Large, large, normalsize, small, footnotesize, scriptsize and tiny.

==== Rotate and scale down a figure ====

To fit on the page, figures in Maemo documents are recommended to have maximum size of 600 x 1200 (width x height) pixels. If a figure is bigger than this, it needs to be rotated, scaled down, or both rotated and scaled down before it can be used. Maemo documentation infrastructure provides a command line tool for automatic figure rotation and scaling.

For Maemo documents figures wider than 340 pixels must be scaled down in LaTeX to fit to the default page width used in PDF documents. Figures wider than 600 pixels or higher than 1200 pixels are recommended to be scaled down with maemodoc-scaleimage command line tool for them to be readable also in HTML documents.

Figures which are smaller than 340 x 1200 (width x height) pixels do not need to be scaled down either in LaTeX or with maemodoc-scaleimage tool.

For example, the following command scales a figure down to the recommended maximum width and height.

$ ./maemodoc-scaleimage <image_file> -outpath <output directory>

The following command rotates the figure 90 degrees anticlockwise if doing so reduces the amount of scaling needed. The command scales down the figure to the recommended maximum width and height only if the figure after rotation still does not fit on the page.

$ ./maemodoc-scaleimage <image_file> -outpath <output directory> -rotate

== References ==

[[Category:Documentation]]

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Templates used on this page:

Template:Ambox (view source) (semi-protected)

Retrieved from "https://wiki.maemo.org/Documentation/Maemo_Documentation_Guidelines/Formatting_in_LaTeX"

Personal tools

Navigation

Views

Editing Documentation/Maemo Documentation Guidelines/Formatting in LaTeX

@@ Line 1: / Line 1: @@
 This chapter includes information about how to format Maemo documentation text in LaTeX environment.
-Basic instructions on how to use LaTeX can be found here in the [[wikibooks:LaTeX|LaTeX Wikibook]]
+Basic instructions on how to use LaTeX can be found here: [http://en.wikibooks.org/wiki/LaTeX/ WikiBooks LaTex].
 To be able to create a reference to a specific element in a document, you must label that element with the unique LaTeX special characters and especially spaces in the label name. Position <code>\label</code> tag on the next row after the referenced element tag (like <code>\section</code>).
@@ Line 11: / Line 11: @@
 === Using list of tables ===
-Use <code>\listoftables</code> to create a list of tables automatically. Used for PDF documents to get a more book-like result.
+Use <code>\listoftables</code> to create a list of tables automatically. Used for PDF documents to get a more book like result.
 === Using list of figures ===
@@ Line 27: / Line 27: @@
 Both <code>\textraw</code> and <code>\verb</code> will display given text in an appropriate fixed-width font.
-{{ambox|text=<code>\textraw</code> is a Maemo-specific definition and is usable only in the Maemo environment.}}
+{|
+|-
+| [[Image:dialog-information.png]]
+| '''Note:'''  <code>\textraw</code> is a Maemo-specific definition and is usable only in the Maemo environment.
+|}
 For example:
@@ Line 93: / Line 97: @@
 Use <code>{graybox}</code> environment for command line and screen output examples that require more than one row.
-{{ambox|text=<code>{graybox}</code> is a Maemo-specific definition and is usable only in the Maemo environment.}}
+{|
+|-
+| [[Image:dialog-information.png]]
+| '''Note:'''  <code>{graybox}</code> is a Maemo-specific definition and is usable only in the Maemo environment.
+|}
 Explicit new lines (<code>\\</code>) need to be given inside <code>{graybox}</code> environment to separate different rows. LaTeX special characters (<code>_$#%{}^~{}</code>) need to be handled in text with special marking unless they are used inside <code>\verb</code> command.
@@ Line 114: / Line 122: @@
 Use <code>{notebox}</code> environment for notes that require whole sentence or paragraph to be highlighted.
-{{ambox|text=<code>{notebox}</code> is a Maemo-specific definition and is usable only in the Maemo environment.}}
+{|
+|-
+| [[Image:dialog-information.png]]
+| '''Note:'''  <code>{notebox}</code> is a Maemo-specific definition and is usable only in the Maemo environment.
+|}
 Explicit new lines (<code>\\</code>) need to be given inside <code>{notebox}</code> environment to separate different rows. LaTeX special characters (<code>_$#%{}^~{}</code>) need to be handled in text with special marking unless they are used inside <code>\verb</code> command.
@@ Line 126: / Line 138: @@
    <code>\end{notebox}</code>
-{{ambox|text=This is note text inside a yellow box<br/><span><font face="monospace">Second line in TextRaw</font></span><br/>Third line has underscore (character '_') and dollar sign (character '$')
+{|
+|-
+| [[Image:dialog-information.png]]
+| '''Note:'''  This is note text inside a yellow box <br> <span><font face="monospace">Second line in TextRaw</font></span> <br>Third line has underscore (character '_') and dollar sign (character '$')
+|}
 === Using code listings ===
@@ Line 172: / Line 188: @@
 === Using figures ===
-Use <code>\includegraphics</code> for figures without a file name extension. For example, use <code>image_file_name</code> instead of <code>image_file_name.png</code>.
+Use <code>\includegraphics</code> for figures without a file name extension. For example, <span><font face="monospace">use image_file_name</font></span> instead of <span><font face="monospace">image_file_name.png</font></span>.
 Use option <code>[H]</code> for figure environment if the position of the figure related to base text cannot be changed by LaTeX . For example <code>\begin{figure}[H]</code>.
-{{ambox|text=Use <code>maemodoc-scaleimage</code> command line tool to scale down figure files that are bigger than recommended maximum size of 600 × 1200 (width × height) pixels. Use option <code>[width=\textwidth]</code> when including figures in LaTeX that are wider than 340 pixels.
+{|
+|-
+| [[Image:dialog-information.png]]
+| '''Note:'''  Use <span><font face="monospace">maemodoc-scaleimage</font></span> command line tool to scale down figure files that are bigger than recommended maximum size of 600 x 1200 (width x height) pixels. Use option <code>[width=\textwidth]</code> when including figures in LaTeX that are wider than 340 pixels.
 |}
@@ Line 190: / Line 209: @@
    <code>\end{figure}</code>
-<div id="figure-example_picture">
+{| summary="Example picture"
-[[Image:LaTeX_logo.png|frame|center|alt=LaTeX logo|'''Figure 4.1:''' Example picture]]
+|+ align="BOTTOM" |'''Figure 4.1:''' Example picture
-</div>
+|-
+|
+[[Image:LaTeX_logo.png|Image LaTeX_logo]]
+|}
 === Combining small tables and figures ===
@@ Line 243: / Line 265: @@
 * For more information on example topic, see figure <code>\ref{fig:example-chapter-title-example-picture}</code>.
-* For more information on example topic, see figure [[#figure-formatting-in-latex-example-picture|4.1]].
+* For more information on example topic, see figure [[#fig:formatting-in-latex-example-picture|4.1]].
 === Referring to a table ===
@@ Line 267: / Line 289: @@
 Use <code>\cite</code> for external references from Bibliography database. All references to external documents that are other than product version specific documents (documents that are not expected to change regularly) must use Maemo bibliography database. Use LaTeX tag <code>\htmladdnormallink</code> for references to product version specific documents.
-Give document name in ''Italics'' before citation from bibliography database and join document name and citation together with tilde (~). Tilde prevents LaTeX from breaking the row between document name end and citation link.
+Give document name in ''Italics'' before citation from bibliography database and join document name and citation together with tilde (~). Tilde prevents LaTeX to break row between document name end and citation link.
 For example:
@@ Line 274: / Line 296: @@
 * For more information on example topic, see document ''Maemo Documentation Guidelines'' <ref name=r4>Maemo Documentation Guidelines. http://library.maemodocs.nokia.com</ref>.
 * For more information on example topic, see document <code>\textit{Maemo Documentation Guidelines}</code><code>~\cite[Formatting in LaTex]{bibliography-key}</code>.
-* For more information on example topic, see document ''Maemo Documentation Guidelines'' [[{{PAGENAME}}|Formatting in LaTex]].
+* For more information on example topic, see document ''Maemo Documentation Guidelines'' [[/node7.html#maemo-documentation-guidelines 4], Formatting in LaTex].
 === Using normal tables ===
@@ Line 284: / Line 306: @@
 </source>
-To set the width for the whole table, use <code>{tabular*}</code> with option <code>\textwidth</code>:
+To set the width for the whole table, use <code>{tabular*}</code> with option <code>\textwidth</code><nowiki>: </nowiki>
 <source lang="latex">
@@ Line 290: / Line 312: @@
 </source>
-To reduce column width use <code>@{}</code>: <code>\begin{tabular}
+To reduce column width use <code>@{}</code><nowiki>: </nowiki><code>\begin{tabular}<nowiki>
-<nowiki>{|@{}c@{}|c|}</nowiki></code>.
+{|@</nowiki>{}c@{}<nowiki>|c|}</nowiki></code>.
 To add horizontal lines between cells, use <code>\hline</code>. To separate cells, use <code>&</code>. To change row, use <code>\\</code>.
@@ Line 357: / Line 379: @@
 | 2
 |-
-| colspan="2" align="center" | '''''SubHeader Center'''''
+| colspan="2" aling="center" | '''''SubHeader Center'''''
 |-
 | 3
@@ Line 632: / Line 654: @@
 You can reduce the size of tables and figures that do not fit on the page without scaling them down.
-{{ambox|text=Scaling and rotating does not work with tables, and reducing font size does not work with figures.}}
+{|
+|-
+| [[Image:dialog-information.png]]
+| '''Note:'''  Scaling and rotating does not work with tables, and reducing font size does not work with figures.
+|}
 If the object is too long or wide, you can:
@@ Line 644: / Line 670: @@
 To reduce the size of the table use the font size command inside the table environment to reduce the size of the table font. Font size commands in order from biggest to smallest are:
-<code>Huge</code>, <code>huge</code>, <code>LARGE</code>, <code>Large</code>, <code>large</code>, <code>normalsize</code>, <code>small</code>, <code>footnotesize</code>, <code>scriptsize</code> and <code>tiny</code>.
+<span><font face="monospace">Huge</font></span>, <span><font face="monospace">huge</font></span>, <span><font face="monospace">LARGE</font></span>, <span><font face="monospace">Large</font></span>, <span><font face="monospace">large</font></span>, <span><font face="monospace">normalsize</font></span>, <span><font face="monospace">small</font></span>, <span><font face="monospace">footnotesize</font></span>, <span><font face="monospace">scriptsize</font></span> and <span><font face="monospace">tiny</font></span>.
 ==== Rotate and scale down a figure ====
-To fit on the page, figures in Maemo documents are recommended to have maximum size of 600 × 1200 (width × height) pixels. If a figure is bigger than this, it needs to be rotated, scaled down, or both rotated and scaled down before it can be used. Maemo documentation infrastructure provides a command line tool for automatic figure rotation and scaling.
+To fit on the page, figures in Maemo documents are recommended to have maximum size of 600 x 1200 (width x height) pixels. If a figure is bigger than this, it needs to be rotated, scaled down, or both rotated and scaled down before it can be used. Maemo documentation infrastructure provides a command line tool for automatic figure rotation and scaling.
-For Maemo documents figures wider than 340 pixels must be scaled down in LaTeX to fit to the default page width used in PDF documents. Figures wider than 600 pixels or higher than 1200 pixels are recommended to be scaled down with <code>maemodoc-scaleimage</code> command line tool for them to be readable also in HTML documents.
+For Maemo documents figures wider than 340 pixels must be scaled down in LaTeX to fit to the default page width used in PDF documents. Figures wider than 600 pixels or higher than 1200 pixels are recommended to be scaled down with <span><font face="monospace">maemodoc-scaleimage</font></span> command line tool for them to be readable also in HTML documents.
-{{ambox|text=Use <span><font face="monospace">maemodoc-scaleimage</font></span> command line tool to scale down figure files that are bigger than recommended maximum size of 600 × 1200 (width × height) pixels. Use option <code>[width=\textwidth]</code> when including figures in LaTeX that are wider than 340 pixels.}}
+{|
+|-
+| [[Image:dialog-information.png]]
+| '''Note:'''  Use <span><font face="monospace">maemodoc-scaleimage</font></span> command line tool to scale down figure files that are bigger than recommended maximum size of 600 x 1200 (width x height) pixels. Use option <code>[width=\textwidth]</code> when including figures in LaTeX that are wider than 340 pixels.
+|}
-Figures which are smaller than 340 × 1200 (width × height) pixels do not need to be scaled down either in LaTeX or with <code>maemodoc-scaleimage</code> tool.
+Figures which are smaller than 340 x 1200 (width x height) pixels do not need to be scaled down either in LaTeX or with <span><font face="monospace">maemodoc-scaleimage</font></span> tool.
 For example, the following command scales a figure down to the recommended maximum width and height.