A design template for writing technical documentation with LibreOffice Writer.
The design looks the same on Mac OSX, Linux, and Windows as all fonts, colors, etc. are available on all platforms.
All of the styles included in this template are listed below. I did not customize every possible style as I updated the ones that I use when writing technical documentation. Further, I am not a designer. I'm 100% confident that a professional designer make a more attractive template, so please don't hate on my design skills. :)
This repo will not get many pushes as there's little reason to constantly update a template.
Tested on:
- LibreOffice: 4.2
- Ubuntu Linux 14.04, Mac OSX 10.10 (Yosemite), Windows 7
View Example file.pdf to see the template's theme.
The example file has a large amount of formatting on a single page, so it's a lot more colorful than an actual documentation file contains (which as more black).
Installing the template involves downloading the .ott file then saving the
template to your templates directory. The final step is to copy the table
styles file to the LibreOffice config directory.
Setting up the template file involves the same steps on Mac, Linux and Windows.
- Download the Tech Docs Template.ott file to
your
Downloadsfolder. - Navigate to your
Downloadsfolder, then double-click theTech Docs Template.ottfile to open it in Writer. - Select
File, selectTemplates, clickSave As Template.... - In the Template Manager dialog box:
- Double-click
My Templates. - Click
Save. - Enter a template name of
Tech Docs Template(or some other name that you'd like to use for this template). - Click
OK.
- Double-click
Close LibreOffice if it's open.
- Download the autotbl.fmt file to your
Downloadsfolder. - Open a terminal an run the following commands:
# Backup your existing autotbl.fmt file
cp ~/Library/Application\ Support/LibreOffice/4/user/config/autotbl.fmt ~/Library/Application\ Support/LibreOffice/4/user/config/autotbl.fmt-bk
cp ~/Downloads/autotbl.fmt ~/Library/Application\ Support/LibreOffice/4/user/config/autotbl.fmt- Download the autotbl.fmt file to your
Downloadsfolder. - Open a terminal an run the following commands:
# Backup your existing autotbl.fmt file
cp ~/.config/libreoffice/4/user/config/autotbl.fmt ~/.config/libreoffice/4/user/config/autotbl.fmt-bk
cp ~/Downloads/autotbl.fmt ~/.config/libreoffice/4/user/configNote: I'm unable to get the table AutoFormat file to work on Windows.
- Download the autotbl.fmt file to your
Downloadsfolder. - Open Windows Explorer and navigate to
C:/Users/<user name>/AppData/Roaming/LibreOffice/4/user/config. - Make a copy of
autotbl.fmt. - Copy the new
autotbl.fmtfile that you downloaded from theDownloadsfolder to the LibreOfficeconfigfolder:
C:/Users/<user name>/AppData/Roaming/LibreOffice/4/user/config.
Let's start by creating a new document based on our template.
- Open LibreOffice Writer.
- Select
File, selectNew, clickTemplates. - In the Template Manager dialog box:
- Select the
Templatestab. - Double-click
My Templates. - Double-click the
Tech Docs Templatefile.
- Select the
- Select
File, clickProperties. - Select the
Descriptiontab. - Change the
Titlefield. The title is inserted into the footer of every page. - Click
OK.
Default Style: The default font style that is used as the basis for other styles. Also used as the default style in the document.Text Body: Similar toDefault Style.
Title: Document title at the top of 1st page.Heading 1: Level 1 heading. Typically used as a section heading.Heading 2: Level 2 heading. Typically used as a sub-section heading.Heading 3: Level 3 heading.Heading 4: Level 4 heading.Heading 5: Level 5 heading.
Information: Emphasize key points that the reader should learn. Blue.Alert: Highlight warnings and other danger areas. Red.Hint: Provide the reader with tips and tricks. Green.
Code: Highlight large code blocks.
Table Heading: Provides a bold, centered font for table column or row headings.Table Contents: Default font for values places within a table.
Caption -> Image: Small font size to write captions below an inserted image.
Inline Code: Inline code is used to hightlight code placed in the middle of a normal sentence such asy = x - 1.
Graphics -> Image: Centers an image and prevents text wrapping.
Table: Default table style for this template.
Mouse over the icons in the Styles and Formatting pane to view the text tip.
- Press
F11to open the Styles and Formatting pane. - Click the
Paragraph Stylesicon in the Styles and Formatting pane. - Select the text you want to format, then double-click the style you want to apply.
- Press
F11to open the Styles and Formatting pane. - Click the
Character Stylesicon in the Styles and Formatting pane. - Select the text you want to format, then double-click the style you want to apply.
- Select
Insert, selectImage, clickFrom File.... - Select an image, then click
OK. - In the Writer document, select the newly inserted image.
- In the Styles and Formatting pane, click the
Frame Stylesicon. - Double-click
Image. (Hint: IfImageis not visible, then expandGraphics)
- Press
Ctrl + F12(orCmd + F12on Mac) to open the Insert Table dialog box. - Press the
AutoFormatbutton. - Select
Table, clickOK. - Change any other table settings you want to change, then click
Insert.