<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "
http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY app "<application>Drivel</application>">
<!ENTITY appversion "2.0">
<!ENTITY date "May 2005">
<!ENTITY legal SYSTEM "legal.xml">
]>
<article id="index" lang="en">

<articleinfo>
	<title>Drivel Manual</title>
	<date>2009-04-03</date>
	<copyright>
		<year>2005</year>
		<holder>Todd Kulesza</holder>
 	</copyright>
	<publisher>
		<publishername>Todd Kulesza</publishername>
	</publisher>
	&legal;
	<abstract role="description">
		<para>
		User manual for the Drivel journal editor.
		</para>
	</abstract>
	<authorgroup>
		<author role="maintainer">
			<firstname>Todd</firstname>
			<surname>Kulesza</surname>
			<affiliation>
				<orgname>Drivel Development Team</orgname>
				<address>
					<email>todd@dropline.net</email>
				</address>
			</affiliation>
		</author>
	</authorgroup>
	<legalnotice id="feedback">
		<title>Feedback Information</title>
		<para>
			To report a bug or make a suggestion regarding this application
			or this documentation, see the <ulink type="help"
			url="ghelp:gnome-feedback">GNOME Feedback Page</ulink>.
		</para>
	</legalnotice>
<revhistory>
<revision>
  <revnumber>&appversion;</revnumber>
  <date>03 Apr 2009</date>
</revision>
</revhistory>
</articleinfo>

<indexterm zone="index">
	<primary>Drivel</primary>
</indexterm>
<indexterm zone="index">
	<primary>drivel</primary>
</indexterm>

<!-- ============= Introduction ============================== -->
<!-- Use the Introduction section to give a brief overview of what
     the application is and what it does. -->

<sect1 id="drivel-introduction">
	<title>Introduction</title>
	<para>
		&app; allows you to create and edit entries for online journals, commonly known as
		"web logs" or simply "blogs".  Most popular journal servers are supported, including
		Advogato, Atom, Blogger, LiveJournal, and MovableType.  An offline mode is also included
		for writing draft entries.  &app; is able to create new entries, edit or delete existing
		entries, and list the fifteen most recent entries for all of its supported journal systems,
		save Advogato.  The entire LiveJournal feature set, including friends, security groups,
		moods, etc., is also supported, as are MovableType categories.  The integrated editor
		supports HTML syntax highlighting, in-line spell-checking, and keyboard shortcuts for common HTML tags.
	</para>
</sect1>

<!-- =========== Getting Started ============================== -->
<!-- Use the Getting Started section to describe the steps required
     to start the application and to describe the user interface components
     of the application. If there is other information that it is important
     for readers to know before they start using the application, you should
     also include this information here.
     If the information about how to get started is very short, you can
     include it in the Introduction and omit this section. -->
<sect1 id="drivel-getting-started">
	<title>Getting Started</title>
	<para>
		You can start &app; in the following ways:
		<variablelist>
			<varlistentry>
				<term><guimenu>Applications</guimenu> menu</term>
					<listitem>
						<para>
							Choose <menuchoice> <guisubmenu>Internet</guisubmenu>
							<guimenuitem>Drivel Journal Editor</guimenuitem> </menuchoice>.
						</para>
					</listitem>
			</varlistentry>
			<varlistentry>
				<term>Command line</term>
					<listitem>
						<para>
							Type <command>drivel</command>, then press <keycap>Return</keycap>.
						</para>
					</listitem>
			</varlistentry>
		</variablelist>
	</para>
	<para>
		If you do not have an online journal, you'll need to set one up.
		New users may find the following links useful:
			<itemizedlist>
				<listitem>
				<para>
					<ulink url="http://www.blogger.com" type="http">Blogger.com</ulink> -
					Blogger is one of the most popular sites for hosting online journals.
				</para>
				</listitem>
				<listitem>
				<para>
					<ulink url="http://www.livejournal.com" type="http">LiveJournal.com</ulink> -
					LiveJournal has one of the most active communities surrounding it of any online journal system.
				</para>
				</listitem>
			</itemizedlist>
	</para>
</sect1>

<!-- ================ Usage ================================ -->
<!-- Use this section to describe how to use the application to perform the tasks for
  which the application is designed. -->

<sect1 id="drivel-usage">
	<title>Usage</title>
	<para>
	</para>
	<sect2 id="logging-in">
		<title>Logging In</title>
		<para>To log in to your journal, enter your username in the
		<guilabel>Username</guilabel> field and your password in the <guilabel>Password</guilabel>
		field.  Set <guilabel>Journal type</guilabel> to the appropriate server type and verify that
		the <guilabel>Server address</guilabel> is correct--most users will not need to modify
		this field.  If you wish, you can check the <guilabel>Remember password</guilabel> box
		to make &app; store your password between sessions.  If the
		<guilabel>Automatically login</guilabel> box is checked, &app; will skip the Login Window
		when started and automatically log in to your journal account.
		<guilabel>Remember password</guilabel> must be checked in order for the
		<guilabel>Automatically login</guilabel> option to be available.
		Click <guilabel>Log In</guilabel> to complete the process.
		</para>
	</sect2>
	<sect2 id="working-offline">
		<title>Working Offline</title>
		<para>You may choose to skip the log in process and work offline.  You will
		not be able to post new entries, but you will be able to save your work as
		drafts for later posting.  To work offline, click the
		<guilabel>Work Offline</guilabel> button.
		</para>
	</sect2>
	<sect2 id="composing-new-entry">
		<title>Composing a New Entry</title>
		<para>&app; provides an integrated editor for composing new journal entries.
		Once logged in, write your entry in the provided space.  When you are satisfied
		with the entry, click <guilabel>Post</guilabel>.  Depending on the type of journal,
		different controls may appear.  Journals which support titles will have an
		optional <guilabel>Subject</guilabel> field.  LiveJournal users will also see a
		<guilabel>Security</guilabel> menu; this allows you to select who can view your entry.
		By clicking on <guilabel>Show more options</guilabel>, the following entry-customization
		features will become available:
			<itemizedlist>
				<listitem><para>
				<emphasis>LiveJournal only:</emphasis>
					<guilabel>Mood</guilabel> - You can select an available mood, or type in
					your own.  By selecting a mood from the menu, LiveJournal will match your
					mood with a (generally) cute icon.
				</para>
				</listitem>
				<listitem><para>
				<guilabel>Music</guilabel> - Enter the current music playing in the background
				or stuck in your head.  &app; can auto-detect songs playing in XMMS, Beep Media
				Player, and Rythmbox by clicking on the drop-down arrow to the right of this entry.
				</para>
				</listitem>
				<listitem><para>
					<guilabel>Turn off comments</guilabel> - Do not allow other users to leave
					comments on this journal entry.</para>
				</listitem>
				<listitem><para>
					<guilabel>Don't auto-format text</guilabel> - Prevent &app; from turning
					line-breaks in your journal entry into HTML tags.  If you use this options,
					you'll need to enter the line-break and paragraph HTML tags manually in your entry.
					</para>
				</listitem>
				<listitem><para>
					<guilabel>Past date</guilabel> - This allows you to make your journal entry
					appear to have been posted in the past.</para>
				</listitem>
				<listitem><para>
					<guilabel>Picture</guilabel> - Select the picture you would like associated
					with this journal entry.</para>
				</listitem>
				<listitem><para>
				<emphasis>MovableType only:</emphasis>
					<guilabel>Category</guilabel> - Select the category to sort this entry under.
					</para>
				</listitem>
				</itemizedlist>These controls are completely optional and are provided as ways
				to customize each journal entry. Feel free to set all, some, or none.
		</para>
	</sect2>
	<sect2 id="editing-existing-entry">
		<title>Editing an Existing Entry</title>
		<para>&app; allows you to edit previous journal entries.</para>
		<sect3 id="editing-last-entry">
			<title>Editing Your Last Entry</title>
			<para>To edit your last journal entry, choose <menuchoice>
			<guisubmenu>Edit</guisubmenu><guimenuitem>Last Entry</guimenuitem>
			</menuchoice> from the menu bar.  &app; will automatically fetch your most
			recent entry.  Once you have completed your modifications, click
			<guilabel>Update</guilabel> to update the entry in your journal.
			</para>
		</sect3>
		<sect3 id="editing-recent-entry">
			<title>Edit a Recent Entry</title>
			<para>&app; builds a list of the fifteen most-recent entries when you log in.
			Choose <menuchoice><guisubmenu>Journal</guisubmenu>
			<guimenuitem>Recent Entries</guimenuitem></menuchoice> from the menu bar to
			see the complete list.  Click on an item to load the complete entry.
			Once you have completed your modifications, click <guilabel>Update</guilabel>
			to update the entry in your journal.
			</para>
		</sect3>
		<sect3 id="editing-old-entry">
			<title>Editing any Existing Entry (LiveJournal only)</title>
			<para>To edit any previously-posted journal entry, choose <menuchoice>
			<guisubmenu>Edit</guisubmenu><guimenuitem>History</guimenuitem>
			</menuchoice> from the menu bar.  This will open a window with a calendar.
			Any bold dates in the calendar have journal entries associated with them.
			The controls on the calendar can be used to go back months or even years.
			Once you've selected the date the entry you'd like to modify was posted, a
			list of entries from that day will appear in the bottom of the window.
			Select the entry to modify and click <guilabel>Edit</guilabel>.
			Once you have completed your modifications, click
			<guilabel>Update</guilabel> to update the entry in your journal.
			</para>
		</sect3>
	</sect2>
	<sect2 id="editor-window">
		<title>Working in the Journal Entry Window</title>
		<para>The editor built into &app; includes inline spell-checking and HTML
		syntax highlighting.</para>
		<sect3 id="editor-window-spelling">
			<title>Spell Checking</title>
			<para>To enable inline spell-checking, click <menuchoice>
			<guisubmenu>View</guisubmenu><guimenuitem>Highlight Spelling Errors</guimenuitem>
			</menuchoice> in the menu bar.  A wavy red line will appear underneath
			misspelled words.  Right-clicking on the word will display a menu with a
			<guimenuitem>Spelling Suggestions</guimenuitem> submenu.  Clicking on a
			displayed suggestion will insert it in place of the misspelled word.
			</para>
			<para>Press the <emphasis>F7</emphasis> key to quickly enable or disable
			the spell-checker.</para>
		</sect3>
		<sect3 id="editor-window-syntax">
			<title>HTML Syntax Highlighting</title>
			<para>&app; can display HTML keywords in different colors than the rest of
			your entry.  This is useful for quickly catching formatting errors before
			posting an entry to your journal.  To turn on HTML syntax highlighting,
			click <menuchoice><guisubmenu>View</guisubmenu>
			<guimenuitem>Highlight HTML</guimenuitem></menuchoice> in the menu bar.
			</para>
		</sect3>
	</sect2>
</sect1>

<!-- ============= FAQ ============================= -->
<!-- Use this section to list frequently-asked questions. -->

<sect1 id="drivel-faq">
	<title>Frequently Asked Questions</title>
	<sect2 id="faq-blogger-titles">
		<title>Why can't I title my Blogger entries?</title>
		<para>The original Blogger system did not support titles for journal entries.
		While Blogger has since extended it's servers to accept titles, it is still not
		part of the Blogger 1.0 standard which is used by numerous other journal systems,
		nor is Blogger able to send titles to clients when editing older entries or
		building lists of previous entries.  To avoid these inconsistencies, &app;
		does not support Blogger 1.0 titles.</para>
		<para>Blogger.com users can opt to use the Atom API from &app;'s Login window.
		The Atom API supplants the older Blogger API and does include proper support
		for titling entries.  The use of Atom will not alter your journal or break
		existing applications.</para>
	</sect2>
    <sect2 id="faq-wordpress-server">
      <title>What should I enter for my WordPress (or other
      Movable Type compatible) server?</title>
      <para><emphasis>Wordpress</emphasis> (in common with other blogging
      engines that can be installed on remote servers like
      <emphasis>serendipity</emphasis>) uses <userinput>Movable
      Type</userinput> communication protocols, so select
      <userinput>Movable Type</userinput> in the drivel drop-down
      list.</para>
      <para>The exact URL depends on where your WordPress server is
      hosted, but it is usually something along the lines of
      <emphasis>http://www.yourwebsite.com/path/to/wordpress/xmlrpc.php</emphasis>.
      If your website was <emphasis>www.gnome.org</emphasis> and you
      installed wordpress to <emphasis>/public/wp</emphasis>, then your
      server line should read
      <emphasis>http://www.gnome.org/public/wp/xmlrpc.php</emphasis>.
      </para>
    </sect2>
</sect1>

<!-- ============= Customization ============================= -->
<!-- Use this section to describe how to customize the application. -->

<!-- ============= About ================================== -->
<!-- This section contains info about the program (not docs), such as
      author's name(s), web page, license, feedback address. This
      section is optional: primary place for this info is "About.." box of
      the program. However, if you do wish to include this info in the
      manual, this is the place to put it. Alternatively, you can put this
      information in the title page.-->

<sect1 id="drivel-about">
	<title>About &app;</title>
	<para>
	&app; was written by Todd Kulesza (<email>todd@dropline.net</email>).
	To find more information about &app;, please visit the <ulink
	url="http://www.dropline.net/drivel/" type="http">Drivel web page</ulink>.
	</para>
	<para>
	To report a bug or make a suggestion regarding this application or this manual,
	follow the directions in this <ulink url="ghelp:gnome-feedback" type="help">document</ulink>.
	</para>

	<para>
	This program is distributed under the terms of the GNU General Public
	license as published by the Free Software Foundation; either version 2 of the
	License, or (at your option) any later version. A copy of this license can
	be found at this <ulink url="ghelp:gpl" type="help">link</ulink>, or in the
	file COPYING included with the source code of this program.
	</para>
</sect1>
</article>
