DITA Structured Writing Sample


Following is some of my Darwin Information Typing Architecture (DITA) work. This example is an adaptation of the opening section of my book Live Sound for Musicians. You can see the raw text from my original manuscript a little further down on this page.

I took my original, linear text and broke it into standard DITA topics: concepts, tasks or references. I then built a DITA map and reltable to define the document structure and automatically generated "related…" links. Finally, I used DITA's export functionality to create a set of HTML5 files and a PDF document. Both these outputs are built from the same DITA source.

Click here to jump into the collection of DITA-generated HTML5 files.

Click here to open the single DITA-generated PDF file.



Original Manuscript Text

What is a sound system for? Most simply, it makes soft sounds louder and projects them to listeners who would otherwise be too far away to hear them comfortably. This purpose is at the root of the name “public address system,” or PA, as sound systems are often called—a person can stand up and “address the public” with a sound system that amplifies their voice.
The same holds true for music. A PA allows you to play for a much larger audience than you could reach without amplification.
However, the needs of each performance vary. For example, dance bands use amplification to motivate their audiences to get up and move. In this case, the sound system becomes an integral part of the act—No PA? No show. On the other hand, a string quartet may need a little volume boost in a large hall, but they’d be fine without a PA in a smaller room.
This brings us to an important point: The use of a sound system should always complement the performance. Every performance is different, and it’s very important to adopt a flexible attitude when it comes to dealing with each event. There is no “right way” to do sound, just the best choices (or compromises) for the circumstances at hand.
Think of live sound as a three legged stool. One leg is the needs of the audience, one is the needs of the musicians, and the third leg is the demands of the room. For best results, all three different needs must be met. Ignoring any one of these three areas can result in a performance that falls flat!
The Tasks
So, projecting a louder sound to an audience is our goal. But how can we break this up into individual steps? Easy. All sound systems must perform the same three basic tasks:
• Pick up the original individual sounds (usually with microphones)
• Combine, or “mix,” these sound sources and amplify them
• Play the mix through speakers for the audience, or “house.”
Before we look at these tasks in detail, one point must be made. We hear by sensing vibrations, or “waves,” in the atmosphere. But sound systems work by manipulating little electrical signals. So, a fundamental task of sound systems is that the musical noise we make (with our voices or instruments) must be converted into electrical signals, processed by the sound system and then converted back into sound (using loudspeakers) for the audience.
In the next section of this book, we’ll look at the three tasks above, but in more detail. As you’ll learn, most of the difficulties in live sound are caused by the conversion between sound waves and electrical signals.
Picking Up the Original Sounds
This is the first and most fundamental task of any sound system. After all, if the purpose is to make an existing sound louder, we must begin by capturing the original sound. The most common tool used to capture sound is the microphone. The mic hears sounds in the air (sort of like your ear does), and converts the sound into an electrical signal.
Not all instruments require microphones—some produce an electrical signal themselves. For instance, you can hear the plinking strings of an unplugged electric guitar, but the main sound from that instrument comes from pickups, which generate their own electrical signal from the strings’ sound. Other instruments, like electronic synthesizers directly, create their “sound” as an electronic signal.
So, depending on what kind of instruments you are involved with, you may be using more than just microphones. However, almost every amplified performance uses at least a few mics, so we’ll focus on them in the first part of this book.
Mixing and Amplifying Sounds
A sound system must usually accommodate more than one sound source. Even if you’re a solo guitarist/singer, you must be able to blend, or “mix,” two sounds: your voice and instrument. For larger groups, the number of sounds to be mixed will be many more.
Combining the electrical signals of the individual sounds is done by a mixing board, or mixer. A mixer’s knobs are used to balance the volume of all the different sounds connected to it, so that the desired musical blend is heard by the audience.
The mixer doesn’t produce sound waves—just another electrical signal that represents the blend of all the connected microphones or other instruments. But before this signal can be connected to speakers, its power must be substantially boosted.
Boosting the signal is the task of the amplifier. Also called a power amp, this device takes the low-power signal that comes from the mixer and boosts it enough to operate the speakers.
While the microphones, mixer and speakers are always easy to spot in any sound system, the power amplifiers may not be so apparent. While some power amps are housed in their own cases, amps are often built into to the mixer’s case (creating a “powered-mixer”). Sometimes, manufacturers will build the amp right into speaker cabinets, creating “powered speakers.”
Turning the Mix Back Into Sound
The final task of the sound system is to turn the electrical signal back into sound that the audience hears. This is done by loudspeakers. Within the speaker enclosure, the speakers themselves move back and forth in response to the amplifier’s output signal. This physical motion creates ripples of air pressure, and we perceive the result as sound. And, thanks to the amplification provided by the sound system, the results can be much louder than the original sound was.
What’s the Catch?
The problem, as was hinted before, is in the conversion to and from air. Sound waves have so much subtle detail that it’s very difficult to design a mic that captures all their nuances. Also, microphones don’t really “hear” sounds the way our ears do—even good mics can “color” the sound of an instrument, especially if the mic is not properly positioned.
The flip side of the coin is the speakers. Again, the task of translating the complex electrical signal into an accurate motion in the air is demanding. The loss of accuracy in the translation can result in bad sound. And, just as microphones don’t pick up all sounds the way they originally occur, loudspeakers don’t necessarily project sound the same way that the original instruments do. The result can be “uneven coverage,” meaning that the final sound may be good for those sitting in front of the speakers but not-so-good for the audience off to the sides.
Review
OK, time for a quick review: The purpose of a sound system is to make a quiet sound louder. To do this, you must first capture the original sound (your voice or instrument). This is usually done with a microphone, although some instruments have pickups instead.
The mics or pickups translate the original sound into a faint electrical signal. This is connected to a mixer, which boosts that signal and then lets you balance the levels of all your individual mics. The electrical signal created by the mixer is sent to a power amplifier, which boosts the level of the signal again. This high-power electrical signal is then connected to loudspeakers which turn the signal back into sound for the audience.
Converting sound to and from an electrical signal is difficult; therefore, most of the problems associated with live sound are related to microphones and speakers, and their interaction with the room and the musicians.
Before we go any further, a quick word of caution. There are three basic safety issues related to live sound: hearing protection and conservation, stable positioning of equipment to prevent injury or damage from falling gear, and avoiding electrical hazards. We’ll touch upon each of these from time to time, but it’s beyond the scope of this book to fully address these safety concerns. Education is a continuous process. Seek out people and resources that can increase your knowledge of these crucial topics.
fundamental concepts and terms
As you’ve probably guessed by this book’s casual tone, we’re not going to plunge into the icy waters of mathematical formulas to explain how sound systems work. However, you are going to have to come to grips with a few basic concepts. But fear not! This book is certified Musician-Friendly, 100% math-free.
Sound is pretty simple: An object vibrates. This movement pushes air back and forth, which sends out little ripples of changing air pressure. As these little waves wash up against your ears, your eardrums wiggle back and forth in sympathy. The resulting motion is converted into nerve impulses, which in turn are perceived by your brain as sound.
What makes one sound different from another? Two important things: How fast the vibration is and how vigorous it is. The faster the motion, the higher the pitch we perceive. And the greater the back-and-forth motion, the louder the resulting sound.
The technical terms for these two fundamental properties of a sound are amplitude or level, which describes how loud something is, and frequency, which you may consider analogous to pitch—higher frequencies make
higher notes.
Level
Anyone who’s played a gig with a rock band has heard the phrase “You guys sound great, but you’re going to have to come WAY down!” Hence the concept of volume, or level: How loud is it? (Several terms are used to describe this, including volume, level and loudness. For our purposes, they are interchangeable.)
A sound’s level is directly related to how vigorously it is vibrating. If something’s barely moving back and forth, it will make very little sound. But if you really whack it, it will vibrate a lot harder. This will move more air and the result will be a louder sound.
Most discussions about volume are relative. For example, “We sound great, but I should be louder!” But how loud is loud? Sound engineers measure the absolute level of a sound, or the difference in level between two sounds, using the “decibel.” You may have seen charts showing the range of human hearing for sounds of different loudness, starting with a quiet room and progressing to lawnmowers, rock concerts, gunshots and jet-plane take-offs. Next to each of these example sounds is a number that shows approximately how loud that particular noise is in decibels.
While you probably won’t ever be asked to adjust your band’s volume to
“96 dB sound pressure level,” professional sound system engineers often work under these restrictions, especially when concerts are held near residential neighborhoods. Using a device called a sound pressure level (SPL) meter, the actual level of sound can be measured. Radio Shack sells a relatively inexpensive (under $75) SPL meter. If you’re curious, this device will give you a much better idea of how loud “loud” is!
Frequency
Besides the loudness of a sound, we are also sensitive to a sound’s frequency. In musical terms, frequency is closely related to pitch. The higher a note’s pitch, the higher its frequency. For instance, hitting a bass drum has a completely different result than hitting a triangle. Since the bass drum vibrates more slowly than the triangle, we hear its sound as being lower
in pitch.
Note that every vibrating object wiggles at more than one single frequency. This explains why you can hear two people singing the same note, yet still be able to tell the performers apart. Both singers produce the same root, or fundamental, frequency when they sing the same pitch. However, every person (or instrument) creates its own blend of other, related frequencies called harmonics. These harmonics are what let us differentiate one singer from another. There are many instrumental examples of harmonics; an exploration of these is left to you as an extra-credit assignment!
Frequency is measured according to how many vibrations (or cycles) are completed in one second (a cycle is one complete vibration, for example, bending outward, bending inward and then bending outward again).
Sound frequency is measured in cycles-per-second or Hertz, abbreviated Hz. The open A string of a guitar (in standard tuning) will vibrate back and forth exactly 110 times in one second.
While you can translate between musical pitch and specific frequencies, you’ll normally use one or the other. When talking about music, you’ll just say “open A,” not “110 Hz.” Similarly, only frequency is used when discussing sound equipment. You will find controls that apply to specific sound frequencies, but these will never reference musical note names. However, you can use your trained musical ear to identify different frequencies by ear. This will be especially important when trying to control feedback (more on this later).
Our Range of Hearing
You know from experience that we can hear very low and very high-pitched tones. The typical range of human hearing (in younger people) is from 20 cycles per second to 20,000 cycles per second (which is often abbreviated 20Hz-20kHz).
It is convenient to break this “frequency spectrum” into smaller ranges or “bands” to help us talk more specifically about what we are hearing. The simplest division is to split our range of hearing into three parts: bass or “lows,” midrange or “mids,” and treble or “highs.” Your sound system must be able to reproduce each of these three frequency bands with reasonable accuracy.
Midrange Sounds
Let’s start with a quick overview of the all-important midrange. Humans rely heavily on midrange for understanding speech, because this is where the consonant sounds reside. If you can’t hear consonants, it’s very hard to tell the difference between, for instance, “cake” and “ache.”
If you get a hearing test (and you should, every year), you’ll find most audiologists are only interested in testing your low- and midrange-frequency hearing. Think of the telephone. You have no trouble using it to communicate, but listen to how lousy the “on-hold” music sounds. The telephone is all mids, with zero lows and highs.
So, you would be correct to assume that good midrange response is important for a sound system used for the spoken word, or if you want people to understand the words you are singing.
Midrange is important for more than just speech. Many instruments produce a lot of sound in the midrange. Playing these instruments through a sound system lacking mids will not seem very energetic. However, this is rarely a problem: most smaller sound systems tend to have too much midrange response and produce a sound that is abrasive and tiring to listen to for extended periods.
Just remember that our ears are most sensitive to midrange sounds, so it doesn’t take much midrange to wear us out, especially as we get older. Perhaps this is why parents can’t understand why their kids like such loud, blaring music.
Bass or Low-Frequency Sounds
Bass or low-frequency sounds add impact or “oomph” to music, especially modern pop or dance music. I’m sure you are familiar with the types of instruments that generate lots of low-frequency sound, including bass guitars, upright basses, electrical keyboards, larger drums and so on.
A sound system that has good low-frequency response will help motivate an audience to dance. However, this will require a sound system with larger speaker cabinets and more powerful amplifiers.
Conversely, a sound system with poor low-frequency response isn’t a good choice for an amplified dance band trying to beef up their low end. However, for sound systems that are primarily for vocals, lack of extended low frequency “thump” won’t be noticed.
Treble or High-Frequency Sounds
Finally, there are the treble or high frequencies. Remember when I said that most instruments generate sound at more than one frequency at a time? While the fundamental pitch of a guitar’s open A string is a relatively low 110 Hz, that sound is rich in harmonics, additional frequencies in the octaves above the fundamental. The high-frequency range of your PA system will mostly be busy reproducing these harmonics.
A sound system with good, smooth high-frequency response will have a pleasing, open or “airy” quality. One might also call it “hi-fi.” A lack of highs will leave your system sounding somewhat dark, closed or veiled. Most PA speakers don’t have the extreme high-frequency response found in good home-stereo systems, but most will do an adequate job. As always, too much of a good thing is too much of a good thing. Excessive highs can make your system more prone to feedback (more about that later) and also make any background hiss generated by your equipment more obvious to listeners.