OOo Off the Wall: The Outlining and the Ecstasy
Outlining is the arrangement of sections within documents. The process of outlining includes re-positioning paragraphs and making decisions about what level in the hierarchy a heading should be.
Outlining is not writing, but it is a core part of the writing process. Despite this fact, many people begin to write with almost no outlining. Perhaps they are in a hurry to get started. Perhaps, if they attended high school in North America, they think of an outline as something they cobbled together after they finished writing the paper simply to satisfy a teacher's arbitrary demands. Whatever the reason, many people plunge into a document and discover its structure as they write. This practice usually is inefficient, because they are trying to do two things at the same time, write and organize. They don't know where they are going, which makes writing a prolonged and painful process.
It is true that a handful of professional writers never outline or outline only long and complex documents. Far more professionals, however, use some sort of outlining technique. For some, the physical act of writing accounts for as little as 10 to 20% of the time spent on a document. The rest is spent outlining and editing.
Judging from the habits of most professionals, then, outlining benefits most writers. However, each writer needs to discover how much outlining he or she need to do and what form that outlining should take. Sometimes, an outline can be a simple scribbled list or a brainstorming session on a white board. At other times, it's a formal document with headings and subheadings.
For those who prefer the formal approach, OpenOffice.org's Writer program offers a de-centralized set of tools. Writer uses:
Paragraph styles, specifically headings, to set up the overall structure of the document.
Tools > Outline Numbering, which sets up outlining for use within a document.
The Navigator (Edit > Navigator) for actual outlining.
Users of MS Word often leap to the conclusion that Writer has no outlining tools. In fact, Writer does have such tools, but they are arranged and function differently. Out-of-the-box (or out of the tar file), the tools are less functional than MS Word's, but with a little ingenuity, you can wrench almost the same functionality out of them.
The purpose of outlining is to structure your document. That means your document's format also needs to be structured if you are going to outline in Writer. And that, in turn, means using heading paragraph styles. If you format manually, there simply isn't enough consistency for Writer's outlining tools to work with.
Heading styles, numbered 1-10, are intended to indicate levels of organization. In other words, a heading at a higher level should contain the subject matter of a heading at a lower level. To give a simple example, if a document discusses the solar system, then the second-level headings might name individual planetary systems. Below the headings for planetary systems, the next level of headings might be each planet's moons.
Writer recognizes all other paragraphs as belonging to the same topic until the next heading at the same level appears. If the heading is moved during outlining, so are the other paragraphs, including any subheadings.
By contrast, the most you can do in a manually formatted document is single-style outline numbering (see "It's Numbering, But Not As We Know It". Single-style outlining is useful in the early stages of planning, when you have no content. But, if you find formal outlines useful in the first place, single-style outlining probably is too limited for you. Although you can promote or demote paragraphs easily enough by using Tab and Tab+Shift, moving sections of text requires you to copy and paste. Although you can get by using these methods, you'll probably find that copying and pasting distracts you from thinking about the structure of your document. In addition, a single-style outline ordinarily is not visible in the Navigator.
Here's where it gets confusing. If you use styles in Writer, you probably know that numbering styles can be applied to paragraph styles. Yet, in addition to numbering styles, Writer has a second system for numbering paragraph styles, located in Tools > Outline Numbering. I call this system multi-style outlining, as opposed to single-style outlining. Both are called outline numbering, yet the two systems are completely independent of each other.
Then, to make matters worse, multi-style outlining uses paragraph styles that it describes as levels. By default, these levels correspond to the paragraph styles Heading 1-10--but they don't have to. Moreover, if any of the paragraph styles used in multi-style outlining are formatted using paragraph styles, or even if a manually formatted list uses the headings, Tool > Outlining is overridden and has no effect whatsoever.
Why does Writer work this way? Why does the software encourage the use of paragraph styles in every other way and then muddy the waters with Tools > Outlining? The answer is simple:
My theory is Tools > Outlining was added by a programmer ignorant of styles back in the Jurassic Age when OpenOffice.org was StarOffice and owned by StarDivision. That is only a guess, but what else explains the duplication?
It may help if you think of Tools > Outlining as a means of managing how styles are used by other tools throughout Writer rather than as a means of setting style characteristics. Multi-style outlining sets the styles used:
to create a table of contents with Insert > Indexes and Tables.
to create an autoabstract by using File > Send > Create AutoAbstract. An autoabstract is a summary of the document in a separate file. By default, it shows the first paragraph beneath each heading. You also can select File > Send > AutoAbstract to Presentation, but you should read about the role its MS Word counterpart, the Autocontent Wizard, played in making the Gettysburg PowerPoint Address before using this feature. You may decide that this feature, like a grammar checker, can do more harm than good.
to add a chapter number in a cross-reference or to insert the chapter name automatically using Insert > Fields. The chapter number or name is read from the last occurrence of the paragraph style assigned to Level 1 in Tools > Outlining.
By default, the numbers assigned to each level's style are formatted the same as the rest of the paragraph. If you choose, though, you can use the Character Style on the Numbering tab of Tools > Outlining to give them a different format. You also can insert a separator automatically, such as a period or a parentheses before or after the number, as well as the numbering system, the starting number and the position and spacing for the number.
Perhaps the most important setting is the paragraph style. Because Tools > Outlining has ten levels and uses Headings 1-10 by default, you can be lulled into thinking no other arrangement is possible. The truth is, you can assign any paragraph style to any level. Because you rarely need more than four levels of headings, you can assign the main body text to one level and have it displayed in the Navigator. You can't read all of the body paragraph, though, because the Navigator uses a single line for each level. Most headings are short, so that's all that normally is needed. But by dragging the Navigator window wider, you should be able to see enough that you can work with the body text. Be sure, however, that the level to which the body text style is assigned isn't included when you set up a table of contents.
If outlining features in your work methods, create a template in which multi-style outline numbering is set up. However, be careful to include text that uses each of the outline levels have configured. Through some oversight, multi-style outline settings are not preserved in a template unless they actually are used.
-- Bruce Byfield (nanday)
Getting Started with DevOps - Including New Data on IT Performance from Puppet Labs 2015 State of DevOps Report
August 27, 2015
12:00 PM CDT
DevOps represents a profound change from the way most IT departments have traditionally worked: from siloed teams and high-anxiety releases to everyone collaborating on uneventful and more frequent releases of higher-quality code. It doesn't matter how large or small an organization is, or even whether it's historically slow moving or risk averse — there are ways to adopt DevOps sanely, and get measurable results in just weeks.
Free to Linux Journal readers.Register Now!
- August 2015 Issue of Linux Journal: Programming
- Django Models and Migrations
- Hacking a Safe with Bash
- Secure Server Deployments in Hostile Territory, Part II
- The Controversy Behind Canonical's Intellectual Property Policy
- Huge Package Overhaul for Debian and Ubuntu
- Shashlik - a Tasty New Android Simulator
- KDE Reveals Plasma Mobile
- Embed Linux in Monitoring and Control Systems
- diff -u: What's New in Kernel Development