Main Page

From Audacity Development Manual
Revision as of 18:50, 27 November 2009 by JamesCrook (talk | contribs) (Changed order as per Bill's suggestion.)
Jump to: navigation, search

Welcome, Audacity manual editors!

This is both the front page of the online manual, and of the local/zipped manual. Anything which is not directly or indirectly linked from this page (is a link on a page that is linked from this page) will not appear in the local/zipped manual. Image pages will not appear in the local/zipped manual, nor will pages outside the manual/audacityteam.org/ domain.

In a previous script (currently broken/out-of-use), the printed manual was assembled by concatenating all of the articles found on this page, in this order. Links to another page, like [[File Menu]], became page references in the PDF, e.g. File Menu (Page 73). External hyperlinks, like [http://example.com Example Website], appeared in the text as Example Website1 with a footnote containing the URL. We used <div class="nochapternumber"></div> at the top of an article if it was an introductory chapter in the printed manual (Copyright, Appendix, etc.). The printed manual was updated on the Export page.

  • Put <div class="noexport"></div> or <div class="editornote"></div> around text or a page to exclude it from the local/zipped and printed manual.
  • Put <div class="note"></div> around text for text inside a box. This appears in all versions of the manual.

Please read Editing Help to learn about wiki text formatting.

We should try to be consistent in terms of wording and page layout. Layout issues for some page families are still being discussed. See Consistency for current suggested guidelines.

Images: Please ensure all images have appropriate ALT-text. This should be something that describes the contents of the image in the context of its surrounding text for someone who cannot see it.

Audacity Logo

This manual is a work in progress. It relates to the Beta 1.3.9 program, not 1.2.5/6! Audacity 1.3.9 is the basis for our upcoming 2.0 stable release of Audacity.

There are no translations of this Manual to other languages yet. Try here for help in other languages.

Can you help us complete the Manual, or translate it to other languages? If so, please e-mail Gale (gale_AT_audacityteam_DOT_org)

For ideas on what needs to be done to
move the manual forward, see the ToDo page.
The Audacity Manual (current at time of release) is included in version 1.3.9 if you obtain the Windows .exe or Mac OS X .dmg Audacity installers.

To view the Manual, click Help > Manual (in web browser), or Help > Quick Help (in web browser) to access the "Getting Started" section of the manual. This will load the local Manual files in your web browser, without the need for an internet connection.

If you have obtained the zip version of Audacity or are on Linux, you can download the same Manual here. Instructions are here.

Audacity 1.3.9 User Manual

Printed Manual Only

The following links will not be visible to logged-out online or in the dumped (installed) manual:

Excluded from printed and online Manual

The following old/experimental pages will be excluded from both the printed manual and from the front page of the logged-out online/installed manual. They can still be found online through Search):


About this Manual

The Manual is divided into several sections.

If you're in a hurry, try:

  • Audacity for the Impatient - Schematic diagram of Audacity with quick links to the main parts of the interface.
  • Getting Started - Quick help to get you recording, importing files, editing and exporting your work in no time.


Otherwise, the Manual contains:

This manual has two main parts to it:

  • A step by step guide. Organised by tasks (the Tutorials and the Using Audacity sections).
  • A reference section. Organised by GUI structure.

The reference section should be naming the parts of the GUI and saying in outline what they do. The reference section needs to be complete for 2.0. I think it's OK if we don't finish all the tutorials, and drop the ones which are incomplete from the html help. JC

Follow links from Special:Lonelypages and Old Pages to find remnants of the old manual.


Tutorials


Using Audacity

Foundations:


Help with Advanced Issues:

Should include the JAWS guide (ready now). Write a short paragraph linking to Audacity Tracks and Clips, the Selection Toolbar etc.
Is this the best place for "Audio CDs"??


Wanted Topics:

The Wanted Topics are in a 'noexport' section. Suggest we don't start writing them yet. They're not essential for 1.4.0.
  • Spectrogram Analysis (or one or more better titles, cover tracking down clicks, square wave as-a-spectrum, beat frequencies).


Reference

With hindsight, having the page links between pipes really isn't working, at least for me. I often want to go to effects but it takes way too long to figure where it is. I think we must prioritise a proper side-by-side design after 2.0 - Gale


Project Window:

The main area where tracks are mixed together (Overview).


Main Menu:

All commands for importing, recording, manipulating and exporting audio (Overview).

Suggest we lose this link. - Bill


Toolbars:

Buttons and controls for playback, recording and editing (Overview)

  • Extra help with Envelope Tool for controlling amplitude changes smoothly, and Multi-Tool (combining all tools in one)


Preferences:

The numerous options to customise Audacity (Overview).


Miscellaneous

Index, Glossary and Frequently Asked Questions:


Credits, License and Further Information:




Links: Most links are to other pages in this Manual. Bold italicized  links are to a description in our Glossary. Other italicised  links are to pages external to this Manual, for whose content we are not responsible.

Screenshots: Unless otherwise noted in the hover text of the image, all screenshots of Audacity in the Manual are of Microsoft Windows® operating systems.

Copyright: Unless otherwise noted, all pages on this site are available under the terms of the Creative Commons Attribution 3.0 license. In essence, you are free to (1) copy, distribute and transmit the work (2) to adapt the work, under condition you must attribute the work to the authors (but not in any way that suggests that they endorse you or your use of the work). For any reuse or distribution, you must make clear to others the license terms of this work. Any of the above conditions can be waived if you get permission from us.