On Jan 11, 2010, at 12:07 PM, Owen Dall wrote:

I don't care about Word. Been a nightmare with it or OpenOffice. For the next one someone recommended Lyx, but I don't have a clue how to use it.

What do you suggest?


LaTeX is still a major presence in the space, and it has the advantage of being open-source, cross-platform and more amenable to version control (.tex files are plain text). Pygments integration (for automatic syntax highlighting in code examples) is also a huge win.

There's a bit of a learning curve, to be sure, but anybody who can read structured markup can pretty much figure out what's going on. For instance, here's a short document (from small2e.tex, one of the sample files):

@@@
\documentclass{article}
\begin{document}


\section{Simple Text}

Words are separated by one or more spaces.  Paragraphs are separated by
one or more blank lines.  The output is not affected by adding extra
spaces or extra blank lines to the input file.

Double quotes are typed like this: ``quoted text''.
Single quotes are typed like this: `single-quoted text'.

Long dashes are typed as three dash characters---like this.

Emphasized text is typed like this: \emph{this is emphasized}.
Bold       text is typed like this: \textbf{this is bold}.

\subsection{A Warning or Two}

If you get too much space after a mid-sentence period---abbreviations
like etc.\ are the common culprits)---then type a backslash followed by
a space after the period, as in this sentence.

Remember, don't type the 10 special characters (such as dollar sign and
backslash) except as directed!  The following seven are printed by
typing a backslash in front of them:  \$  \&  \#  \%  \_  \{  and  \}.
The manual tells how to make other symbols.

\end{document}
@@@

You also get automatic table-of-contents stuff, figure numbering, etc and even conversion to HTML if the right styles are used. You can even do include processing, so that Rapid Rails (for instance) could be a collection of files, one tutorial per file.




-- 
You received this message because you are subscribed to the Google Groups "Hobo 
Users" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/hobousers?hl=en.


Reply via email to