emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
Search results ordered by [date|relevance]  view[summary|nested|Atom feed]
thread overview below | download mbox.gz: |
* Re: LaTex Adjustments for Org-Export
    2013-07-31 14:01  6% ` Nick Dokos
  2013-07-31 16:24  6% ` Nick Dokos
@ 2013-08-04 14:51 10% ` Anthony Lander
  2 siblings, 0 replies; 59+ results
From: Anthony Lander @ 2013-08-04 14:51 UTC (permalink / raw)
  To: Jeff Rush; +Cc: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 1663 bytes --]

Hi Jeff,

I just saw your question about removing paragraph indent, and adding space
between paragraphs. You can do that with the following LaTeX commands:

\setlength{\parskip}{1ex plus 0.5ex minus 0.2ex} %% Add space between
paragraphs

\setlength{\parindent}{0pt} %% Do not indent paragraphs


You can put them at the top of your org document like so:


#+LATEX_HEADER: \setlength{\parskip}{1ex plus 0.5ex minus 0.2ex} %% Add
space between paragraphs

#+LATEX_HEADER: \setlength{\parindent}{0pt} %% Do not indent paragraphs


I hope this helps!


  -Anthony


On Wed, Jul 31, 2013 at 8:27 AM, Jeff Rush <jrush@taupro.com> wrote:

> I'm trying to export a .org file to .pdf and although I've gotten past
> many formatting hurdles, I am stuck on two problems.
>
> 1) How can I redefine, in my org-export-latex-classes variable, the
> \section definition, such that it includes \pagebreak?
>      My reason is that I would like each of my top-level headings to
> start on a new page, like a new chapter.
>
> 2) How can I change the basic formatting of paragraphs everywhere to
>
>      a) omit the leading indent, and
>      b) have a blank line between paragraphs
>
>     Instead of this strange-looking style:
>
>         This is a test paragraph
>     of the following kind of thing.
>         And so is this one.
>
>     I want it to look like this:
>
>     This is a test paragraph
>     of the following kind of thing.
>       And so is this one.
>
> Thanks for any helpful souls out there.  I'm working on learning LaTeX
> but can't see how the various parts of the "article" base class fit
> together and how to selectively override them.
>
> -Jeff
>
>
>

[-- Attachment #2: Type: text/html, Size: 2499 bytes --]

^ permalink raw reply	[relevance 10%]

* Re: LaTex Adjustments for Org-Export
  @ 2013-07-31 14:01  6% ` Nick Dokos
  2013-07-31 16:24  6% ` Nick Dokos
  2013-08-04 14:51 10% ` Anthony Lander
  2 siblings, 0 replies; 59+ results
From: Nick Dokos @ 2013-07-31 14:01 UTC (permalink / raw)
  To: emacs-orgmode

Jeff Rush <jrush@taupro.com> writes:

> I'm trying to export a .org file to .pdf and although I've gotten past
> many formatting hurdles, I am stuck on two problems.
>
> 1) How can I redefine, in my org-export-latex-classes variable, the
> \section definition, such that it includes \pagebreak?
>      My reason is that I would like each of my top-level headings to
> start on a new page, like a new chapter.
>
> 2) How can I change the basic formatting of paragraphs everywhere to
>
>      a) omit the leading indent, and
>      b) have a blank line between paragraphs
>
>     Instead of this strange-looking style:
>
>         This is a test paragraph
>     of the following kind of thing.
>         And so is this one.
>
>     I want it to look like this:
>
>     This is a test paragraph
>     of the following kind of thing.
>       And so is this one.
>
> Thanks for any helpful souls out there.  I'm working on learning LaTeX
> but can't see how the various parts of the "article" base class fit
> together and how to selectively override them.
>

I think the best solution is along these lines:

o use a latex style file to redefine \parindent and \parskip. Also
  define a new command, \psection, to do the page break thingie.

o Add a new class to org-latex-classes which is just like "article"
  except that it uses \psection in place of \section (so I call it
  "particle" :-) )

o Tell org to use particle as your LaTeX class, and also tell it to
  use the latex style from step 1.

In more detail, create a file, foo.sty, in the same directory as your
org file and give it these contents:

--8<---------------cut here---------------start------------->8---
\setlength{\parindent}{0pt}
\setlength{\parskip}{4pt}
\newcommand{\psection}{\newpage\section}
--8<---------------cut here---------------end--------------->8---

Then evaluate the following (or add this to your .emacs if you
want to make it permanent - needs to be added *after* org-latex-classes
is defined, so it might need to be in a hook):

--8<---------------cut here---------------start------------->8---
(add-to-list 'org-latex-classes
	     '("particle" "\\documentclass[11pt]{article}"
	       ("\\psection{%s}" . "\\psection*{%s}")
	       ("\\subsection{%s}" . "\\subsection*{%s}")
	       ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
	       ("\\paragraph{%s}" . "\\paragraph*{%s}")
	       ("\\subparagraph{%s}" . "\\subparagraph*{%s}")))
--8<---------------cut here---------------end--------------->8---

and finally your org file should look like this:

--8<---------------cut here---------------start------------->8---
#+LATEX_CLASS: particle
#+LATEX_HEADER: \usepackage{foo}

* foo
This is a long long long long long long long long long long long long
long long long long long long long long long long long long long long
long long long long long long long long long long long long long long
long long long long long long long long long long long long long long
long long long long long long long long long long long long long long
long long long long long long long long long paragraph.

This is another paragraph.

* bar
Who knows?

Who cares?
--8<---------------cut here---------------end--------------->8---

HTH.
-- 
Nick

^ permalink raw reply	[relevance 6%]

* Re: LaTex Adjustments for Org-Export
    2013-07-31 14:01  6% ` Nick Dokos
@ 2013-07-31 16:24  6% ` Nick Dokos
  2013-08-04 14:51 10% ` Anthony Lander
  2 siblings, 0 replies; 59+ results
From: Nick Dokos @ 2013-07-31 16:24 UTC (permalink / raw)
  To: emacs-orgmode

[I thought I sent this before but I don't see it on gmane, so it's
 either hung up somewhere or in the bit bucket. Apologies if you see it
 twice - assuming that it makes it at least this time :-)]

Jeff Rush <jrush@taupro.com> writes:

> I'm trying to export a .org file to .pdf and although I've gotten past
> many formatting hurdles, I am stuck on two problems.
>
> 1) How can I redefine, in my org-export-latex-classes variable, the
> \section definition, such that it includes \pagebreak?
>      My reason is that I would like each of my top-level headings to
> start on a new page, like a new chapter.
>
> 2) How can I change the basic formatting of paragraphs everywhere to
>
>      a) omit the leading indent, and
>      b) have a blank line between paragraphs
>
>     Instead of this strange-looking style:
>
>         This is a test paragraph
>     of the following kind of thing.
>         And so is this one.
>
>     I want it to look like this:
>
>     This is a test paragraph
>     of the following kind of thing.
>       And so is this one.
>
> Thanks for any helpful souls out there.  I'm working on learning LaTeX
> but can't see how the various parts of the "article" base class fit
> together and how to selectively override them.
>

I think the best solution is along these lines:

o use a latex style file to redefine \parindent and \parskip. Also
  define a new command, \psection, to do the page break thingie.

o Add a new class to org-latex-classes which is just like "article"
  except that it uses \psection in place of \section (so I call it
  "particle" :-) )

o Tell org to use particle as your LaTeX class, and also tell it to
  use the latex style from step 1.

In more detail, create a file, foo.sty, in the same directory as your
org file and give it these contents:

--8<---------------cut here---------------start------------->8---
\setlength{\parindent}{0pt}
\setlength{\parskip}{4pt}
\newcommand{\psection}{\newpage\section}
--8<---------------cut here---------------end--------------->8---

Then evaluate the following (or add this to your .emacs if you
want to make it permanent - needs to be added *after* org-latex-classes
is defined, so it might need to be in a hook):

--8<---------------cut here---------------start------------->8---
(add-to-list 'org-latex-classes
	     '("particle" "\\documentclass[11pt]{article}"
	       ("\\psection{%s}" . "\\psection*{%s}")
	       ("\\subsection{%s}" . "\\subsection*{%s}")
	       ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
	       ("\\paragraph{%s}" . "\\paragraph*{%s}")
	       ("\\subparagraph{%s}" . "\\subparagraph*{%s}")))
--8<---------------cut here---------------end--------------->8---

and finally your org file should look like this:

--8<---------------cut here---------------start------------->8---
#+LATEX_CLASS: particle
#+LATEX_HEADER: \usepackage{foo}

* foo
This is a long long long long long long long long long long long long
long long long long long long long long long long long long long long
long long long long long long long long long long long long long long
long long long long long long long long long long long long long long
long long long long long long long long long long long long long long
long long long long long long long long long paragraph.

This is another paragraph.

* bar
Who knows?

Who cares?
--8<---------------cut here---------------end--------------->8---

HTH.
-- 
Nick

^ permalink raw reply	[relevance 6%]

* Re: Embedded Tikz Picture
  @ 2013-07-14 15:35  8% ` Myles English
  0 siblings, 0 replies; 59+ results
From: Myles English @ 2013-07-14 15:35 UTC (permalink / raw)
  To: Julien Cubizolles; +Cc: emacs-orgmode


Hi Julien,

Julien Cubizolles writes:

> What would be the best way to use some tikz code in an org-file?

I don't know what the best way is.

> I've succeeded so far by putting it in a 
> #+BEGIN_LaTeX
> #+END_LaTeX
> structure but from what I understand, this code will only be evaluated
> when I export to LaTeX.

That's right, (maybe beamer too?).

> I also tried embedding the corresponding LaTeX code, but I only got a
> white square for the picture.

Could this be a problem with different paper sizes?  If so, the use of
the standalone class (see below) may fix this.

> I guess the relevant packages weren't loaded. Is it possible to make
> the embedded LaTeX code use the class defined by #+LATEX_CLASS?

That should be happening already.

I had been using tikz like this, (note: this may not work and my
intention is not to preclude your ECM):

#+LATEX_HEADER: \usepackage{standalone}
#+LATEX_CLASS: report

#+begin_latex
\begin{figure}[htb]
\centering
\includestandalone[mode=tex,width=5cm]{/home/myles/docs/repo/ve/tex/axisymm}
\caption[1D and axisymmetric model domains]{\label{figure:axisymm}1D model domain and mesh of line elements
(left), and the axisymmetric variant (right) showing the increased
element volumes associated with the line elements.}
\end{figure}
#+end_latex

And then in /home/myles/docs/repo/ve/tex/axisymm.tex :

------------------------------------------------------
\documentclass{standalone}
\usepackage{subfig}
%\usepackage[pdftex,active,tightpage]{preview}
%\setlength\PreviewBorder{2mm} % use to add a border around the image
\usepackage{../texlib/mystyle}
\usepackage{tikz}
\usetikzlibrary{shapes,arrows,fit,positioning,backgrounds}
\usetikzlibrary{decorations.pathreplacing} % for braces

\begin{document}
%\begin{preview}
\tikzset{Model axes/.style={color=blue!50,->}}
\tikzset{Domain boundary/.style={color=black,thick}}
%\tikzset{Element boundary/.style={color=black!70}}

\begin{tikzpicture}[scale=3,
  %\basicBAxes;
  % arcs
  % dots
  place/.style={circle,draw=black,fill=black,
    inner sep=0pt,minimum size=1mm}]
\node (dumm) at ( 0,0) [draw=white,minimum size=0.1mm] {};
\node (one) at ( 0.25,0.8) [place] {};
  \node (two) at ( 0.35,0.8) [place] {};
  \node (three) at ( 0.55,0.8) [place] {};
  \node (four) at ( 0.8,0.8) [place] {};
  
  \draw (one)--(four);
\end{tikzpicture}
\qquad
\begin{tikzpicture}[scale=3,
  %\basicBAxes;
  % arcs
  % dots
  place/.style={circle,draw=black,fill=black,
    inner sep=0pt,minimum size=1mm}]
  
% front
  \draw[Domain boundary] (-90:0.25) arc (-90:90:0.25);
  \draw[Domain boundary] (-90:0.8) arc (-90:90:0.8);
  % horseshoe ends
  \draw[Domain boundary] (-90:0.8) -- (-90:0.25);
  \draw[Domain boundary] (90:0.8) -- (90:0.25);

  % back
  \draw[Domain boundary] (-90:0.25) arc (-90:90:0.25);
  \draw[Domain boundary] (-90:0.8) arc (-90:90:0.8);
  % horseshoe ends
  \draw[Domain boundary] (-90:0.8) -- (-90:0.25);
  \draw[Domain boundary] (90:0.8) -- (90:0.25);

  \node (one) at ( 0.25,0) [place] {};
  \node (two) at ( 0.35,0) [place] {};
  \node (three) at ( 0.55,0) [place] {};
  \node (four) at ( 0.8,0) [place] {};
  
  \draw (one)--(four);

  %\draw[Element boundary] (two) arc (0:90:0.35);
  %\draw[Element boundary] (two) arc (0:-90:0.35);
  \draw (two) arc (0:90:0.35);
  \draw (two) arc (0:-90:0.35);
  \draw (three) arc (0:90:0.55);
  \draw (three) arc (0:-90:0.55);
\end{tikzpicture}

%\end{preview}
\end{document}
------------------------------------------------------


Myles

^ permalink raw reply	[relevance 8%]

* Re: plotting tables
  @ 2013-03-26 15:19  5%     ` John Hendy
  0 siblings, 0 replies; 59+ results
From: John Hendy @ 2013-03-26 15:19 UTC (permalink / raw)
  To: Eric Abrahamsen; +Cc: emacs-orgmode

On Mon, Mar 25, 2013 at 10:09 PM, Eric Abrahamsen
<eric@ericabrahamsen.net> wrote:
> John Hendy <jw.hendy@gmail.com> writes:
>
> Wow, thank you for this comprehensive response!
>

No problem. I get excited about this stuff :)

>> On Sun, Mar 24, 2013 at 1:44 AM, Eric Abrahamsen
>> <eric@ericabrahamsen.net> wrote:
>
> [...]
>
>>> 1. Are these really mutually incompatible approaches, as they appear to
>>> be?
>>>
>>
>> What do you mean by incompatible? I think if you used them both, you'd
>> just get two plots. It looks like #+plot just allows one to put some
>> gnuplot commands in the header above a table and get a plot out. Using
>> the org-babel approach lets you write straight gnuplot code and call a
>> data table from elsewhere.
>
> Right, "incompatible" was the wrong word, I probably meant "orthogonal".
> I just meant you'd either use one or the other, not both.

I'd say so. I think of them as a minimalist or full-fledged pair of options.

>
>>> 2. What's my best option if I want the following scenario: I start with
>>> an org file containing an org table, call `org-latex-export-to-pdf' on
>>> that file, get a coffee, and come back to find a nice pdf containing
>>> just the plotted graph (no table). Can someone show me just the barest
>>> example?
>>
>> Nice PDF of the plot and nothing else whatsoever, or nice PDF
>> containing other stuff from your org file and just not the header?
>
> Sorry, that wasn't clear: there's lots of stuff in the file and I want
> all the rest of it, just not the table. A noexport tag is a fine solution to
> keeping it out. But I'm still not sure how the resulting plot gets
> included: surely I'd need a link to a file in here somewhere?
>

The plot gets included via your babel block heading. If I do this:

#+begin_src R :exports results :results output graphics  :file plot.png

x <- 1:10
y <- x^2

plot(x,y)

#+end_src

If I then execute the block with C-c C-c, I'll get a line like this:

#+RESULTS:
[[file:plot.png]]

That inputs it into the PDF upon export.

If you name your block code block, you can fiddle with the output via
typical #+attr_latex settings. Set a name in the block like so (also
moving the :file option for tidyness):

#+name: square
#+header: :file plot.png
#+begin_src R :exports results :results output graphics

This changes the #+RESULTS block to this:

#+RESULTS: square
[[file:plot.png]]

Without a named result, if there's anything immediately before the
#+RESULTS, Babel won't recognize the pre-existing output and will add
another block. With named blocks, it figures it out and you can then
do this:

#+begin_center
#+attr_latex :width 0.75\textwidth
#+RESULTS: square
[[file:plot.png]]
#+end_center

If you change the contents of the =square= src block (say, changing
the file output name), it will be replaced in that block while leaving
your image settings alone.

> [...]
>
>>> 3. I've been learning the tikz LaTeX package and am very impressed. Has
>>> anyone used tikz/pgfplots with org?
>>>
>>
>> Yes! Though as with Dieter, I've also migrated to R now. Gnuplot
>> worked fairly well for simple plotting, but at the end of the day,
>> most plotting (for me, at least) falls into some sort of workflow:
>> - get some data
>> - re-arrange, combine, pre-process some data
>> - get that data accessible to some program (e.g. gnuplot, R)
>> - plot results
>> - interpret results
>> - present plots in context of some project/endeavor
>
> Over the past couple of days I think I've decided to move away from
> gnuplot. What you and Dieter said is right: pgfplots does everything I
> need it to, and it integrates perfectly into my existing latex
> documents.
>
> I'm reluctant to learn R: frankly my brain is full right now, and I'm
> also not sure I need it. My data is actually very simple and doesn't
> require any massaging that the org tables themselves can't handle. I do
> have a lot of small tables, though, will need to produce these documents
> fairly frequently, and need them to look good.
>

You know your data best; if the solution works for you and is
efficient... go for it!

> So in your setup below, you're using R to actually create the plots, but
> tikz to style them? Or is R feeding data to tikz/pgfplots, and the
> actually plotting is going on there? I found this a little confusing...
>

Yup -- tikzDevice just takes the R graphics and draws it with tikz.

#+begin_src R :results silent

# uncomment if you don't have these installed
# install.packages("filehash")
# install.packages("tikzDevice", repos="http://R-Forge.R-project.org")

# you also need the LaTeX preview package
# I have this in .Rprofile:

### begin .Rprofile ###
# options (tikzDefaultEngine = 'pdftex')
# options (tikzDocumentDeclaration = "\\documentclass{article}")
# options (tikzFooter = c("\\end{document}"))

# options (tikzLatexPackages = c(
#   "\\usepackage{tikz}",
#   "\\usepackage[pdftex,active,tightpage]{preview}",
#   "\\setlength\\PreviewBorder{0pt}",
#   "\\PreviewEnvironment{pgfpicture}",
#   "\\usepackage{lmodern}",
#   "\\renewcommand{\\familydefault}{\\sfdefault}")
# )

# options (tikzMetricPackages = c(
#   "\\usepackage[utf8]{inputenc}",
#   "\\usepackage[T1]{fontenc}",
#   "\\usetikzlibrary{calc}")
# )
### end .Rprofile ###

library(tikzDevice)
library(ggplot2)

p <- ggplot(mtcars, aes(mpg, wt, colour = factor(gear))) + geom_point()
p <- p + facet_grid(. ~ cyl) + theme_bw()

tikz("plot.tex", width=9, height=6, standAlone = T)
p
dev.off()

tools::texi2pdf("plot.tex", pdf = T)
#+end_src

Take a look at the .tex generated from that.

> What I believe I'm looking for is something like this:
>
> #+tblname: tabul
> |  Dec |  Nov |  Oct | Sept |
> +------+------+------+------|
> | 1575 | 3430 |  332 | 2201 |
> | 3118 | 3002 | 2334 | 1053 |
>
> #+begin_src latex :var table=tabul
> \begin{tikzpicture}
>   \begin{axis}[blah]
>   \addplot {table};
>   \end{axis}
> \end{tikzpicture}
> #+end_src
>
> Except that I'll need an intermediate step, so that table headings go
> into separate vars and are put in the axis declaration, and the actual
> table data comes out in a format that pgfplots can understand (right now
> it's a sexp).
>

I don't have enough experience with this. I got fairly into tikz for a
while (even got an example submitted to the TikZ/PDF examples repo!
[1]), but my issue with using it for plotting is that, in my opinion,
it has an even higher learning curve than R. The other issue, at least
from my experience, is that even if you generally know what you're
doing, it's *unbelievably* easy to mess up syntax somewhere, miss a
comma, goof up some combo of ={}= and/or semicolons... I've spent
massive amounts of time trying to debug my TikZ creations.

It's extremely well documented... but that doesn't mean you even know
what to search for in the documentation

From looking at pgfplots, it looks much easier to generate than hand
plotting with TikZ. Compare the code between these:
- Straight TikZ: http://www.texample.net/tikz/examples/feature/plotting/
- pgfplots: http://pgfplots.sourceforge.net/gallery.html

Anyway, again, your call... I just find the bulk output with
R/tikzDevice and then minor tweaking in actual TikZ code to work
fairly well. Then again, I'm back to editing a full-on TikZ file vs.
the syntax of pgfplots which does, indeed, look relatively simple, at
least for some of their examples.

> Maybe that's where R comes in?
>
> Thanks again for all this information!
>

Good luck in your decision and I hope you find something that works
well for you!

John

[1] http://www.texample.net/tikz/examples/bayes/

> E
>
>> Sure you can just start feeding gnuplot from a file instead of having
>> big tables in Org-mode tables (which I find gets extremely cumbersome
>> for more than maybe 20 or so rows and 10 cols), but for most things
>> you actually need to *do* other things with that data.
>>
>> If you're just learning... I'd recommend just switching to learning to
>> plot with R. Ditch other R stuff if it's intimidating at the moment --
>> just manipulate your data in Excel or LibreOffice, and teach yourself
>> the equivalent of plotting in gnuplot with R. Instead of =plot data
>> using 1:3=, it might be =plot(data[, 1], data[, 3])= in R.
>>
>> The benefit is that as you learn, you can "grow into R," whereas if
>> you attempt some level of gnuplot mastery, you'll still be stuck
>> needing a bunch of other tools for all but the more simply plotting
>> needs.
>>
>> For matching fonts/styles in your LaTeX output, there's the handy
>> =tikzDevice= R library: ETA: gasp! It's been removed from CRAN. You
>> can still get it, though:
>> - https://www.nesono.com/node/403
>>
>> Here's the documentation:
>> - https://r-forge.r-project.org/scm/viewvc.php/*checkout*/pkg/inst/doc/tikzDevice.pdf?revision=35&root=tikzdevice
>>
>> You can add frequently used options in ~/.Rprofile (just create it if
>> it doesn't exist). Of particular interest is setting the
>> tikzLatexPackages variable. The following would set your document to
>> use the =mathpazo= font family instead of the default. You could
>> replace with whatever you wanted (I use lmodern a lot).
>>
>> options( tikzLatexPackages = c(
>> getOption( "tikzLatexPackages" ),
>> "\\usepackage{mathpazo}"
>> ))
>>
>>
>> From there, you'd do something like so:
>>
>> #+begin_src R
>>
>> [any general R code]
>>
>> tikz(file = "file.tex", width = n, height = n, standAlone = T)
>>
>> [commands that generate the plot in R]
>>
>> dev.off()
>>
>> #+end_src
>>
>> Now you'll have a .tex file of your plot and can just compile it.
>> Better yet, just add this after =dev.off()= above:
>>
>> #+begin_src R
>>
>> tools::texi2dvi("file.tex", pdf=T)
>>
>> #+end_src
>>
>> That would compile the resultant file. I tend to get the output in
>> some other format to make sure things look good and then do the output
>> to .tex -> pdf as the final step.
>>
>> As a bonus to this process, if there's ever any re-arrangement or more
>> complex annotation to be done, you can add it to the .tex file before
>> compiling. This is fairly manually intensive, but for some things when
>> you just couldn't specify it based on the data to have it
>> automatically plotted, you'd end up doing the same amount of work in R
>> to add text here and there anyway. By looking at the tikz code, you
>> can generally figure out the min/max coordinates of the plot and add
>> whatever additional graphics or text you want. You also get fine-tuned
>> color/shape changing abilities.
>>
>>
>> Hope that helps!
>> John
>>
>>
>>
>>>
>>> In return, I promise to add a very hand-holdy explanation to worg,
>>> provided that there isn't already one there that I missed.
>>>
>>> Thanks,
>>> Eric
>>>
>>>
>
>

^ permalink raw reply	[relevance 5%]

* latex exporter:  different itemize environment
@ 2013-02-13  7:31  7% Andreas Leha
  0 siblings, 0 replies; 59+ results
From: Andreas Leha @ 2013-02-13  7:31 UTC (permalink / raw)
  To: emacs-orgmode

Hi all (and Nicolas),

from =org-e-latex.el= (I have to upgrade - I know):
,----
| ;; Plain lists accept two optional attributes: `:environment' and
| ;; `:options'.  The first one allows to use a non-standard environment
| ;; (i.e. "inparaenum").  The second one allows to specify optional
| ;; arguments for that environment (square brackets are not mandatory).
`----

I can not make the :enviroment switch work.

Following is a small presentation with a non-indented version of
itemize.  But when I export it, I still get an \begin{itemize} when
instead I'd like \begin{nonindentlist}.

What am I missing?

Regards,
Andreas

PS: The example:


#+LATEX_HEADER: % from http://stackoverflow.com/questions/2611276/latex-beamer-way-to-change-the-bullet-indentation
#+LATEX_HEADER: \makeatletter
#+LATEX_HEADER: \newenvironment{nonindentlist}{
#+LATEX_HEADER:   \ifnum\@itemdepth >2\relax\@toodeep\else
#+LATEX_HEADER:       \advance\@itemdepth\@ne%
#+LATEX_HEADER:       \beamer@computepref\@itemdepth%
#+LATEX_HEADER:       \usebeamerfont{itemize/enumerate \beameritemnestingprefix body}%
#+LATEX_HEADER:       \usebeamercolor[fg]{itemize/enumerate \beameritemnestingprefix body}%
#+LATEX_HEADER:       \usebeamertemplate{itemize/enumerate \beameritemnestingprefix body begin}%
#+LATEX_HEADER:       \begin{list}
#+LATEX_HEADER:         {
#+LATEX_HEADER:             \usebeamertemplate{itemize \beameritemnestingprefix item}
#+LATEX_HEADER:         }
#+LATEX_HEADER:         { \leftmargin=1em \itemindent=0pt
#+LATEX_HEADER:             \def\makelabel##1{%
#+LATEX_HEADER:               {%  
#+LATEX_HEADER:                   \hss\llap{{%
#+LATEX_HEADER:                     \usebeamerfont*{itemize \beameritemnestingprefix item}%
#+LATEX_HEADER:                         \usebeamercolor[fg]{itemize \beameritemnestingprefix item}##1}}%
#+LATEX_HEADER:               }%  
#+LATEX_HEADER:             }%  
#+LATEX_HEADER:         }
#+LATEX_HEADER:   \fi
#+LATEX_HEADER: }
#+LATEX_HEADER: {
#+LATEX_HEADER:   \end{list}
#+LATEX_HEADER:   \usebeamertemplate{itemize/enumerate \beameritemnestingprefix body end}%
#+LATEX_HEADER: }
#+LATEX_HEADER: \makeatother

* EXPORT THIS SUBTREE (given you have beamer in org-e-latex-classes)
  :PROPERTIES:
  :EXPORT_TITLE: My title
  :EXPORT_LaTeX_CLASS: beamer
  :EXPORT_LaTeX_CLASS_OPTIONS: [presentation]
  :END:

** My slide                                                         :B_frame:
   :PROPERTIES:
   :BEAMER_env: frame
   :END:
   
   #+ATTR_LATEX: :environment nonindentlist
   - some
   - bullet
   - points

^ permalink raw reply	[relevance 7%]

* Re: org-version.inc missing
  @ 2012-11-13 22:15  1%     ` David Arroyo Menéndez
  0 siblings, 0 replies; 59+ results
From: David Arroyo Menéndez @ 2012-11-13 22:15 UTC (permalink / raw)
  To: Bastien; +Cc: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 360 bytes --]

davidam@es.gnu.org (David Arroyo Menéndez) writes:

> Thanks!
>
> make pdf is ok!
>

It's ok to transform orgguide.texi to orgguide.pdf, but I would like
translate orgguide to spanish and I need a little help more to check my
translations in pdf and html. I'm attaching the files that I'm using to
translate it.

Thanks in advance.

Regards.


[-- Attachment #2: orgguide.pot --]
[-- Type: text/plain, Size: 143403 bytes --]

# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2012-11-12 16:27+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=CHARSET\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: title
#: orgguide.texi:4 orgguide.texi:69
#, no-wrap
msgid "The compact Org-mode Guide"
msgstr ""

#. type: include
#: orgguide.texi:6
#, no-wrap
msgid "org-version.inc"
msgstr ""

#. type: b{#1}
#: orgguide.texi:30 orgguide.texi:33
#, no-wrap
msgid "\\text\\"
msgstr ""

#. type: copying
#: orgguide.texi:43
msgid "Copyright @copyright{} 2010-2012 Free Software Foundation"
msgstr ""

#. type: quotation
#: orgguide.texi:51
msgid ""
"Permission is granted to copy, distribute and/or modify this document under "
"the terms of the GNU Free Documentation License, Version 1.3 or any later "
"version published by the Free Software Foundation; with no Invariant "
"Sections, with the Front-Cover texts being ``A GNU Manual,'' and with the "
"Back-Cover Texts as in (a) below.  A copy of the license is included in the "
"section entitled ``GNU Free Documentation License.''"
msgstr ""

#. type: quotation
#: orgguide.texi:55
msgid ""
"(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and modify "
"this GNU manual.  Buying copies from the FSF supports it in developing GNU "
"and promoting software freedom.''"
msgstr ""

#. type: quotation
#: orgguide.texi:60
msgid ""
"This document is part of a collection distributed under the GNU Free "
"Documentation License.  If you want to distribute this document separately "
"from the collection, you can do so by adding a copy of the license to the "
"document, as described in section 6 of the license."
msgstr ""

#. type: dircategory
#: orgguide.texi:63
#, no-wrap
msgid "Emacs"
msgstr ""

#. type: menuentry
#: orgguide.texi:66
msgid "Org Mode Guide: (orgguide)"
msgstr ""

#. type: menuentry
#: orgguide.texi:66
msgid "Abbreviated Org-mode Manual"
msgstr ""

#. type: subtitle
#: orgguide.texi:71
#, no-wrap
msgid "Release @value{VERSION}"
msgstr ""

#. type: author
#: orgguide.texi:72
#, no-wrap
msgid "by Carsten Dominik"
msgstr ""

#. type: node
#: orgguide.texi:84 orgguide.texi:227 orgguide.texi:227 orgguide.texi:300 orgguide.texi:569 orgguide.texi:693 orgguide.texi:834 orgguide.texi:1100 orgguide.texi:1229 orgguide.texi:1290 orgguide.texi:1514 orgguide.texi:1681 orgguide.texi:2044 orgguide.texi:2281 orgguide.texi:2436 orgguide.texi:2483 orgguide.texi:2599
#, no-wrap
msgid "Top"
msgstr ""

#. type: node
#: orgguide.texi:84 orgguide.texi:106 orgguide.texi:111 orgguide.texi:227 orgguide.texi:228 orgguide.texi:237 orgguide.texi:237 orgguide.texi:250 orgguide.texi:274 orgguide.texi:293 orgguide.texi:300
#, no-wrap
msgid "Introduction"
msgstr ""

#. type: node
#: orgguide.texi:84 orgguide.texi:84
#, no-wrap
msgid "(dir)"
msgstr ""

#. type: top
#: orgguide.texi:85
#, no-wrap
msgid "Org Mode Guide"
msgstr ""

#. type: menuentry
#: orgguide.texi:106
msgid "Getting started"
msgstr ""

#. type: node
#: orgguide.texi:106 orgguide.texi:118 orgguide.texi:227 orgguide.texi:300 orgguide.texi:301 orgguide.texi:317 orgguide.texi:317 orgguide.texi:329 orgguide.texi:352 orgguide.texi:394 orgguide.texi:411 orgguide.texi:442 orgguide.texi:468 orgguide.texi:535 orgguide.texi:569
#, no-wrap
msgid "Document Structure"
msgstr ""

#. type: menuentry
#: orgguide.texi:106
msgid "A tree works like your brain"
msgstr ""

#. type: node
#: orgguide.texi:106 orgguide.texi:300 orgguide.texi:569 orgguide.texi:570 orgguide.texi:693
#, no-wrap
msgid "Tables"
msgstr ""

#. type: menuentry
#: orgguide.texi:106
msgid "Pure magic for quick formatting"
msgstr ""

#. type: node
#: orgguide.texi:106 orgguide.texi:129 orgguide.texi:569 orgguide.texi:693 orgguide.texi:694 orgguide.texi:707 orgguide.texi:707 orgguide.texi:724 orgguide.texi:736 orgguide.texi:780 orgguide.texi:814 orgguide.texi:834
#, no-wrap
msgid "Hyperlinks"
msgstr ""

#. type: menuentry
#: orgguide.texi:106
msgid "Notes in context"
msgstr ""

#. type: node
#: orgguide.texi:106 orgguide.texi:137 orgguide.texi:693 orgguide.texi:834 orgguide.texi:835 orgguide.texi:858 orgguide.texi:858 orgguide.texi:901 orgguide.texi:951 orgguide.texi:1013 orgguide.texi:1039 orgguide.texi:1059 orgguide.texi:1100
#, no-wrap
msgid "TODO Items"
msgstr ""

#. type: menuentry
#: orgguide.texi:106
msgid "Every tree branch can be a TODO item"
msgstr ""

#. type: node
#: orgguide.texi:106 orgguide.texi:151 orgguide.texi:834 orgguide.texi:1100 orgguide.texi:1101 orgguide.texi:1119 orgguide.texi:1119 orgguide.texi:1145 orgguide.texi:1196 orgguide.texi:1229
#, no-wrap
msgid "Tags"
msgstr ""

#. type: menuentry
#: orgguide.texi:106
msgid "Tagging headlines and matching sets of tags"
msgstr ""

#. type: node
#: orgguide.texi:106 orgguide.texi:106 orgguide.texi:1100 orgguide.texi:1229 orgguide.texi:1230 orgguide.texi:1290
#, no-wrap
msgid "Properties"
msgstr ""

#. type: node
#: orgguide.texi:106 orgguide.texi:157 orgguide.texi:1229 orgguide.texi:1290 orgguide.texi:1291 orgguide.texi:1305 orgguide.texi:1305 orgguide.texi:1363 orgguide.texi:1399 orgguide.texi:1462 orgguide.texi:1514
#, no-wrap
msgid "Dates and Times"
msgstr ""

#. type: menuentry
#: orgguide.texi:106
msgid "Making items useful for planning"
msgstr ""

#. type: node
#: orgguide.texi:106 orgguide.texi:164 orgguide.texi:1290 orgguide.texi:1514 orgguide.texi:1515 orgguide.texi:1530 orgguide.texi:1530 orgguide.texi:1618 orgguide.texi:1643 orgguide.texi:1681
#, no-wrap
msgid "Capture - Refile - Archive"
msgstr ""

#. type: menuentry
#: orgguide.texi:106
msgid "The ins and outs for projects"
msgstr ""

#. type: node
#: orgguide.texi:106 orgguide.texi:176 orgguide.texi:1514 orgguide.texi:1681 orgguide.texi:1682 orgguide.texi:1706 orgguide.texi:1706 orgguide.texi:1724 orgguide.texi:1745 orgguide.texi:1884 orgguide.texi:1995 orgguide.texi:2044
#, no-wrap
msgid "Agenda Views"
msgstr ""

#. type: menuentry
#: orgguide.texi:106
msgid "Collecting information into views"
msgstr ""

#. type: node
#: orgguide.texi:106 orgguide.texi:1681 orgguide.texi:2044 orgguide.texi:2061 orgguide.texi:2061 orgguide.texi:2170 orgguide.texi:2203 orgguide.texi:2240 orgguide.texi:2256 orgguide.texi:2281
#, no-wrap
msgid "Markup"
msgstr ""

#. type: menuentry
#: orgguide.texi:106
msgid "Prepare text for rich export"
msgstr ""

#. type: node
#: orgguide.texi:106 orgguide.texi:209 orgguide.texi:2044 orgguide.texi:2281 orgguide.texi:2282 orgguide.texi:2300 orgguide.texi:2300 orgguide.texi:2329 orgguide.texi:2343 orgguide.texi:2359 orgguide.texi:2382 orgguide.texi:2403 orgguide.texi:2415 orgguide.texi:2436
#, no-wrap
msgid "Exporting"
msgstr ""

#. type: menuentry
#: orgguide.texi:106
msgid "Sharing and publishing of notes"
msgstr ""

#. type: node
#: orgguide.texi:106 orgguide.texi:2281 orgguide.texi:2436 orgguide.texi:2437 orgguide.texi:2483
#, no-wrap
msgid "Publishing"
msgstr ""

#. type: menuentry
#: orgguide.texi:106
msgid "Create a web site of linked Org files"
msgstr ""

#. type: node
#: orgguide.texi:106 orgguide.texi:2436 orgguide.texi:2483 orgguide.texi:2599
#, no-wrap
msgid "Working With Source Code"
msgstr ""

#. type: menuentry
#: orgguide.texi:106
msgid "Source code snippets embedded in Org"
msgstr ""

#. type: node
#: orgguide.texi:106 orgguide.texi:219 orgguide.texi:2483 orgguide.texi:2599 orgguide.texi:2600 orgguide.texi:2608 orgguide.texi:2608 orgguide.texi:2618 orgguide.texi:2662
#, no-wrap
msgid "Miscellaneous"
msgstr ""

#. type: menuentry
#: orgguide.texi:106
msgid "All the rest which did not fit elsewhere"
msgstr ""

#. type: menuentry
#: orgguide.texi:109
msgid "--- The Detailed Node Listing ---"
msgstr ""

#. type: node
#: orgguide.texi:116 orgguide.texi:235 orgguide.texi:237 orgguide.texi:238 orgguide.texi:250
#, no-wrap
msgid "Preface"
msgstr ""

#. type: menuentry
#: orgguide.texi:116 orgguide.texi:235
msgid "Welcome"
msgstr ""

#. type: node
#: orgguide.texi:116 orgguide.texi:235 orgguide.texi:237 orgguide.texi:250 orgguide.texi:251 orgguide.texi:274
#, no-wrap
msgid "Installation"
msgstr ""

#. type: menuentry
#: orgguide.texi:116 orgguide.texi:235
msgid "How to install a downloaded version of Org"
msgstr ""

#. type: node
#: orgguide.texi:116 orgguide.texi:235 orgguide.texi:250 orgguide.texi:274 orgguide.texi:275 orgguide.texi:293
#, no-wrap
msgid "Activation"
msgstr ""

#. type: menuentry
#: orgguide.texi:116 orgguide.texi:235
msgid "How to activate Org for certain buffers"
msgstr ""

#. type: section
#: orgguide.texi:116 orgguide.texi:235 orgguide.texi:274 orgguide.texi:293 orgguide.texi:294
#, no-wrap
msgid "Feedback"
msgstr ""

#. type: menuentry
#: orgguide.texi:116 orgguide.texi:235
msgid "Bug reports, ideas, patches etc."
msgstr ""

#. type: node
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:317 orgguide.texi:318 orgguide.texi:329
#, no-wrap
msgid "Outlines"
msgstr ""

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "Org is based on Outline mode"
msgstr ""

#. type: node
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:317 orgguide.texi:329 orgguide.texi:330 orgguide.texi:352
#, no-wrap
msgid "Headlines"
msgstr ""

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "How to typeset Org tree headlines"
msgstr ""

#. type: node
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:329 orgguide.texi:352 orgguide.texi:353 orgguide.texi:394
#, no-wrap
msgid "Visibility cycling"
msgstr ""

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "Show and hide, much simplified"
msgstr ""

#. type: node
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:352 orgguide.texi:394 orgguide.texi:395 orgguide.texi:411
#, no-wrap
msgid "Motion"
msgstr ""

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "Jumping to other headlines"
msgstr ""

#. type: node
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:394 orgguide.texi:411 orgguide.texi:412 orgguide.texi:442
#, no-wrap
msgid "Structure editing"
msgstr ""

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "Changing sequence and level of headlines"
msgstr ""

#. type: node
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:411 orgguide.texi:442 orgguide.texi:443 orgguide.texi:468
#, no-wrap
msgid "Sparse trees"
msgstr ""

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "Matches embedded in context"
msgstr ""

#. type: node
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:442 orgguide.texi:468 orgguide.texi:469 orgguide.texi:535
#, no-wrap
msgid "Plain lists"
msgstr ""

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "Additional structure within an entry"
msgstr ""

#. type: section
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:468 orgguide.texi:535 orgguide.texi:536
#, no-wrap
msgid "Footnotes"
msgstr ""

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "How footnotes are defined in Org's syntax"
msgstr ""

#. type: node
#: orgguide.texi:135 orgguide.texi:705 orgguide.texi:707 orgguide.texi:708 orgguide.texi:724
#, no-wrap
msgid "Link format"
msgstr ""

#. type: menuentry
#: orgguide.texi:135 orgguide.texi:705
msgid "How links in Org are formatted"
msgstr ""

#. type: node
#: orgguide.texi:135 orgguide.texi:705 orgguide.texi:707 orgguide.texi:724 orgguide.texi:725 orgguide.texi:736
#, no-wrap
msgid "Internal links"
msgstr ""

#. type: menuentry
#: orgguide.texi:135 orgguide.texi:705
msgid "Links to other places in the current file"
msgstr ""

#. type: node
#: orgguide.texi:135 orgguide.texi:705 orgguide.texi:724 orgguide.texi:736 orgguide.texi:737 orgguide.texi:780
#, no-wrap
msgid "External links"
msgstr ""

#. type: menuentry
#: orgguide.texi:135 orgguide.texi:705
msgid "URL-like links to the world"
msgstr ""

#. type: node
#: orgguide.texi:135 orgguide.texi:705 orgguide.texi:736 orgguide.texi:780 orgguide.texi:781 orgguide.texi:814
#, no-wrap
msgid "Handling links"
msgstr ""

#. type: menuentry
#: orgguide.texi:135 orgguide.texi:705
msgid "Creating, inserting and following"
msgstr ""

#. type: section
#: orgguide.texi:135 orgguide.texi:705 orgguide.texi:780 orgguide.texi:814 orgguide.texi:815
#, no-wrap
msgid "Targeted links"
msgstr ""

#. type: menuentry
#: orgguide.texi:135 orgguide.texi:705
msgid "Point at a location in a file"
msgstr ""

#. type: node
#: orgguide.texi:144 orgguide.texi:856 orgguide.texi:858 orgguide.texi:859 orgguide.texi:901
#, no-wrap
msgid "Using TODO states"
msgstr ""

#. type: menuentry
#: orgguide.texi:144 orgguide.texi:856
msgid "Setting and switching states"
msgstr ""

#. type: node
#: orgguide.texi:144 orgguide.texi:856 orgguide.texi:858 orgguide.texi:901 orgguide.texi:902 orgguide.texi:951
#, no-wrap
msgid "Multi-state workflows"
msgstr ""

#. type: menuentry
#: orgguide.texi:144 orgguide.texi:856
msgid "More than just on/off"
msgstr ""

#. type: node
#: orgguide.texi:144 orgguide.texi:146 orgguide.texi:856 orgguide.texi:901 orgguide.texi:951 orgguide.texi:952 orgguide.texi:966 orgguide.texi:966 orgguide.texi:992 orgguide.texi:1013
#, no-wrap
msgid "Progress logging"
msgstr ""

#. type: menuentry
#: orgguide.texi:144 orgguide.texi:856
msgid "Dates and notes for progress"
msgstr ""

#. type: node
#: orgguide.texi:144 orgguide.texi:856 orgguide.texi:951 orgguide.texi:1013 orgguide.texi:1014 orgguide.texi:1039
#, no-wrap
msgid "Priorities"
msgstr ""

#. type: menuentry
#: orgguide.texi:144 orgguide.texi:856
msgid "Some things are more important than others"
msgstr ""

#. type: node
#: orgguide.texi:144 orgguide.texi:856 orgguide.texi:1013 orgguide.texi:1039 orgguide.texi:1059
#, no-wrap
msgid "Breaking down tasks"
msgstr ""

#. type: menuentry
#: orgguide.texi:144 orgguide.texi:856
msgid "Splitting a task into manageable pieces"
msgstr ""

#. type: section
#: orgguide.texi:144 orgguide.texi:856 orgguide.texi:1039 orgguide.texi:1059 orgguide.texi:1060
#, no-wrap
msgid "Checkboxes"
msgstr ""

#. type: menuentry
#: orgguide.texi:144 orgguide.texi:856
msgid "Tick-off lists"
msgstr ""

#. type: node
#: orgguide.texi:149 orgguide.texi:964 orgguide.texi:966 orgguide.texi:967 orgguide.texi:992
#, no-wrap
msgid "Closing items"
msgstr ""

#. type: menuentry
#: orgguide.texi:149 orgguide.texi:964
msgid "When was this entry marked DONE?"
msgstr ""

#. type: unnumberedsubsec
#: orgguide.texi:149 orgguide.texi:964 orgguide.texi:966 orgguide.texi:992 orgguide.texi:993
#, no-wrap
msgid "Tracking TODO state changes"
msgstr ""

#. type: menuentry
#: orgguide.texi:149 orgguide.texi:964
msgid "When did the status change?"
msgstr ""

#. type: node
#: orgguide.texi:155 orgguide.texi:1117 orgguide.texi:1119 orgguide.texi:1120 orgguide.texi:1145
#, no-wrap
msgid "Tag inheritance"
msgstr ""

#. type: menuentry
#: orgguide.texi:155 orgguide.texi:1117
msgid "Tags use the tree structure of the outline"
msgstr ""

#. type: node
#: orgguide.texi:155 orgguide.texi:1117 orgguide.texi:1119 orgguide.texi:1145 orgguide.texi:1146 orgguide.texi:1196
#, no-wrap
msgid "Setting tags"
msgstr ""

#. type: menuentry
#: orgguide.texi:155 orgguide.texi:1117
msgid "How to assign tags to a headline"
msgstr ""

#. type: section
#: orgguide.texi:155 orgguide.texi:1117 orgguide.texi:1145 orgguide.texi:1196 orgguide.texi:1197
#, no-wrap
msgid "Tag searches"
msgstr ""

#. type: menuentry
#: orgguide.texi:155 orgguide.texi:1117
msgid "Searching for combinations of tags"
msgstr ""

#. type: node
#: orgguide.texi:162 orgguide.texi:1302 orgguide.texi:1305 orgguide.texi:1306 orgguide.texi:1363
#, no-wrap
msgid "Timestamps"
msgstr ""

#. type: menuentry
#: orgguide.texi:162 orgguide.texi:1302
msgid "Assigning a time to a tree entry"
msgstr ""

#. type: node
#: orgguide.texi:162 orgguide.texi:1302 orgguide.texi:1305 orgguide.texi:1363 orgguide.texi:1364 orgguide.texi:1399
#, no-wrap
msgid "Creating timestamps"
msgstr ""

#. type: menuentry
#: orgguide.texi:162 orgguide.texi:1302
msgid "Commands which insert timestamps"
msgstr ""

#. type: node
#: orgguide.texi:162 orgguide.texi:1302 orgguide.texi:1363 orgguide.texi:1399 orgguide.texi:1400 orgguide.texi:1462
#, no-wrap
msgid "Deadlines and scheduling"
msgstr ""

#. type: menuentry
#: orgguide.texi:162 orgguide.texi:1302
msgid "Planning your work"
msgstr ""

#. type: section
#: orgguide.texi:162 orgguide.texi:1302 orgguide.texi:1399 orgguide.texi:1462 orgguide.texi:1463
#, no-wrap
msgid "Clocking work time"
msgstr ""

#. type: menuentry
#: orgguide.texi:162 orgguide.texi:1302
msgid "Tracking how long you spend on a task"
msgstr ""

#. type: node
#: orgguide.texi:168 orgguide.texi:170 orgguide.texi:1528 orgguide.texi:1530 orgguide.texi:1531 orgguide.texi:1544 orgguide.texi:1544 orgguide.texi:1558 orgguide.texi:1575 orgguide.texi:1618
#, no-wrap
msgid "Capture"
msgstr ""

#. type: node
#: orgguide.texi:168 orgguide.texi:1528 orgguide.texi:1530 orgguide.texi:1618 orgguide.texi:1619 orgguide.texi:1643
#, no-wrap
msgid "Refile and copy"
msgstr ""

#. type: menuentry
#: orgguide.texi:168 orgguide.texi:1528
msgid "Moving a tree from one place to another"
msgstr ""

#. type: section
#: orgguide.texi:168 orgguide.texi:1528 orgguide.texi:1618 orgguide.texi:1643 orgguide.texi:1644
#, no-wrap
msgid "Archiving"
msgstr ""

#. type: menuentry
#: orgguide.texi:168 orgguide.texi:1528
msgid "What to do with finished projects"
msgstr ""

#. type: node
#: orgguide.texi:174 orgguide.texi:1542 orgguide.texi:1544 orgguide.texi:1545 orgguide.texi:1558
#, no-wrap
msgid "Setting up a capture location"
msgstr ""

#. type: menuentry
#: orgguide.texi:174 orgguide.texi:1542
msgid "Where notes will be stored"
msgstr ""

#. type: node
#: orgguide.texi:174 orgguide.texi:1542 orgguide.texi:1544 orgguide.texi:1558 orgguide.texi:1559 orgguide.texi:1575
#, no-wrap
msgid "Using capture"
msgstr ""

#. type: menuentry
#: orgguide.texi:174 orgguide.texi:1542
msgid "Commands to invoke and terminate capture"
msgstr ""

#. type: unnumberedsubsec
#: orgguide.texi:174 orgguide.texi:1542 orgguide.texi:1558 orgguide.texi:1575 orgguide.texi:1576
#, no-wrap
msgid "Capture templates"
msgstr ""

#. type: menuentry
#: orgguide.texi:174 orgguide.texi:1542
msgid "Define the outline of different note types"
msgstr ""

#. type: node
#: orgguide.texi:182 orgguide.texi:1704 orgguide.texi:1706 orgguide.texi:1707 orgguide.texi:1724
#, no-wrap
msgid "Agenda files"
msgstr ""

#. type: menuentry
#: orgguide.texi:182 orgguide.texi:1704
msgid "Files being searched for agenda information"
msgstr ""

#. type: node
#: orgguide.texi:182 orgguide.texi:1704 orgguide.texi:1706 orgguide.texi:1724 orgguide.texi:1745
#, no-wrap
msgid "Agenda dispatcher"
msgstr ""

#. type: menuentry
#: orgguide.texi:182 orgguide.texi:1704
msgid "Keyboard access to agenda views"
msgstr ""

#. type: node
#: orgguide.texi:182 orgguide.texi:1704 orgguide.texi:1724 orgguide.texi:1745 orgguide.texi:1756 orgguide.texi:1756 orgguide.texi:1785 orgguide.texi:1801 orgguide.texi:1847 orgguide.texi:1861 orgguide.texi:1884
#, no-wrap
msgid "Built-in agenda views"
msgstr ""

#. type: menuentry
#: orgguide.texi:182 orgguide.texi:1704
msgid "What is available out of the box?"
msgstr ""

#. type: node
#: orgguide.texi:182 orgguide.texi:1704 orgguide.texi:1745 orgguide.texi:1884 orgguide.texi:1995
#, no-wrap
msgid "Agenda commands"
msgstr ""

#. type: menuentry
#: orgguide.texi:182 orgguide.texi:1704
msgid "Remote editing of Org trees"
msgstr ""

#. type: section
#: orgguide.texi:182 orgguide.texi:1704 orgguide.texi:1884 orgguide.texi:1995 orgguide.texi:1996
#, no-wrap
msgid "Custom agenda views"
msgstr ""

#. type: menuentry
#: orgguide.texi:182 orgguide.texi:1704
msgid "Defining special searches and views"
msgstr ""

#. type: section
#: orgguide.texi:184 orgguide.texi:1746
#, no-wrap
msgid "The built-in agenda views"
msgstr ""

#. type: node
#: orgguide.texi:190 orgguide.texi:1754 orgguide.texi:1756 orgguide.texi:1785
#, no-wrap
msgid "Weekly/daily agenda"
msgstr ""

#. type: menuentry
#: orgguide.texi:190 orgguide.texi:1754
msgid "The calendar page with current tasks"
msgstr ""

#. type: node
#: orgguide.texi:190 orgguide.texi:1754 orgguide.texi:1756 orgguide.texi:1785 orgguide.texi:1801
#, no-wrap
msgid "Global TODO list"
msgstr ""

#. type: menuentry
#: orgguide.texi:190 orgguide.texi:1754
msgid "All unfinished action items"
msgstr ""

#. type: node
#: orgguide.texi:190 orgguide.texi:1754 orgguide.texi:1785 orgguide.texi:1801 orgguide.texi:1802 orgguide.texi:1847
#, no-wrap
msgid "Matching tags and properties"
msgstr ""

#. type: menuentry
#: orgguide.texi:190 orgguide.texi:1754
msgid "Structured information with fine-tuned search"
msgstr ""

#. type: node
#: orgguide.texi:190 orgguide.texi:1754 orgguide.texi:1801 orgguide.texi:1847 orgguide.texi:1861
#, no-wrap
msgid "Timeline"
msgstr ""

#. type: menuentry
#: orgguide.texi:190 orgguide.texi:1754
msgid "Time-sorted view for single file"
msgstr ""

#. type: subsection
#: orgguide.texi:190 orgguide.texi:1754 orgguide.texi:1847 orgguide.texi:1861 orgguide.texi:1862
#, no-wrap
msgid "Search view"
msgstr ""

#. type: menuentry
#: orgguide.texi:190 orgguide.texi:1754
msgid "Find entries by searching for text"
msgstr ""

#. type: chapter
#: orgguide.texi:192 orgguide.texi:2045
#, no-wrap
msgid "Markup for rich export"
msgstr ""

#. type: node
#: orgguide.texi:198 orgguide.texi:200 orgguide.texi:2059 orgguide.texi:2061 orgguide.texi:2062 orgguide.texi:2073 orgguide.texi:2073 orgguide.texi:2083 orgguide.texi:2098 orgguide.texi:2109 orgguide.texi:2147 orgguide.texi:2156 orgguide.texi:2170
#, no-wrap
msgid "Structural markup elements"
msgstr ""

#. type: menuentry
#: orgguide.texi:198 orgguide.texi:2059
msgid "The basic structure as seen by the exporter"
msgstr ""

#. type: node
#: orgguide.texi:198 orgguide.texi:2059 orgguide.texi:2061 orgguide.texi:2170 orgguide.texi:2203
#, no-wrap
msgid "Images and tables"
msgstr ""

#. type: menuentry
#: orgguide.texi:198 orgguide.texi:2059
msgid "Tables and Images will be included"
msgstr ""

#. type: node
#: orgguide.texi:198 orgguide.texi:2059 orgguide.texi:2170 orgguide.texi:2203 orgguide.texi:2204 orgguide.texi:2240
#, no-wrap
msgid "Literal examples"
msgstr ""

#. type: menuentry
#: orgguide.texi:198 orgguide.texi:2059
msgid "Source code examples with special formatting"
msgstr ""

#. type: node
#: orgguide.texi:198 orgguide.texi:2059 orgguide.texi:2203 orgguide.texi:2240 orgguide.texi:2241 orgguide.texi:2256
#, no-wrap
msgid "Include files"
msgstr ""

#. type: menuentry
#: orgguide.texi:198 orgguide.texi:2059
msgid "Include additional files into a document"
msgstr ""

#. type: section
#: orgguide.texi:198 orgguide.texi:2059 orgguide.texi:2240 orgguide.texi:2256 orgguide.texi:2257
#, no-wrap
msgid "Embedded @LaTeX{}"
msgstr ""

#. type: menuentry
#: orgguide.texi:198 orgguide.texi:2059
msgid "@LaTeX{} can be freely used inside Org documents"
msgstr ""

#. type: node
#: orgguide.texi:207 orgguide.texi:2071 orgguide.texi:2073 orgguide.texi:2074 orgguide.texi:2083
#, no-wrap
msgid "Document title"
msgstr ""

#. type: menuentry
#: orgguide.texi:207 orgguide.texi:2071
msgid "Where the title is taken from"
msgstr ""

#. type: node
#: orgguide.texi:207 orgguide.texi:2071 orgguide.texi:2073 orgguide.texi:2083 orgguide.texi:2084 orgguide.texi:2098
#, no-wrap
msgid "Headings and sections"
msgstr ""

#. type: menuentry
#: orgguide.texi:207 orgguide.texi:2071
msgid "The document structure as seen by the exporter"
msgstr ""

#. type: node
#: orgguide.texi:207 orgguide.texi:2071 orgguide.texi:2083 orgguide.texi:2098 orgguide.texi:2099 orgguide.texi:2109
#, no-wrap
msgid "Table of contents"
msgstr ""

#. type: menuentry
#: orgguide.texi:207 orgguide.texi:2071
msgid "The if and where of the table of contents"
msgstr ""

#. type: node
#: orgguide.texi:207 orgguide.texi:207 orgguide.texi:2071 orgguide.texi:2071 orgguide.texi:2098 orgguide.texi:2109 orgguide.texi:2147
#, no-wrap
msgid "Paragraphs"
msgstr ""

#. type: node
#: orgguide.texi:207 orgguide.texi:2071 orgguide.texi:2109 orgguide.texi:2147 orgguide.texi:2148 orgguide.texi:2156
#, no-wrap
msgid "Emphasis and monospace"
msgstr ""

#. type: menuentry
#: orgguide.texi:207 orgguide.texi:2071
msgid "Bold, italic, etc."
msgstr ""

#. type: subheading
#: orgguide.texi:207 orgguide.texi:2071 orgguide.texi:2147 orgguide.texi:2156 orgguide.texi:2157
#, no-wrap
msgid "Comment lines"
msgstr ""

#. type: menuentry
#: orgguide.texi:207 orgguide.texi:2071
msgid "What will *not* be exported"
msgstr ""

#. type: node
#: orgguide.texi:217 orgguide.texi:2298 orgguide.texi:2300 orgguide.texi:2301 orgguide.texi:2329
#, no-wrap
msgid "Export options"
msgstr ""

#. type: menuentry
#: orgguide.texi:217 orgguide.texi:2298
msgid "Per-file export settings"
msgstr ""

#. type: node
#: orgguide.texi:217 orgguide.texi:2298 orgguide.texi:2300 orgguide.texi:2329 orgguide.texi:2330 orgguide.texi:2343
#, no-wrap
msgid "The export dispatcher"
msgstr ""

#. type: menuentry
#: orgguide.texi:217 orgguide.texi:2298
msgid "How to access exporter commands"
msgstr ""

#. type: node
#: orgguide.texi:217 orgguide.texi:2298 orgguide.texi:2329 orgguide.texi:2343 orgguide.texi:2344 orgguide.texi:2359
#, no-wrap
msgid "ASCII/Latin-1/UTF-8 export"
msgstr ""

#. type: menuentry
#: orgguide.texi:217 orgguide.texi:2298
msgid "Exporting to flat files with encoding"
msgstr ""

#. type: node
#: orgguide.texi:217 orgguide.texi:2298 orgguide.texi:2343 orgguide.texi:2359 orgguide.texi:2360 orgguide.texi:2382
#, no-wrap
msgid "HTML export"
msgstr ""

#. type: menuentry
#: orgguide.texi:217 orgguide.texi:2298
msgid "Exporting to HTML"
msgstr ""

#. type: node
#: orgguide.texi:217 orgguide.texi:2298 orgguide.texi:2359 orgguide.texi:2382 orgguide.texi:2383 orgguide.texi:2403
#, no-wrap
msgid "@LaTeX{} and PDF export"
msgstr ""

#. type: menuentry
#: orgguide.texi:217 orgguide.texi:2298
msgid "Exporting to @LaTeX{}, and processing to PDF"
msgstr ""

#. type: node
#: orgguide.texi:217 orgguide.texi:2298 orgguide.texi:2382 orgguide.texi:2403 orgguide.texi:2404 orgguide.texi:2415
#, no-wrap
msgid "DocBook export"
msgstr ""

#. type: menuentry
#: orgguide.texi:217 orgguide.texi:2298
msgid "Exporting to DocBook"
msgstr ""

#. type: section
#: orgguide.texi:217 orgguide.texi:2298 orgguide.texi:2403 orgguide.texi:2415 orgguide.texi:2416
#, no-wrap
msgid "iCalendar export"
msgstr ""

#. type: node
#: orgguide.texi:223 orgguide.texi:2606 orgguide.texi:2608 orgguide.texi:2609 orgguide.texi:2618
#, no-wrap
msgid "Completion"
msgstr ""

#. type: menuentry
#: orgguide.texi:223 orgguide.texi:2606
msgid "M-TAB knows what you need"
msgstr ""

#. type: node
#: orgguide.texi:223 orgguide.texi:2606 orgguide.texi:2608 orgguide.texi:2618 orgguide.texi:2662
#, no-wrap
msgid "Clean view"
msgstr ""

#. type: menuentry
#: orgguide.texi:223 orgguide.texi:2606
msgid "Getting rid of leading stars in the outline"
msgstr ""

#. type: section
#: orgguide.texi:223 orgguide.texi:2606 orgguide.texi:2618 orgguide.texi:2662 orgguide.texi:2663
#, no-wrap
msgid "MobileOrg"
msgstr ""

#. type: menuentry
#: orgguide.texi:223 orgguide.texi:2606
msgid "Org-mode on the iPhone"
msgstr ""

#. type: Plain text
#: orgguide.texi:243
msgid ""
"Org is a mode for keeping notes, maintaining TODO lists, and doing project "
"planning with a fast and effective plain-text system.  It is also an "
"authoring and publishing system."
msgstr ""

#. type: i{#1}
#: orgguide.texi:249
msgid ""
"This document is a much compressed derivative of the "
"@uref{http://orgmode.org/index.html#sec-4_1, comprehensive Org-mode "
"manual}.  It contains all basic features and commands, along with important "
"hints for customization.  It is intended for beginners who would shy back "
"from a 200 page manual because of sheer size."
msgstr ""

#. type: Plain text
#: orgguide.texi:256
msgid ""
"@b{Important:} @i{If you are using a version of Org that is part of the "
"Emacs distribution or an XEmacs package, please skip this section and go "
"directly to @ref{Activation}.}"
msgstr ""

#. type: Plain text
#: orgguide.texi:261
msgid ""
"If you have downloaded Org from the Web, either as a distribution "
"@file{.zip} or @file{.tar} file, or as a Git archive, it is best to run it "
"directly from the distribution directory.  You need to add the @file{lisp} "
"subdirectories to the Emacs load path.  To do this, add the following line "
"to @file{.emacs}:"
msgstr ""

#. type: smallexample
#: orgguide.texi:265
#, no-wrap
msgid ""
"(setq load-path (cons \"~/path/to/orgdir/lisp\" load-path))\n"
"(setq load-path (cons \"~/path/to/orgdir/contrib/lisp\" load-path))\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:269
msgid "command:"
msgstr ""

#. type: smallexample
#: orgguide.texi:272
#, no-wrap
msgid "make\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:280
msgid ""
"Add the following lines to your @file{.emacs} file.  The last three lines "
"define @emph{global} keys for some commands --- please choose suitable keys "
"yourself."
msgstr ""

#. type: smalllisp
#: orgguide.texi:288
#, no-wrap
msgid ""
";; The following lines are always needed.  Choose your own keys.\n"
"(add-to-list 'auto-mode-alist '(\"\\\\.org\\\\'\" . org-mode)) ; not needed "
"since Emacs 22.2\n"
"(add-hook 'org-mode-hook 'turn-on-font-lock) ; not needed when "
"global-font-lock-mode is on\n"
"(global-set-key \"\\C-cl\" 'org-store-link)\n"
"(global-set-key \"\\C-ca\" 'org-agenda)\n"
"(global-set-key \"\\C-cb\" 'org-iswitchb)\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:292
msgid ""
"With this setup, all files with extension @samp{.org} will be put into Org "
"mode."
msgstr ""

#. type: Plain text
#: orgguide.texi:299
msgid ""
"If you find problems with Org, or if you have questions, remarks, or ideas "
"about it, please mail to the Org mailing list "
"@email{emacs-orgmode@@gnu.org}.  For information on how to submit bug "
"reports, see the main manual."
msgstr ""

#. type: Plain text
#: orgguide.texi:305
msgid ""
"Org is based on Outline mode and provides flexible commands to edit the "
"structure of the document."
msgstr ""

#. type: Plain text
#: orgguide.texi:328
msgid ""
"Org is implemented on top of Outline mode.  Outlines allow a document to be "
"organized in a hierarchical structure, which (at least for me) is the best "
"representation of notes and thoughts.  An overview of this structure is "
"achieved by folding (hiding) large parts of the document to show only the "
"general document structure and the parts currently being worked on.  Org "
"greatly simplifies the use of outlines by compressing the entire show/hide "
"functionality into a single command, @command{org-cycle}, which is bound to "
"the @key{TAB} key."
msgstr ""

#. type: Plain text
#: orgguide.texi:336
msgid ""
"Headlines define the structure of an outline tree.  The headlines in Org "
"start with one or more stars, on the left margin@footnote{See the variable "
"@code{org-special-ctrl-a/e} to configure special behavior of @kbd{C-a} and "
"@kbd{C-e} in headlines.}.  For example:"
msgstr ""

#. type: smallexample
#: orgguide.texi:344
#, no-wrap
msgid ""
"* Top level headline\n"
"** Second level\n"
"*** 3rd level\n"
"    some text\n"
"*** 3rd level\n"
"    more text\n"
"\n"
msgstr ""

#. type: smallexample
#: orgguide.texi:346
#, no-wrap
msgid "* Another top level headline\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:351
msgid ""
"outline that has whitespace followed by a single star as headline starters.  "
"@ref{Clean view}, describes a setup to realize this."
msgstr ""

#. type: Plain text
#: orgguide.texi:358
msgid ""
"Outlines make it possible to hide parts of the text in the buffer.  Org uses "
"just two commands, bound to @key{TAB} and @kbd{S-@key{TAB}} to change the "
"visibility in the buffer."
msgstr ""

#. type: key{#1}
#: orgguide.texi:360 orgguide.texi:511 orgguide.texi:636 orgguide.texi:1906
#, no-wrap
msgid "TAB"
msgstr ""

#. type: table
#: orgguide.texi:362
msgid "@emph{Subtree cycling}: Rotate current subtree among the states"
msgstr ""

#. type: smallexample
#: orgguide.texi:366
#, no-wrap
msgid ""
",-> FOLDED -> CHILDREN -> SUBTREE --.\n"
"'-----------------------------------'\n"
msgstr ""

#. type: table
#: orgguide.texi:370
msgid ""
"When called with a prefix argument (@kbd{C-u @key{TAB}}) or with the shift "
"key, global cycling is invoked."
msgstr ""

#. type: item
#: orgguide.texi:371
#, no-wrap
msgid "S-@key{TAB} @r{and} C-u @key{TAB}"
msgstr ""

#. type: table
#: orgguide.texi:373
msgid "@emph{Global cycling}: Rotate the entire buffer among the states"
msgstr ""

#. type: smallexample
#: orgguide.texi:377
#, no-wrap
msgid ""
",-> OVERVIEW -> CONTENTS -> SHOW ALL --.\n"
"'--------------------------------------'\n"
msgstr ""

#. type: item
#: orgguide.texi:379
#, no-wrap
msgid "C-u C-u C-u @key{TAB}"
msgstr ""

#. type: table
#: orgguide.texi:381
msgid "Show all, including drawers."
msgstr ""

#. type: Plain text
#: orgguide.texi:388
msgid ""
"When Emacs first visits an Org file, the global state is set to OVERVIEW, "
"i.e.@: only the top level headlines are visible.  This can be configured "
"through the variable @code{org-startup-folded}, or on a per-file basis by "
"adding a startup keyword @code{overview}, @code{content}, @code{showall}, "
"like this:"
msgstr ""

#. type: smallexample
#: orgguide.texi:391
#, no-wrap
msgid "#+STARTUP: content\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:397
msgid "The following commands jump to other headlines in the buffer."
msgstr ""

#. type: item
#: orgguide.texi:399
#, no-wrap
msgid "C-c C-n"
msgstr ""

#. type: table
#: orgguide.texi:401
msgid "Next heading."
msgstr ""

#. type: item
#: orgguide.texi:401
#, no-wrap
msgid "C-c C-p"
msgstr ""

#. type: table
#: orgguide.texi:403
msgid "Previous heading."
msgstr ""

#. type: item
#: orgguide.texi:403
#, no-wrap
msgid "C-c C-f"
msgstr ""

#. type: table
#: orgguide.texi:405
msgid "Next heading same level."
msgstr ""

#. type: item
#: orgguide.texi:405
#, no-wrap
msgid "C-c C-b"
msgstr ""

#. type: table
#: orgguide.texi:407
msgid "Previous heading same level."
msgstr ""

#. type: item
#: orgguide.texi:407
#, no-wrap
msgid "C-c C-u"
msgstr ""

#. type: table
#: orgguide.texi:409
msgid "Backward to higher level heading."
msgstr ""

#. type: item
#: orgguide.texi:415 orgguide.texi:513
#, no-wrap
msgid "M-@key{RET}"
msgstr ""

#. type: table
#: orgguide.texi:421
msgid ""
"Insert new heading with same level as current.  If the cursor is in a plain "
"list item, a new item is created (@pxref{Plain lists}).  When this command "
"is used in the middle of a line, the line is split and the rest of the line "
"becomes the new headline@footnote{If you do not want the line to be split, "
"customize the variable @code{org-M-RET-may-split-line}.}."
msgstr ""

#. type: item
#: orgguide.texi:421 orgguide.texi:516 orgguide.texi:1087
#, no-wrap
msgid "M-S-@key{RET}"
msgstr ""

#. type: table
#: orgguide.texi:423
msgid "Insert new TODO entry with same level as current heading."
msgstr ""

#. type: item
#: orgguide.texi:423
#, no-wrap
msgid "@key{TAB} @r{in new, empty entry}"
msgstr ""

#. type: table
#: orgguide.texi:426
msgid ""
"In a new entry with no text yet, @key{TAB} will cycle through reasonable "
"levels."
msgstr ""

#. type: item
#: orgguide.texi:426
#, no-wrap
msgid "M-@key{left}@r{/}@key{right}"
msgstr ""

#. type: table
#: orgguide.texi:428
msgid "Promote/demote current heading by one level."
msgstr ""

#. type: item
#: orgguide.texi:428 orgguide.texi:524
#, no-wrap
msgid "M-S-@key{left}@r{/}@key{right}"
msgstr ""

#. type: table
#: orgguide.texi:430
msgid "Promote/demote the current subtree by one level."
msgstr ""

#. type: item
#: orgguide.texi:430 orgguide.texi:518
#, no-wrap
msgid "M-S-@key{up}@r{/}@key{down}"
msgstr ""

#. type: table
#: orgguide.texi:433
msgid "Move subtree up/down (swap with previous/next subtree of same level)."
msgstr ""

#. type: item
#: orgguide.texi:433 orgguide.texi:1569 orgguide.texi:1630 orgguide.texi:1966
#, no-wrap
msgid "C-c C-w"
msgstr ""

#. type: table
#: orgguide.texi:435
msgid "Refile entry or region to a different location.  @xref{Refile and copy}."
msgstr ""

#. type: item
#: orgguide.texi:435
#, no-wrap
msgid "C-x n s/w"
msgstr ""

#. type: table
#: orgguide.texi:437
msgid "Narrow buffer to current subtree / widen it again"
msgstr ""

#. type: Plain text
#: orgguide.texi:441
msgid ""
"When there is an active region (Transient Mark mode), promotion and demotion "
"work on all headlines in the region."
msgstr ""

#. type: Plain text
#: orgguide.texi:453
msgid ""
"An important feature of Org mode is the ability to construct @emph{sparse "
"trees} for selected information in an outline tree, so that the entire "
"document is folded as much as possible, but the selected information is made "
"visible along with the headline structure above it@footnote{See also the "
"variables @code{org-show-hierarchy-above}, "
"@code{org-show-following-heading}, @code{org-show-siblings}, and "
"@code{org-show-entry-below} for detailed control on how much context is "
"shown around each match.}.  Just try it out and you will see immediately how "
"it works."
msgstr ""

#. type: Plain text
#: orgguide.texi:456
msgid ""
"Org mode contains several commands creating such trees, all these commands "
"can be accessed through a dispatcher:"
msgstr ""

#. type: item
#: orgguide.texi:458
#, no-wrap
msgid "C-c /"
msgstr ""

#. type: table
#: orgguide.texi:460
msgid "This prompts for an extra key to select a sparse-tree creating command."
msgstr ""

#. type: item
#: orgguide.texi:460
#, no-wrap
msgid "C-c / r"
msgstr ""

#. type: table
#: orgguide.texi:463
msgid ""
"Occur.  Prompts for a regexp and shows a sparse tree with all matches.  Each "
"match is also highlighted; the highlights disappear by pressing @kbd{C-c "
"C-c}."
msgstr ""

#. type: Plain text
#: orgguide.texi:467
msgid ""
"The other sparse tree commands select headings based on TODO keywords, tags, "
"or properties and will be discussed later in this manual."
msgstr ""

#. type: Plain text
#: orgguide.texi:475
msgid ""
"Within an entry of the outline tree, hand-formatted lists can provide "
"additional structure.  They also provide a way to create lists of checkboxes "
"(@pxref{Checkboxes}).  Org supports editing such lists, and the HTML "
"exporter (@pxref{Exporting}) parses and formats them."
msgstr ""

#. type: Plain text
#: orgguide.texi:477
msgid "Org knows ordered lists, unordered lists, and description lists."
msgstr ""

#. type: itemize
#: orgguide.texi:481
msgid ""
"@emph{Unordered} list items start with @samp{-}, @samp{+}, or @samp{*} as "
"bullets."
msgstr ""

#. type: itemize
#: orgguide.texi:483
msgid "@emph{Ordered} list items start with @samp{1.} or @samp{1)}."
msgstr ""

#. type: itemize
#: orgguide.texi:486
msgid ""
"@emph{Description} list use @samp{ :: } to separate the @emph{term} from the "
"description."
msgstr ""

#. type: Plain text
#: orgguide.texi:492
msgid ""
"Items belonging to the same list must have the same indentation on the first "
"line.  An item ends before the next line that is indented like its "
"bullet/number, or less.  A list ends when all items are closed, or before "
"two blank lines.  An example:"
msgstr ""

#. type: group
#: orgguide.texi:504
#, no-wrap
msgid ""
"** Lord of the Rings\n"
"   My favorite scenes are (in this order)\n"
"   1. The attack of the Rohirrim\n"
"   2. Eowyn's fight with the witch king\n"
"      + this was already my favorite scene in the book\n"
"      + I really like Miranda Otto.\n"
"   Important actors in this film are:\n"
"   - @b{Elijah Wood} :: He plays Frodo\n"
"   - @b{Sean Austin} :: He plays Sam, Frodo's friend.\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:509
msgid ""
"The following commands act on items when the cursor is in the first line of "
"an item (the line with the bullet or number)."
msgstr ""

#. type: table
#: orgguide.texi:513
msgid "Items can be folded just like headline levels."
msgstr ""

#. type: table
#: orgguide.texi:516
msgid ""
"Insert new item at current level.  With a prefix argument, force a new "
"heading (@pxref{Structure editing})."
msgstr ""

#. type: table
#: orgguide.texi:518
msgid "Insert a new item with a checkbox (@pxref{Checkboxes})."
msgstr ""

#. type: table
#: orgguide.texi:522
msgid ""
"Move the item including subitems up/down (swap with previous/next item of "
"same indentation).  If the list is ordered, renumbering is automatic."
msgstr ""

#. type: item
#: orgguide.texi:522
#, no-wrap
msgid "M-@key{left}@r{/}M-@key{right}"
msgstr ""

#. type: table
#: orgguide.texi:524
msgid "Decrease/increase the indentation of an item, leaving children alone."
msgstr ""

#. type: table
#: orgguide.texi:526
msgid "Decrease/increase the indentation of the item, including subitems."
msgstr ""

#. type: item
#: orgguide.texi:526 orgguide.texi:558 orgguide.texi:633 orgguide.texi:1085 orgguide.texi:1160 orgguide.texi:1498 orgguide.texi:1565
#, no-wrap
msgid "C-c C-c"
msgstr ""

#. type: table
#: orgguide.texi:530
msgid ""
"If there is a checkbox (@pxref{Checkboxes}) in the item line, toggle the "
"state of the checkbox.  Also verify bullets and indentation consistency in "
"the whole list."
msgstr ""

#. type: item
#: orgguide.texi:530 orgguide.texi:669
#, no-wrap
msgid "C-c -"
msgstr ""

#. type: table
#: orgguide.texi:533
msgid ""
"Cycle the entire list level through the different itemize/enumerate bullets "
"(@samp{-}, @samp{+}, @samp{*}, @samp{1.}, @samp{1)})."
msgstr ""

#. type: Plain text
#: orgguide.texi:541
msgid ""
"A footnote is defined in a paragraph that is started by a footnote marker in "
"square brackets in column 0, no indentation allowed.  The footnote reference "
"is simply the marker in square brackets, inside text.  For example:"
msgstr ""

#. type: smallexample
#: orgguide.texi:546
#, no-wrap
msgid ""
"The Org homepage[fn:1] now looks a lot better than it used to.\n"
"...\n"
"[fn:1] The link is: http://orgmode.org\n"
msgstr ""

#. type: item
#: orgguide.texi:551
#, no-wrap
msgid "C-c C-x f"
msgstr ""

#. type: table
#: orgguide.texi:557
msgid ""
"The footnote action command.  When the cursor is on a footnote reference, "
"jump to the definition.  When it is at a definition, jump to the (first)  "
"reference.  Otherwise, create a new footnote.  When this command is called "
"with a prefix argument, a menu of additional options including renumbering "
"is offered."
msgstr ""

#. type: table
#: orgguide.texi:560
msgid "Jump between definition and reference."
msgstr ""

#. type: Plain text
#: orgguide.texi:567
msgid ""
"@seealso{ "
"@uref{http://orgmode.org/manual/Document-Structure.html#Document-Structure, "
"Chapter 2 of the manual}@* "
"@uref{http://sachachua.com/wp/2008/01/outlining-your-notes-with-org/, Sacha "
"Chua's tutorial}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:575
msgid ""
"Org comes with a fast and intuitive table editor.  Spreadsheet-like "
"calculations are supported in connection with the Emacs @file{calc} package"
msgstr ""

#. type: ifinfo
#: orgguide.texi:577
msgid "(@pxref{Top,Calc,,Calc,Gnu Emacs Calculator Manual})."
msgstr ""

#. type: ifnotinfo
#: orgguide.texi:581
msgid ""
"(see the Emacs Calculator manual for more information about the Emacs "
"calculator)."
msgstr ""

#. type: Plain text
#: orgguide.texi:587
msgid ""
"Org makes it easy to format tables in plain ASCII.  Any line with @samp{|} "
"as the first non-whitespace character is considered part of a table.  "
"@samp{|} is also the column separator.  A table might look like this:"
msgstr ""

#. type: smallexample
#: orgguide.texi:593
#, no-wrap
msgid ""
"| Name  | Phone | Age |\n"
"|-------+-------+-----|\n"
"| Peter |  1234 |  17 |\n"
"| Anna  |  4321 |  25 |\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:603
msgid ""
"A table is re-aligned automatically each time you press @key{TAB} or "
"@key{RET} or @kbd{C-c C-c} inside the table.  @key{TAB} also moves to the "
"next field (@key{RET} to the next row) and creates new table rows at the end "
"of the table or before horizontal lines.  The indentation of the table is "
"set by the first line.  Any line starting with @samp{|-} is considered as a "
"horizontal separator line and will be expanded on the next re-align to span "
"the whole table width.  So, to create the above table, you would only type"
msgstr ""

#. type: smallexample
#: orgguide.texi:607
#, no-wrap
msgid ""
"|Name|Phone|Age|\n"
"|-\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:612
msgid ""
"fields.  Even faster would be to type @code{|Name|Phone|Age} followed by "
"@kbd{C-c @key{RET}}."
msgstr ""

#. type: Plain text
#: orgguide.texi:619
msgid ""
"When typing text into a field, Org treats @key{DEL}, @key{Backspace}, and "
"all character keys in a special way, so that inserting and deleting avoids "
"shifting other fields.  Also, when typing @emph{immediately after the cursor "
"was moved into a new field with @kbd{@key{TAB}}, @kbd{S-@key{TAB}} or "
"@kbd{@key{RET}}}, the field is automatically made blank."
msgstr ""

#. type: table
#: orgguide.texi:622
msgid "@tsubheading{Creation and conversion}"
msgstr ""

#. type: item
#: orgguide.texi:622
#, no-wrap
msgid "C-c |"
msgstr ""

#. type: table
#: orgguide.texi:631
msgid ""
"Convert the active region to table.  If every line contains at least one TAB "
"character, the function assumes that the material is tab separated.  If "
"every line contains a comma, comma-separated values (CSV) are assumed.  If "
"not, lines are split at whitespace into fields.  @* If there is no active "
"region, this command creates an empty Org table.  But it's easier just to "
"start typing, like @kbd{|Name|Phone|Age C-c @key{RET}}."
msgstr ""

#. type: table
#: orgguide.texi:633
msgid "@tsubheading{Re-aligning and field motion}"
msgstr ""

#. type: table
#: orgguide.texi:636
msgid "Re-align the table without moving the cursor."
msgstr ""

#. type: table
#: orgguide.texi:640
msgid "Re-align the table, move to the next field.  Creates a new row if necessary."
msgstr ""

#. type: item
#: orgguide.texi:640
#, no-wrap
msgid "S-@key{TAB}"
msgstr ""

#. type: table
#: orgguide.texi:643
msgid "Re-align, move to previous field."
msgstr ""

#. type: key{#1}
#: orgguide.texi:643 orgguide.texi:1910
#, no-wrap
msgid "RET"
msgstr ""

#. type: table
#: orgguide.texi:646
msgid ""
"Re-align the table and move down to next row.  Creates a new row if "
"necessary."
msgstr ""

#. type: table
#: orgguide.texi:648
msgid "@tsubheading{Column and row editing}"
msgstr ""

#. type: item
#: orgguide.texi:648
#, no-wrap
msgid "M-@key{left}"
msgstr ""

#. type: itemx
#: orgguide.texi:649
#, no-wrap
msgid "M-@key{right}"
msgstr ""

#. type: table
#: orgguide.texi:652
msgid "Move the current column left/right."
msgstr ""

#. type: item
#: orgguide.texi:652
#, no-wrap
msgid "M-S-@key{left}"
msgstr ""

#. type: table
#: orgguide.texi:655
msgid "Kill the current column."
msgstr ""

#. type: item
#: orgguide.texi:655
#, no-wrap
msgid "M-S-@key{right}"
msgstr ""

#. type: table
#: orgguide.texi:658
msgid "Insert a new column to the left of the cursor position."
msgstr ""

#. type: item
#: orgguide.texi:658
#, no-wrap
msgid "M-@key{up}"
msgstr ""

#. type: itemx
#: orgguide.texi:659
#, no-wrap
msgid "M-@key{down}"
msgstr ""

#. type: table
#: orgguide.texi:662
msgid "Move the current row up/down."
msgstr ""

#. type: item
#: orgguide.texi:662
#, no-wrap
msgid "M-S-@key{up}"
msgstr ""

#. type: table
#: orgguide.texi:665
msgid "Kill the current row or horizontal line."
msgstr ""

#. type: item
#: orgguide.texi:665
#, no-wrap
msgid "M-S-@key{down}"
msgstr ""

#. type: table
#: orgguide.texi:669
msgid ""
"Insert a new row above the current row.  With a prefix argument, the line is "
"created below the current one."
msgstr ""

#. type: table
#: orgguide.texi:673
msgid ""
"Insert a horizontal line below current row.  With a prefix argument, the "
"line is created above the current line."
msgstr ""

#. type: item
#: orgguide.texi:673
#, no-wrap
msgid "C-c @key{RET}"
msgstr ""

#. type: table
#: orgguide.texi:677
msgid ""
"Insert a horizontal line below current row, and move the cursor into the row "
"below that line."
msgstr ""

#. type: item
#: orgguide.texi:677
#, no-wrap
msgid "C-c ^"
msgstr ""

#. type: table
#: orgguide.texi:681
msgid ""
"Sort the table lines in the region.  The position of point indicates the "
"column to be used for sorting, and the range of lines is the range between "
"the nearest horizontal separator lines, or the entire table."
msgstr ""

#. type: Plain text
#: orgguide.texi:692
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Tables.html#Tables, Chapter 3 of "
"the manual}@* @uref{http://orgmode.org/worg/org-tutorials/tables.php, "
"Bastien's table tutorial}@* "
"@uref{http://orgmode.org/worg/org-tutorials/org-spreadsheet-intro.php, "
"Bastien's spreadsheet tutorial}@* "
"@uref{http://orgmode.org/worg/org-tutorials/org-plot.php, Eric's plotting "
"tutorial}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:698
msgid ""
"Like HTML, Org provides links inside a file, external links to other files, "
"Usenet articles, emails, and much more."
msgstr ""

#. type: Plain text
#: orgguide.texi:712
msgid ""
"Org will recognize plain URL-like links and activate them as clickable "
"links.  The general link format, however, looks like this:"
msgstr ""

#. type: smallexample
#: orgguide.texi:715
#, no-wrap
msgid "[[link][description]]       @r{or alternatively}           [[link]]\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:723
msgid ""
"Once a link in the buffer is complete (all brackets present), Org will "
"change the display so that @samp{description} is displayed instead of "
"@samp{[[link][description]]} and @samp{link} is displayed instead of "
"@samp{[[link]]}.  To edit the invisible @samp{link} part, use @kbd{C-c C-l} "
"with the cursor on the link."
msgstr ""

#. type: Plain text
#: orgguide.texi:731
msgid ""
"If the link does not look like a URL, it is considered to be internal in the "
"current file.  The most important case is a link like "
"@samp{[[#my-custom-id]]} which will link to the entry with the "
"@code{CUSTOM_ID} property @samp{my-custom-id}."
msgstr ""

#. type: Plain text
#: orgguide.texi:735
msgid ""
"Links such as @samp{[[My Target]]} or @samp{[[My Target][Find my target]]} "
"lead to a text search in the current file for the corresponding target which "
"looks like @samp{<<My Target>>}."
msgstr ""

#. type: Plain text
#: orgguide.texi:744
msgid ""
"Org supports links to files, websites, Usenet and email messages, BBDB "
"database entries and links to both IRC conversations and their logs.  "
"External links are URL-like locators.  They start with a short identifying "
"string followed by a colon.  There can be no space after the colon.  Here "
"are some examples:"
msgstr ""

#. type: smallexample
#: orgguide.texi:764
#, no-wrap
msgid ""
"http://www.astro.uva.nl/~dominik          @r{on the web}\n"
"file:/home/dominik/images/jupiter.jpg     @r{file, absolute path}\n"
"/home/dominik/images/jupiter.jpg          @r{same as above}\n"
"file:papers/last.pdf                      @r{file, relative path}\n"
"file:projects.org                         @r{another Org file}\n"
"docview:papers/last.pdf::NNN              @r{open file in doc-view mode at "
"page NNN}\n"
"id:B7423F4D-2E8A-471B-8810-C40F074717E9   @r{Link to heading by ID}\n"
"news:comp.emacs                           @r{Usenet link}\n"
"mailto:adent@@galaxy.net                   @r{Mail link}\n"
"vm:folder                                 @r{VM folder link}\n"
"vm:folder#id                              @r{VM message link}\n"
"wl:folder#id                              @r{WANDERLUST message link}\n"
"mhe:folder#id                             @r{MH-E message link}\n"
"rmail:folder#id                           @r{RMAIL message link}\n"
"gnus:group#id                             @r{Gnus article link}\n"
"bbdb:R.*Stallman                          @r{BBDB link (with regexp)}\n"
"irc:/irc.com/#emacs/bob                   @r{IRC link}\n"
"info:org:External%20links                 @r{Info node link (with encoded "
"space)}\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:769
msgid ""
"A link should be enclosed in double brackets and may contain a descriptive "
"text to be displayed instead of the URL (@pxref{Link format}), for example:"
msgstr ""

#. type: smallexample
#: orgguide.texi:772
#, no-wrap
msgid "[[http://www.gnu.org/software/emacs/][GNU Emacs]]\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:779
msgid ""
"If the description is a file name or URL that points to an image, HTML "
"export (@pxref{HTML export}) will inline the image as a clickable button.  "
"If there is no description at all and the link points to an image, that "
"image will be inlined into the exported HTML file."
msgstr ""

#. type: Plain text
#: orgguide.texi:785
msgid ""
"Org provides methods to create a link in the correct syntax, to insert it "
"into an Org file, and to follow the link."
msgstr ""

#. type: item
#: orgguide.texi:787
#, no-wrap
msgid "C-c l"
msgstr ""

#. type: table
#: orgguide.texi:793
msgid ""
"Store a link to the current location.  This is a @emph{global} command (you "
"must create the key binding yourself) which can be used in any buffer to "
"create a link.  The link will be stored for later insertion into an Org "
"buffer (see below)."
msgstr ""

#. type: item
#: orgguide.texi:793
#, no-wrap
msgid "C-c C-l"
msgstr ""

#. type: table
#: orgguide.texi:800
msgid ""
"Insert a link.  This prompts for a link to be inserted into the buffer.  You "
"can just type a link, or use history keys @key{up} and @key{down} to access "
"stored links.  You will be prompted for the description part of the link.  "
"When called with a @kbd{C-u} prefix argument, file name completion is used "
"to link to a file."
msgstr ""

#. type: item
#: orgguide.texi:800
#, no-wrap
msgid "C-c C-l @r{(with cursor on existing link)}"
msgstr ""

#. type: table
#: orgguide.texi:804
msgid ""
"When the cursor is on an existing link, @kbd{C-c C-l} allows you to edit the "
"link and description parts of the link."
msgstr ""

#. type: item
#: orgguide.texi:804
#, no-wrap
msgid "C-c C-o @r{or} mouse-1 @r{or} mouse-2"
msgstr ""

#. type: table
#: orgguide.texi:806
msgid "Open link at point."
msgstr ""

#. type: item
#: orgguide.texi:806
#, no-wrap
msgid "C-c &"
msgstr ""

#. type: table
#: orgguide.texi:812
msgid ""
"Jump back to a recorded position.  A position is recorded by the commands "
"following internal links, and by @kbd{C-c %}.  Using this command several "
"times in direct succession moves through a ring of previously recorded "
"positions."
msgstr ""

#. type: Plain text
#: orgguide.texi:820
msgid ""
"File links can contain additional information to make Emacs jump to a "
"particular location in the file when following a link.  This can be a line "
"number or a search option after a double colon."
msgstr ""

#. type: Plain text
#: orgguide.texi:823
msgid ""
"Here is the syntax of the different ways to attach a search to a file link, "
"together with an explanation:"
msgstr ""

#. type: smallexample
#: orgguide.texi:828
#, no-wrap
msgid ""
"[[file:~/code/main.c::255]]                 @r{Find line 255}\n"
"[[file:~/xx.org::My Target]]                @r{Find @samp{<<My Target>>}}\n"
"[[file:~/xx.org::#my-custom-id]]            @r{Find entry with custom id}\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:833
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Hyperlinks.html#Hyperlinks, "
"Chapter 4 of the manual}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:844
msgid ""
"Org mode does not maintain TODO lists as separate documents@footnote{Of "
"course, you can make a document that contains only long lists of TODO items, "
"but this is not required.}.  Instead, TODO items are an integral part of the "
"notes file, because TODO items usually come up while taking notes! With Org "
"mode, simply mark any entry in a tree as being a TODO item.  In this way, "
"information is not duplicated, and the entire context from which the TODO "
"item emerged is always present."
msgstr ""

#. type: Plain text
#: orgguide.texi:848
msgid ""
"Of course, this technique for managing TODO items scatters them throughout "
"your notes file.  Org mode compensates for this by providing methods to give "
"you an overview of all the things that you have to do."
msgstr ""

#. type: Plain text
#: orgguide.texi:863
msgid ""
"Any headline becomes a TODO item when it starts with the word @samp{TODO}, "
"for example:"
msgstr ""

#. type: smallexample
#: orgguide.texi:866
#, no-wrap
msgid "*** TODO Write letter to Sam Fortune\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:870
msgid "The most important commands to work with TODO entries are:"
msgstr ""

#. type: item
#: orgguide.texi:872
#, no-wrap
msgid "C-c C-t"
msgstr ""

#. type: table
#: orgguide.texi:874
msgid "Rotate the TODO state of the current item among"
msgstr ""

#. type: smallexample
#: orgguide.texi:878
#, no-wrap
msgid ""
",-> (unmarked) -> TODO -> DONE --.\n"
"'--------------------------------'\n"
msgstr ""

#. type: table
#: orgguide.texi:882
msgid ""
"The same rotation can also be done ``remotely'' from the timeline and agenda "
"buffers with the @kbd{t} command key (@pxref{Agenda commands})."
msgstr ""

#. type: item
#: orgguide.texi:883
#, no-wrap
msgid "S-@key{right}@r{/}@key{left}"
msgstr ""

#. type: table
#: orgguide.texi:885
msgid "Select the following/preceding TODO state, similar to cycling."
msgstr ""

#. type: item
#: orgguide.texi:885
#, no-wrap
msgid "C-c / t"
msgstr ""

#. type: table
#: orgguide.texi:889
msgid ""
"View TODO items in a @emph{sparse tree} (@pxref{Sparse trees}).  Folds the "
"buffer, but shows all TODO items and the headings hierarchy above them."
msgstr ""

#. type: item
#: orgguide.texi:889 orgguide.texi:1794
#, no-wrap
msgid "C-c a t"
msgstr ""

#. type: table
#: orgguide.texi:893
msgid ""
"Show the global TODO list.  Collects the TODO items from all agenda files "
"(@pxref{Agenda Views}) into a single buffer.  @xref{Global TODO list}, for "
"more information."
msgstr ""

#. type: item
#: orgguide.texi:893
#, no-wrap
msgid "S-M-@key{RET}"
msgstr ""

#. type: table
#: orgguide.texi:895
msgid "Insert a new TODO entry below the current one."
msgstr ""

#. type: Plain text
#: orgguide.texi:900
msgid ""
"Changing a TODO state can also trigger tag changes.  See the docstring of "
"the option @code{org-todo-state-tags-triggers} for details."
msgstr ""

#. type: Plain text
#: orgguide.texi:906
msgid ""
"You can use TODO keywords to indicate different @emph{sequential} states in "
"the process of working on an item, for example:"
msgstr ""

#. type: smalllisp
#: orgguide.texi:910
#, no-wrap
msgid ""
"(setq org-todo-keywords\n"
"  '((sequence \"TODO\" \"FEEDBACK\" \"VERIFY\" \"|\" \"DONE\" "
"\"DELEGATED\")))\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:918
msgid ""
"The vertical bar separates the TODO keywords (states that @emph{need "
"action}) from the DONE states (which need @emph{no further action}).  If you "
"don't provide the separator bar, the last state is used as the DONE state.  "
"With this setup, the command @kbd{C-c C-t} will cycle an entry from TODO to "
"FEEDBACK, then to VERIFY, and finally to DONE and DELEGATED."
msgstr ""

#. type: Plain text
#: orgguide.texi:925
msgid ""
"Sometimes you may want to use different sets of TODO keywords in parallel.  "
"For example, you may want to have the basic @code{TODO}/@code{DONE}, but "
"also a workflow for bug fixing, and a separate state indicating that an item "
"has been canceled (so it is not DONE, but also does not require action).  "
"Your setup would then look like this:"
msgstr ""

#. type: smalllisp
#: orgguide.texi:931
#, no-wrap
msgid ""
"(setq org-todo-keywords\n"
"      '((sequence \"TODO(t)\" \"|\" \"DONE(d)\")\n"
"        (sequence \"REPORT(r)\" \"BUG(b)\" \"KNOWNCAUSE(k)\" \"|\" "
"\"FIXED(f)\")\n"
"        (sequence \"|\" \"CANCELED(c)\")))\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:938
msgid ""
"The keywords should all be different, this helps Org mode to keep track of "
"which subsequence should be used for a given entry.  The example also shows "
"how to define keys for fast access of a particular state, by adding a letter "
"in parenthesis after each keyword - you will be prompted for the key after "
"@kbd{C-c C-t}."
msgstr ""

#. type: Plain text
#: orgguide.texi:941
msgid ""
"To define TODO keywords that are valid only in a single file, use the "
"following text anywhere in the file."
msgstr ""

#. type: smallexample
#: orgguide.texi:946
#, no-wrap
msgid ""
"#+TODO: TODO(t) | DONE(d)\n"
"#+TODO: REPORT(r) BUG(b) KNOWNCAUSE(k) | FIXED(f)\n"
"#+TODO: | CANCELED(c)\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:950
msgid ""
"After changing one of these lines, use @kbd{C-c C-c} with the cursor still "
"in the line to make the changes known to Org mode."
msgstr ""

#. type: Plain text
#: orgguide.texi:960
msgid ""
"Org mode can automatically record a timestamp and possibly a note when you "
"mark a TODO item as DONE, or even each time you change the state of a TODO "
"item.  This system is highly configurable, settings can be on a per-keyword "
"basis and can be localized to a file or even a subtree.  For information on "
"how to clock working time for a task, see @ref{Clocking work time}."
msgstr ""

#. type: Plain text
#: orgguide.texi:972
msgid ""
"The most basic logging is to keep track of @emph{when} a certain TODO item "
"was finished.  This is achieved with@footnote{The corresponding in-buffer "
"setting is: @code{#+STARTUP: logdone}}."
msgstr ""

#. type: smalllisp
#: orgguide.texi:975
#, no-wrap
msgid "(setq org-log-done 'time)\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:983
msgid ""
"Then each time you turn an entry from a TODO (not-done) state into any of "
"the DONE states, a line @samp{CLOSED: [timestamp]} will be inserted just "
"after the headline.  If you want to record a note along with the timestamp, "
"use@footnote{The corresponding in-buffer setting is: @code{#+STARTUP: "
"lognotedone}}"
msgstr ""

#. type: smalllisp
#: orgguide.texi:986
#, no-wrap
msgid "(setq org-log-done 'note)\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:991
msgid ""
"You will then be prompted for a note, and that note will be stored below the "
"entry with a @samp{Closing Note} heading."
msgstr ""

#. type: Plain text
#: orgguide.texi:1000
msgid ""
"You might want to keep track of TODO state changes.  You can either record "
"just a timestamp, or a time-stamped note for a change.  These records will "
"be inserted after the headline as an itemized list.  When taking a lot of "
"notes, you might want to get the notes out of the way into a drawer.  "
"Customize the variable @code{org-log-into-drawer} to get this behavior."
msgstr ""

#. type: Plain text
#: orgguide.texi:1004
msgid ""
"For state logging, Org mode expects configuration on a per-keyword basis.  "
"This is achieved by adding special markers @samp{!} (for a timestamp) and "
"@samp{@@} (for a note) in parentheses after each keyword.  For example:"
msgstr ""

#. type: smallexample
#: orgguide.texi:1006
#, no-wrap
msgid "#+TODO: TODO(t) WAIT(w@@/!) | DONE(d!) CANCELED(c@@)\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1012
msgid ""
"will define TODO keywords and fast access keys, and also request that a time "
"is recorded when the entry is set to DONE, and that a note is recorded when "
"switching to WAIT or CANCELED.  The same syntax works also when setting "
"@code{org-todo-keywords}."
msgstr ""

#. type: Plain text
#: orgguide.texi:1019
msgid ""
"If you use Org mode extensively, you may end up with enough TODO items that "
"it starts to make sense to prioritize them.  Prioritizing can be done by "
"placing a @emph{priority cookie} into the headline of a TODO item, like this"
msgstr ""

#. type: smallexample
#: orgguide.texi:1022
#, no-wrap
msgid "*** TODO [#A] Write letter to Sam Fortune\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1028
msgid ""
"Org mode supports three priorities: @samp{A}, @samp{B}, and @samp{C}.  "
"@samp{A} is the highest, @samp{B} the default if none is given.  Priorities "
"make a difference only in the agenda."
msgstr ""

#. type: kbd{#1}
#: orgguide.texi:1030
#, no-wrap
msgid "C-c ,"
msgstr ""

#. type: table
#: orgguide.texi:1034
msgid ""
"Set the priority of the current headline.  Press @samp{A}, @samp{B} or "
"@samp{C} to select a priority, or @key{SPC} to remove the cookie."
msgstr ""

#. type: item
#: orgguide.texi:1034
#, no-wrap
msgid "S-@key{up}"
msgstr ""

#. type: itemx
#: orgguide.texi:1035
#, no-wrap
msgid "S-@key{down}"
msgstr ""

#. type: table
#: orgguide.texi:1037
msgid "Increase/decrease priority of current headline"
msgstr ""

#. type: section
#: orgguide.texi:1040
#, no-wrap
msgid "Breaking tasks down into subtasks"
msgstr ""

#. type: Plain text
#: orgguide.texi:1049
msgid ""
"It is often advisable to break down large tasks into smaller, manageable "
"subtasks.  You can do this by creating an outline tree below a TODO item, "
"with detailed subtasks on the tree.  To keep the overview over the fraction "
"of subtasks that are already completed, insert either @samp{[/]} or "
"@samp{[%]} anywhere in the headline.  These cookies will be updated each "
"time the TODO status of a child changes, or when pressing @kbd{C-c C-c} on "
"the cookie.  For example:"
msgstr ""

#. type: smallexample
#: orgguide.texi:1057
#, no-wrap
msgid ""
"* Organize Party [33%]\n"
"** TODO Call people [1/2]\n"
"*** TODO Peter\n"
"*** DONE Sarah\n"
"** TODO Buy food\n"
"** DONE Talk to neighbor\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1067
msgid ""
"Every item in a plain list (@pxref{Plain lists}) can be made into a checkbox "
"by starting it with the string @samp{[ ]}.  Checkboxes are not included into "
"the global TODO list, so they are often great to split a task into a number "
"of simple steps.  Here is an example of a checkbox list."
msgstr ""

#. type: smallexample
#: orgguide.texi:1075
#, no-wrap
msgid ""
"* TODO Organize party [1/3]\n"
"  - [-] call people [1/2]\n"
"    - [ ] Peter\n"
"    - [X] Sarah\n"
"  - [X] order food\n"
"  - [ ] think about what music to play\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1081
msgid ""
"Checkboxes work hierarchically, so if a checkbox item has children that are "
"checkboxes, toggling one of the children checkboxes will make the parent "
"checkbox reflect if none, some, or all of the children are checked."
msgstr ""

#. type: table
#: orgguide.texi:1087
msgid "Toggle checkbox status or (with prefix arg) checkbox presence at point."
msgstr ""

#. type: table
#: orgguide.texi:1091
msgid ""
"Insert a new item with a checkbox.  This works only if the cursor is already "
"in a plain list item (@pxref{Plain lists})."
msgstr ""

#. type: Plain text
#: orgguide.texi:1099
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/TODO-Items.html#TODO-Items, "
"Chapter 5 of the manual}@* "
"@uref{http://orgmode.org/worg/org-tutorials/orgtutorial_dto.php, David "
"O'Toole's introductory tutorial}@* "
"@uref{http://members.optusnet.com.au/~charles57/GTD/gtd_workflow.html, "
"Charles Cave's GTD setup}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:1106
msgid ""
"An excellent way to implement labels and contexts for cross-correlating "
"information is to assign @i{tags} to headlines.  Org mode has extensive "
"support for tags."
msgstr ""

#. type: Plain text
#: orgguide.texi:1112
msgid ""
"Every headline can contain a list of tags; they occur at the end of the "
"headline.  Tags are normal words containing letters, numbers, @samp{_}, and "
"@samp{@@}.  Tags must be preceded and followed by a single colon, e.g., "
"@samp{:work:}.  Several tags can be specified, as in @samp{:work:urgent:}.  "
"Tags will by default be in bold face with the same color as the headline."
msgstr ""

#. type: Plain text
#: orgguide.texi:1125
msgid ""
"@i{Tags} make use of the hierarchical structure of outline trees.  If a "
"heading has a certain tag, all subheadings will inherit the tag as well.  "
"For example, in the list"
msgstr ""

#. type: smallexample
#: orgguide.texi:1130
#, no-wrap
msgid ""
"* Meeting with the French group      :work:\n"
"** Summary by Frank                  :boss:notes:\n"
"*** TODO Prepare slides for him      :action:\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1140
msgid ""
"the final heading will have the tags @samp{:work:}, @samp{:boss:}, "
"@samp{:notes:}, and @samp{:action:} even though the final heading is not "
"explicitly marked with those tags.  You can also set tags that all entries "
"in a file should inherit just as if these tags were defined in a "
"hypothetical level zero that surrounds the entire file.  Use a line like "
"this@footnote{As with all these in-buffer settings, pressing @kbd{C-c C-c} "
"activates any changes in the line.}:"
msgstr ""

#. type: smallexample
#: orgguide.texi:1143
#, no-wrap
msgid "#+FILETAGS: :Peter:Boss:Secret:\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1151
msgid ""
"Tags can simply be typed into the buffer at the end of a headline.  After a "
"colon, @kbd{M-@key{TAB}} offers completion on tags.  There is also a special "
"command for inserting tags:"
msgstr ""

#. type: item
#: orgguide.texi:1153
#, no-wrap
msgid "C-c C-q"
msgstr ""

#. type: table
#: orgguide.texi:1160
msgid ""
"Enter new tags for the current headline.  Org mode will either offer "
"completion or a special single-key interface for setting tags, see below.  "
"After pressing @key{RET}, the tags will be inserted and aligned to "
"@code{org-tags-column}.  When called with a @kbd{C-u} prefix, all tags in "
"the current buffer will be aligned to that column, just to make things look "
"nice."
msgstr ""

#. type: table
#: orgguide.texi:1162
msgid "When the cursor is in a headline, this does the same as @kbd{C-c C-q}."
msgstr ""

#. type: Plain text
#: orgguide.texi:1169
msgid ""
"Org will support tag insertion based on a @emph{list of tags}.  By default "
"this list is constructed dynamically, containing all tags currently used in "
"the buffer.  You may also globally specify a hard list of tags with the "
"variable @code{org-tag-alist}.  Finally you can set the default tags for a "
"given file with lines like"
msgstr ""

#. type: smallexample
#: orgguide.texi:1173
#, no-wrap
msgid ""
"#+TAGS: @@work @@home @@tennisclub\n"
"#+TAGS: laptop car pc sailboat\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1184
msgid ""
"By default Org mode uses the standard minibuffer completion facilities for "
"entering tags.  However, it also implements another, quicker, tag selection "
"method called @emph{fast tag selection}.  This allows you to select and "
"deselect tags with just a single key press.  For this to work well you "
"should assign unique letters to most of your commonly used tags.  You can do "
"this globally by configuring the variable @code{org-tag-alist} in your "
"@file{.emacs} file.  For example, you may find the need to tag many items in "
"different files with @samp{:@@home:}.  In this case you can set something "
"like:"
msgstr ""

#. type: smalllisp
#: orgguide.texi:1187
#, no-wrap
msgid ""
"(setq org-tag-alist '((\"@@work\" . ?w) (\"@@home\" . ?h) (\"laptop\" "
". ?l)))\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1191
msgid "can instead set the TAGS option line as:"
msgstr ""

#. type: smallexample
#: orgguide.texi:1194
#, no-wrap
msgid "#+TAGS: @@work(w)  @@home(h)  @@tennisclub(t)  laptop(l)  pc(p)\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1201
msgid ""
"Once a system of tags has been set up, it can be used to collect related "
"information into special lists."
msgstr ""

#. type: item
#: orgguide.texi:1203
#, no-wrap
msgid "C-c \\"
msgstr ""

#. type: itemx
#: orgguide.texi:1204
#, no-wrap
msgid "C-c / m"
msgstr ""

#. type: table
#: orgguide.texi:1207
msgid ""
"Create a sparse tree with all headlines matching a tags search.  With a "
"@kbd{C-u} prefix argument, ignore headlines that are not a TODO line."
msgstr ""

#. type: item
#: orgguide.texi:1207 orgguide.texi:1812
#, no-wrap
msgid "C-c a m"
msgstr ""

#. type: table
#: orgguide.texi:1210
msgid ""
"Create a global list of tag matches from all agenda files.  @xref{Matching "
"tags and properties}."
msgstr ""

#. type: item
#: orgguide.texi:1210 orgguide.texi:1818
#, no-wrap
msgid "C-c a M"
msgstr ""

#. type: table
#: orgguide.texi:1214
msgid ""
"Create a global list of tag matches from all agenda files, but check only "
"TODO items and force checking subitems (see variable "
"@code{org-tags-match-list-sublevels})."
msgstr ""

#. type: Plain text
#: orgguide.texi:1223
msgid ""
"These commands all prompt for a match string which allows basic Boolean "
"logic like @samp{+boss+urgent-project1}, to find entries with tags "
"@samp{boss} and @samp{urgent}, but not @samp{project1}, or "
"@samp{Kathy|Sally} to find entries which are tagged, like @samp{Kathy} or "
"@samp{Sally}.  The full syntax of the search string is rich and allows also "
"matching against TODO keywords, entry levels and properties.  For a complete "
"description with many examples, see @ref{Matching tags and properties}."
msgstr ""

#. type: Plain text
#: orgguide.texi:1228
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Tags.html#Tags, Chapter 6 of the "
"manual}@* "
"@uref{http://sachachua.com/wp/2008/01/tagging-in-org-plus-bonus-code-for-timeclocks-and-tags/, "
"Sacha Chua's article about tagging in Org-mode}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:1236
msgid ""
"Properties are key-value pairs associates with and entry.  They live in a "
"special drawer with the name @code{PROPERTIES}.  Each property is specified "
"on a single line, with the key (surrounded by colons)  first, and the value "
"after it:"
msgstr ""

#. type: smallexample
#: orgguide.texi:1247
#, no-wrap
msgid ""
"* CD collection\n"
"** Classic\n"
"*** Goldberg Variations\n"
"    :PROPERTIES:\n"
"    :Title:     Goldberg Variations\n"
"    :Composer:  J.S. Bach\n"
"    :Publisher: Deutsche Grammophon\n"
"    :NDisks:    1\n"
"    :END:\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1256
msgid ""
"You may define the allowed values for a particular property @samp{:Xyz:} by "
"setting a property @samp{:Xyz_ALL:}.  This special property is "
"@emph{inherited}, so if you set it in a level 1 entry, it will apply to the "
"entire tree.  When allowed values are defined, setting the corresponding "
"property becomes easier and is less prone to typing errors.  For the example "
"with the CD collection, we can predefine publishers and the number of disks "
"in a box like this:"
msgstr ""

#. type: smallexample
#: orgguide.texi:1263
#, no-wrap
msgid ""
"* CD collection\n"
"  :PROPERTIES:\n"
"  :NDisks_ALL:  1 2 3 4\n"
"  :Publisher_ALL: \"Deutsche Grammophon\" Philips EMI\n"
"  :END:\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1265
msgid "or globally using @code{org-global-properties}, or file-wide like this:"
msgstr ""

#. type: smallexample
#: orgguide.texi:1267
#, no-wrap
msgid "#+PROPERTY: NDisks_ALL 1 2 3 4\n"
msgstr ""

#. type: item
#: orgguide.texi:1270
#, no-wrap
msgid "C-c C-x p"
msgstr ""

#. type: table
#: orgguide.texi:1272
msgid "Set a property.  This prompts for a property name and a value."
msgstr ""

#. type: item
#: orgguide.texi:1272
#, no-wrap
msgid "C-c C-c d"
msgstr ""

#. type: table
#: orgguide.texi:1274
msgid "Remove a property from the current entry."
msgstr ""

#. type: Plain text
#: orgguide.texi:1280
msgid ""
"To create sparse trees and special lists with selection based on properties, "
"the same commands are used as for tag searches (@pxref{Tag searches}).  The "
"syntax for the search string is described in @ref{Matching tags and "
"properties}."
msgstr ""

#. type: Plain text
#: orgguide.texi:1289
msgid ""
"@seealso{ "
"@uref{http://orgmode.org/manual/Properties-and-Columns.html#Properties-and-Columns, "
"Chapter 7 of the manual}@* "
"@uref{http://orgmode.org/worg/org-tutorials/org-column-view-tutorial.php,Bastien "
"Guerry's column view tutorial}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:1296
msgid ""
"To assist project planning, TODO items can be labeled with a date and/or a "
"time.  The specially formatted string carrying the date and time information "
"is called a @emph{timestamp} in Org mode."
msgstr ""

#. type: Plain text
#: orgguide.texi:1314
msgid ""
"A timestamp is a specification of a date (possibly with a time or a range of "
"times) in a special format, either @samp{<2003-09-16 Tue>} or "
"@samp{<2003-09-16 Tue 09:39>} or @samp{<2003-09-16 Tue 12:00-12:30>}.  A "
"timestamp can appear anywhere in the headline or body of an Org tree entry.  "
"Its presence causes entries to be shown on specific dates in the agenda "
"(@pxref{Weekly/daily agenda}).  We distinguish:"
msgstr ""

#. type: Plain text
#: orgguide.texi:1318
msgid ""
"A simple timestamp just assigns a date/time to an item.  This is just like "
"writing down an appointment or event in a paper agenda."
msgstr ""

#. type: smallexample
#: orgguide.texi:1324
#, no-wrap
msgid ""
"* Meet Peter at the movies\n"
"  <2006-11-01 Wed 19:15>\n"
"* Discussion on climate change\n"
"  <2006-11-02 Thu 20:00-22:00>\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1331
msgid ""
"A timestamp may contain a @emph{repeater interval}, indicating that it "
"applies not only on the given date, but again and again after a certain "
"interval of N days (d), weeks (w), months (m), or years (y).  The following "
"will show up in the agenda every Wednesday:"
msgstr ""

#. type: smallexample
#: orgguide.texi:1334
#, no-wrap
msgid ""
"* Pick up Sam at school\n"
"  <2007-05-16 Wed 12:30 +1w>\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1340
msgid ""
"For more complex date specifications, Org mode supports using the special "
"sexp diary entries implemented in the Emacs calendar/diary package.  For "
"example"
msgstr ""

#. type: smallexample
#: orgguide.texi:1343
#, no-wrap
msgid ""
"* The nerd meeting on every 2nd Thursday of the month\n"
"  <%%(diary-float t 4 2)>\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1347
msgid "Two timestamps connected by @samp{--} denote a range."
msgstr ""

#. type: smallexample
#: orgguide.texi:1350
#, no-wrap
msgid ""
"** Meeting in Amsterdam\n"
"   <2004-08-23 Mon>--<2004-08-26 Thu>\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1356
msgid ""
"Just like a plain timestamp, but with square brackets instead of angular "
"ones.  These timestamps are inactive in the sense that they do @emph{not} "
"trigger an entry to show up in the agenda."
msgstr ""

#. type: smallexample
#: orgguide.texi:1360
#, no-wrap
msgid ""
"* Gillian comes late for the fifth time\n"
"  [2006-11-01 Wed]\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1369
msgid ""
"For Org mode to recognize timestamps, they need to be in the specific "
"format.  All commands listed below produce timestamps in the correct format."
msgstr ""

#. type: item
#: orgguide.texi:1371
#, no-wrap
msgid "C-c ."
msgstr ""

#. type: table
#: orgguide.texi:1378
msgid ""
"Prompt for a date and insert a corresponding timestamp.  When the cursor is "
"at an existing timestamp in the buffer, the command is used to modify this "
"timestamp instead of inserting a new one.  When this command is used twice "
"in succession, a time range is inserted.  With a prefix, also add the "
"current time."
msgstr ""

#. type: item
#: orgguide.texi:1378
#, no-wrap
msgid "C-c !"
msgstr ""

#. type: table
#: orgguide.texi:1382
msgid ""
"Like @kbd{C-c .}, but insert an inactive timestamp that will not cause an "
"agenda entry."
msgstr ""

#. type: item
#: orgguide.texi:1382
#, no-wrap
msgid "S-@key{left}@r{/}@key{right}"
msgstr ""

#. type: table
#: orgguide.texi:1385
msgid "Change date at cursor by one day."
msgstr ""

#. type: item
#: orgguide.texi:1385
#, no-wrap
msgid "S-@key{up}@r{/}@key{down}"
msgstr ""

#. type: table
#: orgguide.texi:1391
msgid ""
"Change the item under the cursor in a timestamp.  The cursor can be on a "
"year, month, day, hour or minute.  When the timestamp contains a time range "
"like @samp{15:30-16:30}, modifying the first time will also shift the "
"second, shifting the time block with constant length.  To change the length, "
"modify the second time."
msgstr ""

#. type: Plain text
#: orgguide.texi:1398
msgid ""
"When Org mode prompts for a date/time, it will accept any string containing "
"some date and/or time information, and intelligently interpret the string, "
"deriving defaults for unspecified information from the current date and "
"time.  You can also select a date in the pop-up calendar.  See the manual "
"for more information on how exactly the date/time prompt works."
msgstr ""

#. type: Plain text
#: orgguide.texi:1403
msgid "A timestamp may be preceded by special keywords to facilitate planning:"
msgstr ""

#. type: Plain text
#: orgguide.texi:1407
msgid ""
"Meaning: the task (most likely a TODO item, though not necessarily) is "
"supposed to be finished on that date."
msgstr ""

#. type: item
#: orgguide.texi:1408 orgguide.texi:1979
#, no-wrap
msgid "C-c C-d"
msgstr ""

#. type: table
#: orgguide.texi:1411
msgid ""
"Insert @samp{DEADLINE} keyword along with a stamp, in the line following the "
"headline."
msgstr ""

#. type: Plain text
#: orgguide.texi:1418
msgid ""
"On the deadline date, the task will be listed in the agenda.  In addition, "
"the agenda for @emph{today} will carry a warning about the approaching or "
"missed deadline, starting @code{org-deadline-warning-days} before the due "
"date, and continuing until the entry is marked DONE.  An example:"
msgstr ""

#. type: smallexample
#: orgguide.texi:1423
#, no-wrap
msgid ""
"*** TODO write article about the Earth for the Guide\n"
"    The editor in charge is [[bbdb:Ford Prefect]]\n"
"    DEADLINE: <2004-02-29 Sun>\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1431
msgid ""
"Meaning: you are @i{planning to start working} on that task on the given "
"date@footnote{This is quite different from what is normally understood by "
"@i{scheduling a meeting}, which is done in Org-mode by just inserting a time "
"stamp without keyword.}."
msgstr ""

#. type: item
#: orgguide.texi:1433 orgguide.texi:1976
#, no-wrap
msgid "C-c C-s"
msgstr ""

#. type: table
#: orgguide.texi:1436
msgid ""
"Insert @samp{SCHEDULED} keyword along with a stamp, in the line following "
"the headline."
msgstr ""

#. type: Plain text
#: orgguide.texi:1444
msgid ""
"The headline will be listed under the given date@footnote{It will still be "
"listed on that date after it has been marked DONE.  If you don't like this, "
"set the variable @code{org-agenda-skip-scheduled-if-done}.}.  In addition, a "
"reminder that the scheduled date has passed will be present in the "
"compilation for @emph{today}, until the entry is marked DONE.  I.e.@: the "
"task will automatically be forwarded until completed."
msgstr ""

#. type: smallexample
#: orgguide.texi:1448
#, no-wrap
msgid ""
"*** TODO Call Trillian for a date on New Years Eve.\n"
"    SCHEDULED: <2004-12-25 Sat>\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1453
msgid ""
"Some tasks need to be repeated again and again.  Org mode helps to organize "
"such tasks using a so-called repeater in a DEADLINE, SCHEDULED, or plain "
"timestamp.  In the following example"
msgstr ""

#. type: smallexample
#: orgguide.texi:1456
#, no-wrap
msgid ""
"** TODO Pay the rent\n"
"   DEADLINE: <2005-10-01 Sat +1m>\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1461
msgid ""
"the @code{+1m} is a repeater; the intended interpretation is that the task "
"has a deadline on <2005-10-01> and repeats itself every (one) month starting "
"from that time."
msgstr ""

#. type: Plain text
#: orgguide.texi:1467
msgid ""
"Org mode allows you to clock the time you spend on specific tasks in a "
"project."
msgstr ""

#. type: item
#: orgguide.texi:1469
#, no-wrap
msgid "C-c C-x C-i"
msgstr ""

#. type: table
#: orgguide.texi:1474
msgid ""
"Start the clock on the current item (clock-in).  This inserts the CLOCK "
"keyword together with a timestamp.  When called with a @kbd{C-u} prefix "
"argument, select the task from a list of recently clocked tasks."
msgstr ""

#. type: item
#: orgguide.texi:1474
#, no-wrap
msgid "C-c C-x C-o"
msgstr ""

#. type: table
#: orgguide.texi:1479
msgid ""
"Stop the clock (clock-out).  This inserts another timestamp at the same "
"location where the clock was last started.  It also directly computes the "
"resulting time in inserts it after the time range as @samp{=> HH:MM}."
msgstr ""

#. type: item
#: orgguide.texi:1479
#, no-wrap
msgid "C-c C-x C-e"
msgstr ""

#. type: table
#: orgguide.texi:1481
msgid "Update the effort estimate for the current clock task."
msgstr ""

#. type: item
#: orgguide.texi:1481
#, no-wrap
msgid "C-c C-x C-x"
msgstr ""

#. type: table
#: orgguide.texi:1484
msgid ""
"Cancel the current clock.  This is useful if a clock was started by mistake, "
"or if you ended up working on something else."
msgstr ""

#. type: item
#: orgguide.texi:1484
#, no-wrap
msgid "C-c C-x C-j"
msgstr ""

#. type: table
#: orgguide.texi:1488
msgid ""
"Jump to the entry that contains the currently running clock.  With a "
"@kbd{C-u} prefix arg, select the target task from a list of recently clocked "
"tasks."
msgstr ""

#. type: item
#: orgguide.texi:1488
#, no-wrap
msgid "C-c C-x C-r"
msgstr ""

#. type: table
#: orgguide.texi:1492
msgid ""
"Insert a dynamic block containing a clock report as an Org-mode table into "
"the current file.  When the cursor is at an existing clock table, just "
"update it."
msgstr ""

#. type: smallexample
#: orgguide.texi:1495
#, no-wrap
msgid ""
"#+BEGIN: clocktable :maxlevel 2 :emphasize nil :scope file\n"
"#+END: clocktable\n"
msgstr ""

#. type: table
#: orgguide.texi:1498
msgid ""
"For details about how to customize this view, see "
"@uref{http://orgmode.org/manual/Clocking-work-time.html#Clocking-work-time,the "
"manual}."
msgstr ""

#. type: table
#: orgguide.texi:1501
msgid ""
"Update dynamic block at point.  The cursor needs to be in the @code{#+BEGIN} "
"line of the dynamic block."
msgstr ""

#. type: Plain text
#: orgguide.texi:1506
msgid ""
"The @kbd{l} key may be used in the timeline (@pxref{Timeline}) and in the "
"agenda (@pxref{Weekly/daily agenda}) to show which tasks have been worked on "
"or closed during a day."
msgstr ""

#. type: Plain text
#: orgguide.texi:1513
msgid ""
"@seealso{ "
"@uref{http://orgmode.org/manual/Dates-and-Times.html#Dates-and-Times, "
"Chapter 8 of the manual}@* "
"@uref{http://members.optusnet.com.au/~charles57/GTD/org_dates/, Charles "
"Cave's Date and Time tutorial}@* "
"@uref{http://doc.norang.ca/org-mode.html#Clocking, Bernt Hansen's clocking "
"workflow}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:1523
msgid ""
"An important part of any organization system is the ability to quickly "
"capture new ideas and tasks, and to associate reference material with them.  "
"Org defines a capture process to create tasks.  It stores files related to a "
"task (@i{attachments}) in a special directory.  Once in the system, tasks "
"and projects need to be moved around.  Moving completed project trees to an "
"archive file keeps the system compact and fast."
msgstr ""

#. type: Plain text
#: orgguide.texi:1537
msgid ""
"Org's method for capturing new items is heavily inspired by John Wiegley "
"excellent remember package.  It lets you store quick notes with little "
"interruption of your work flow.  Org lets you define templates for new "
"entries and associate them with different targets for storing notes."
msgstr ""

#. type: Plain text
#: orgguide.texi:1552
msgid ""
"The following customization sets a default target@footnote{Using capture "
"templates, you can define more fine-grained capture locations, see "
"@ref{Capture templates}.} file for notes, and defines a global "
"key@footnote{Please select your own key, @kbd{C-c c} is only a suggestion.} "
"for capturing new stuff."
msgstr ""

#. type: example
#: orgguide.texi:1556
#, no-wrap
msgid ""
"(setq org-default-notes-file (concat org-directory \"/notes.org\"))\n"
"(define-key global-map \"\\C-cc\" 'org-capture)\n"
msgstr ""

#. type: item
#: orgguide.texi:1562
#, no-wrap
msgid "C-c c"
msgstr ""

#. type: table
#: orgguide.texi:1565
msgid ""
"Start a capture process.  You will be placed into a narrowed indirect buffer "
"to edit the item."
msgstr ""

#. type: table
#: orgguide.texi:1569
msgid ""
"Once you are done entering information into the capture buffer, @kbd{C-c "
"C-c} will return you to the window configuration before the capture process, "
"so that you can resume your work without further distraction."
msgstr ""

#. type: table
#: orgguide.texi:1571
msgid "Finalize by moving the entry to a refile location (@pxref{Refile and copy})."
msgstr ""

#. type: item
#: orgguide.texi:1571
#, no-wrap
msgid "C-c C-k"
msgstr ""

#. type: table
#: orgguide.texi:1573
msgid "Abort the capture process and return to the previous state."
msgstr ""

#. type: Plain text
#: orgguide.texi:1583
msgid ""
"You can use templates to generate different types of capture notes, and to "
"store them in different places.  For example, if you would like to store new "
"tasks under a heading @samp{Tasks} in file @file{TODO.org}, and journal "
"entries in a date tree in @file{journal.org} you could use:"
msgstr ""

#. type: smallexample
#: orgguide.texi:1590
#, no-wrap
msgid ""
"(setq org-capture-templates\n"
" '((\"t\" \"Todo\" entry (file+headline \"~/org/gtd.org\" \"Tasks\")\n"
"        \"* TODO %?\\n  %i\\n  %a\")\n"
"   (\"j\" \"Journal\" entry (file+datetree \"~/org/journal.org\")\n"
"        \"* %?\\nEntered on %U\\n  %i\\n  %a\")))\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1597
msgid ""
"template, the second is a short description.  Then follows the type of the "
"entry and a definition of the target location for storing the note.  "
"Finally, the template itself, a string with %-escapes to fill in information "
"based on time and context."
msgstr ""

#. type: Plain text
#: orgguide.texi:1600
msgid ""
"When you call @kbd{M-x org-capture}, Org will prompt for a key to select the "
"template (if you have more than one template) and then prepare the buffer "
"like"
msgstr ""

#. type: smallexample
#: orgguide.texi:1603
#, no-wrap
msgid ""
"* TODO\n"
"  [[file:@var{link to where you were when initiating capture}]]\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1610
msgid ""
"During expansion of the template, special @kbd{%}-escapes@footnote{If you "
"need one of these sequences literally, escape the @kbd{%} with a backslash.} "
"allow dynamic insertion of content.  Here is a small selection of the "
"possibilities, consult the manual for more."
msgstr ""

#. type: smallexample
#: orgguide.texi:1616
#, no-wrap
msgid ""
"%a          @r{annotation, normally the link created with "
"@code{org-store-link}}\n"
"%i          @r{initial content, the region when remember is called with "
"C-u.}\n"
"%t          @r{timestamp, date only}\n"
"%T          @r{timestamp with date and time}\n"
"%u, %U      @r{like the above, but inactive timestamps}\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1625
msgid ""
"When reviewing the captured data, you may want to refile or copy some of the "
"entries into a different list, for example into a project.  Cutting, finding "
"the right location, and then pasting the note is cumbersome.  To simplify "
"this process, you can use the following special command:"
msgstr ""

#. type: item
#: orgguide.texi:1627
#, no-wrap
msgid "C-c M-x"
msgstr ""

#. type: table
#: orgguide.texi:1630
msgid ""
"Copy the entry or region at point.  This command behaves like "
"@code{org-refile}, except that the original note will not be deleted."
msgstr ""

#. type: table
#: orgguide.texi:1637
msgid ""
"Refile the entry or region at point.  This command offers possible locations "
"for refiling the entry and lets you select one with completion.  The item "
"(or all items in the region) is filed below the target heading as a "
"subitem.@* By default, all level 1 headlines in the current buffer are "
"considered to be targets, but you can have more complex definitions across a "
"number of files.  See the variable @code{org-refile-targets} for details."
msgstr ""

#. type: item
#: orgguide.texi:1637
#, no-wrap
msgid "C-u C-c C-w"
msgstr ""

#. type: table
#: orgguide.texi:1639
msgid "Use the refile interface to jump to a heading."
msgstr ""

#. type: item
#: orgguide.texi:1639
#, no-wrap
msgid "C-u C-u C-c C-w"
msgstr ""

#. type: table
#: orgguide.texi:1641
msgid "Jump to the location where @code{org-refile} last moved a tree to."
msgstr ""

#. type: Plain text
#: orgguide.texi:1652
msgid ""
"When a project represented by a (sub)tree is finished, you may want to move "
"the tree out of the way and to stop it from contributing to the agenda.  "
"Archiving is important to keep your working files compact and global "
"searches like the construction of agenda views fast.  The most common "
"archiving action is to move a project tree to another file, the archive "
"file."
msgstr ""

#. type: item
#: orgguide.texi:1654
#, no-wrap
msgid "C-c C-x C-a"
msgstr ""

#. type: table
#: orgguide.texi:1657
msgid ""
"Archive the current entry using the command specified in the variable "
"@code{org-archive-default-command}."
msgstr ""

#. type: item
#: orgguide.texi:1657
#, no-wrap
msgid "C-c C-x C-s@ @r{or short} @ C-c $"
msgstr ""

#. type: table
#: orgguide.texi:1660
msgid ""
"Archive the subtree starting at the cursor position to the location given by "
"@code{org-archive-location}."
msgstr ""

#. type: Plain text
#: orgguide.texi:1668
msgid ""
"The default archive location is a file in the same directory as the current "
"file, with the name derived by appending @file{_archive} to the current file "
"name.  For information and examples on how to change this, see the "
"documentation string of the variable @code{org-archive-location}.  There is "
"also an in-buffer option for setting this variable, for example"
msgstr ""

#. type: smallexample
#: orgguide.texi:1671
#, no-wrap
msgid "#+ARCHIVE: %s_done::\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1680
msgid ""
"@seealso{ "
"@uref{http://orgmode.org/manual/Capture-_002d-Refile-_002d-Archive.html#Capture-_002d-Refile-_002d-Archive, "
"Chapter 9 of the manual}@* "
"@uref{http://members.optusnet.com.au/~charles57/GTD/remember.html, Charles "
"Cave's remember tutorial}@* "
"@uref{http://orgmode.org/worg/org-tutorials/org-protocol-custom-handler.php, "
"Sebastian Rose's tutorial for capturing from a web browser}}@uref{}@*"
msgstr ""

#. type: Plain text
#: orgguide.texi:1689
msgid ""
"Due to the way Org works, TODO items, time-stamped items, and tagged "
"headlines can be scattered throughout a file or even a number of files.  To "
"get an overview of open action items, or of events that are important for a "
"particular date, this information must be collected, sorted and displayed in "
"an organized way.  There are several different views, see below."
msgstr ""

#. type: Plain text
#: orgguide.texi:1697
msgid ""
"The extracted information is displayed in a special @emph{agenda buffer}.  "
"This buffer is read-only, but provides commands to visit the corresponding "
"locations in the original Org files, and even to edit these files remotely.  "
"Remote editing from the agenda buffer means, for example, that you can "
"change the dates of deadlines and appointments from the agenda buffer.  The "
"commands available in the Agenda buffer are listed in @ref{Agenda commands}."
msgstr ""

#. type: Plain text
#: orgguide.texi:1712
msgid ""
"The information to be shown is normally collected from all @emph{agenda "
"files}, the files listed in the variable @code{org-agenda-files}."
msgstr ""

#. type: item
#: orgguide.texi:1714
#, no-wrap
msgid "C-c ["
msgstr ""

#. type: table
#: orgguide.texi:1718
msgid ""
"Add current file to the list of agenda files.  The file is added to the "
"front of the list.  If it was already in the list, it is moved to the "
"front.  With a prefix argument, file is added/moved to the end."
msgstr ""

#. type: item
#: orgguide.texi:1718
#, no-wrap
msgid "C-c ]"
msgstr ""

#. type: table
#: orgguide.texi:1720
msgid "Remove current file from the list of agenda files."
msgstr ""

#. type: item
#: orgguide.texi:1720
#, no-wrap
msgid "C-,"
msgstr ""

#. type: table
#: orgguide.texi:1722
msgid "Cycle through agenda file list, visiting one file after the other."
msgstr ""

#. type: section
#: orgguide.texi:1725
#, no-wrap
msgid "The agenda dispatcher"
msgstr ""

#. type: Plain text
#: orgguide.texi:1730
msgid ""
"The views are created through a dispatcher, which should be bound to a "
"global key---for example @kbd{C-c a} (@pxref{Installation}).  After pressing "
"@kbd{C-c a}, an additional letter is required to execute a command:"
msgstr ""

#. type: item
#: orgguide.texi:1731
#, no-wrap
msgid "a"
msgstr ""

#. type: table
#: orgguide.texi:1733
msgid "The calendar-like agenda (@pxref{Weekly/daily agenda})."
msgstr ""

#. type: item
#: orgguide.texi:1733
#, no-wrap
msgid "t @r{/} T"
msgstr ""

#. type: table
#: orgguide.texi:1735
msgid "A list of all TODO items (@pxref{Global TODO list})."
msgstr ""

#. type: item
#: orgguide.texi:1735
#, no-wrap
msgid "m @r{/} M"
msgstr ""

#. type: table
#: orgguide.texi:1738
msgid ""
"A list of headlines matching a TAGS expression (@pxref{Matching tags and "
"properties})."
msgstr ""

#. type: item
#: orgguide.texi:1738
#, no-wrap
msgid "L"
msgstr ""

#. type: table
#: orgguide.texi:1740
msgid "The timeline view for the current buffer (@pxref{Timeline})."
msgstr ""

#. type: item
#: orgguide.texi:1740 orgguide.texi:1940
#, no-wrap
msgid "s"
msgstr ""

#. type: table
#: orgguide.texi:1743
msgid ""
"A list of entries selected by a boolean expression of keywords and/or "
"regular expressions that must or must not occur in the entry."
msgstr ""

#. type: subsection
#: orgguide.texi:1757
#, no-wrap
msgid "The weekly/daily agenda"
msgstr ""

#. type: Plain text
#: orgguide.texi:1761
msgid ""
"The purpose of the weekly/daily @emph{agenda} is to act like a page of a "
"paper agenda, showing all the tasks for the current week or day."
msgstr ""

#. type: item
#: orgguide.texi:1763
#, no-wrap
msgid "C-c a a"
msgstr ""

#. type: table
#: orgguide.texi:1766
msgid ""
"Compile an agenda for the current week from a list of Org files.  The agenda "
"shows the entries for each day."
msgstr ""

#. type: Plain text
#: orgguide.texi:1771
msgid ""
"Emacs contains the calendar and diary by Edward M. Reingold.  Org-mode "
"understands the syntax of the diary and allows you to use diary sexp entries "
"directly in Org files:"
msgstr ""

#. type: smallexample
#: orgguide.texi:1779
#, no-wrap
msgid ""
"* Birthdays and similar stuff\n"
"#+CATEGORY: Holiday\n"
"%%(org-calendar-holiday)   ; special function for holiday names\n"
"#+CATEGORY: Ann\n"
"%%(diary-anniversary  5 14 1956)@footnote{Note that the order of the "
"arguments (month, day, year) depends on the setting of "
"@code{calendar-date-style}.} Arthur Dent is %d years old\n"
"%%(diary-anniversary 10  2 1869) Mahatma Gandhi would be %d years old\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1784
msgid ""
"Org can interact with Emacs appointments notification facility.  To add all "
"the appointments of your agenda files, use the command "
"@code{org-agenda-to-appt}.  See the docstring for details."
msgstr ""

#. type: subsection
#: orgguide.texi:1786
#, no-wrap
msgid "The global TODO list"
msgstr ""

#. type: Plain text
#: orgguide.texi:1792
msgid ""
"The global TODO list contains all unfinished TODO items formatted and "
"collected into a single place.  Remote editing of TODO items lets you can "
"change the state of a TODO entry with a single key press.  The commands "
"available in the TODO list are described in @ref{Agenda commands}."
msgstr ""

#. type: table
#: orgguide.texi:1797
msgid ""
"Show the global TODO list.  This collects the TODO items from all agenda "
"files (@pxref{Agenda Views}) into a single buffer."
msgstr ""

#. type: item
#: orgguide.texi:1797
#, no-wrap
msgid "C-c a T"
msgstr ""

#. type: table
#: orgguide.texi:1799
msgid "Like the above, but allows selection of a specific TODO keyword."
msgstr ""

#. type: Plain text
#: orgguide.texi:1810
msgid ""
"If headlines in the agenda files are marked with @emph{tags} (@pxref{Tags}), "
"or have properties (@pxref{Properties}), you can select headlines based on "
"this metadata and collect them into an agenda buffer.  The match syntax "
"described here also applies when creating sparse trees with @kbd{C-c / m}.  "
"The commands available in the tags list are described in @ref{Agenda "
"commands}."
msgstr ""

#. type: table
#: orgguide.texi:1818
msgid ""
"Produce a list of all headlines that match a given set of tags.  The command "
"prompts for a selection criterion, which is a boolean logic expression with "
"tags, like @samp{+work+urgent-withboss} or @samp{work|home} (@pxref{Tags}).  "
"If you often need a specific search, define a custom command for it "
"(@pxref{Agenda dispatcher})."
msgstr ""

#. type: table
#: orgguide.texi:1820
msgid "Like @kbd{C-c a m}, but only select headlines that are also TODO items."
msgstr ""

#. type: subsubheading
#: orgguide.texi:1822
#, no-wrap
msgid "Match syntax"
msgstr ""

#. type: Plain text
#: orgguide.texi:1832
msgid ""
"A search string can use Boolean operators @samp{&} for AND and @samp{|} for "
"OR.  @samp{&} binds more strongly than @samp{|}.  Parentheses are currently "
"not implemented.  Each element in the search is either a tag, a regular "
"expression matching tags, or an expression like @code{PROPERTY OPERATOR "
"VALUE} with a comparison operator, accessing a property value.  Each element "
"may be preceded by @samp{-}, to select against it, and @samp{+} is syntactic "
"sugar for positive selection.  The AND operator @samp{&} is optional when "
"@samp{+} or @samp{-} is present.  Here are some examples, using only tags."
msgstr ""

#. type: item
#: orgguide.texi:1834
#, no-wrap
msgid "+work-boss"
msgstr ""

#. type: table
#: orgguide.texi:1837
msgid ""
"Select headlines tagged @samp{:work:}, but discard those also tagged "
"@samp{:boss:}."
msgstr ""

#. type: item
#: orgguide.texi:1837
#, no-wrap
msgid "work|laptop"
msgstr ""

#. type: table
#: orgguide.texi:1839
msgid "Selects lines tagged @samp{:work:} or @samp{:laptop:}."
msgstr ""

#. type: item
#: orgguide.texi:1839
#, no-wrap
msgid "work|laptop+night"
msgstr ""

#. type: table
#: orgguide.texi:1842
msgid ""
"Like before, but require the @samp{:laptop:} lines to be tagged also "
"@samp{:night:}."
msgstr ""

#. type: Plain text
#: orgguide.texi:1846
msgid ""
"You may also test for properties at the same time as matching tags, see the "
"manual for more information."
msgstr ""

#. type: subsection
#: orgguide.texi:1848
#, no-wrap
msgid "Timeline for a single file"
msgstr ""

#. type: Plain text
#: orgguide.texi:1853
msgid ""
"The timeline summarizes all time-stamped items from a single Org mode file "
"in a @emph{time-sorted view}.  The main purpose of this command is to give "
"an overview over events in a project."
msgstr ""

#. type: item
#: orgguide.texi:1855
#, no-wrap
msgid "C-c a L"
msgstr ""

#. type: table
#: orgguide.texi:1859
msgid ""
"Show a time-sorted view of the Org file, with all time-stamped items.  When "
"called with a @kbd{C-u} prefix, all unfinished TODO entries (scheduled or "
"not) are also listed under the current date."
msgstr ""

#. type: Plain text
#: orgguide.texi:1866
msgid ""
"This agenda view is a general text search facility for Org mode entries.  It "
"is particularly useful to find notes."
msgstr ""

#. type: item
#: orgguide.texi:1868
#, no-wrap
msgid "C-c a s"
msgstr ""

#. type: table
#: orgguide.texi:1871
msgid ""
"This is a special search that lets you select entries by matching a "
"substring or specific words using a boolean logic."
msgstr ""

#. type: Plain text
#: orgguide.texi:1880
msgid ""
"For example, the search string @samp{computer equipment} will find entries "
"that contain @samp{computer equipment} as a substring.  Search view can also "
"search for specific keywords in the entry, using Boolean logic.  The search "
"string @samp{+computer +wifi -ethernet -@{8\\.11[bg]@}} will search for note "
"entries that contain the keywords @code{computer} and @code{wifi}, but not "
"the keyword @code{ethernet}, and which are also not matched by the regular "
"expression @code{8\\.11[bg]}, meaning to exclude both 8.11b and 8.11g."
msgstr ""

#. type: Plain text
#: orgguide.texi:1883
msgid ""
"Note that in addition to the agenda files, this command will also search the "
"files listed in @code{org-agenda-text-search-extra-files}."
msgstr ""

#. type: section
#: orgguide.texi:1885
#, no-wrap
msgid "Commands in the agenda buffer"
msgstr ""

#. type: Plain text
#: orgguide.texi:1892
msgid ""
"Entries in the agenda buffer are linked back to the Org file or diary file "
"where they originate.  Commands are provided to show and jump to the "
"original entry location, and to edit the Org files ``remotely'' from the "
"agenda buffer.  This is just a selection of the many commands, explore the "
"@code{Agenda} menu and the manual for a complete list."
msgstr ""

#. type: table
#: orgguide.texi:1895
msgid "@tsubheading{Motion}"
msgstr ""

#. type: item
#: orgguide.texi:1895
#, no-wrap
msgid "n"
msgstr ""

#. type: table
#: orgguide.texi:1897
msgid "Next line (same as @key{up} and @kbd{C-p})."
msgstr ""

#. type: item
#: orgguide.texi:1897
#, no-wrap
msgid "p"
msgstr ""

#. type: table
#: orgguide.texi:1900
msgid ""
"Previous line (same as @key{down} and @kbd{C-n}).  @tsubheading{View/Go to "
"Org file}"
msgstr ""

#. type: item
#: orgguide.texi:1900
#, no-wrap
msgid "mouse-3"
msgstr ""

#. type: key{#1}
#: orgguide.texi:1901
#, no-wrap
msgid "SPC"
msgstr ""

#. type: table
#: orgguide.texi:1906
msgid ""
"Display the original location of the item in another window.  With prefix "
"arg, make sure that the entire entry is made visible in the outline, not "
"only the heading."
msgstr ""

#. type: table
#: orgguide.texi:1910
msgid ""
"Go to the original location of the item in another window.  Under Emacs 22, "
"@kbd{mouse-1} will also work for this."
msgstr ""

#. type: table
#: orgguide.texi:1913
msgid "Go to the original location of the item and delete other windows."
msgstr ""

#. type: table
#: orgguide.texi:1915
msgid "@tsubheading{Change display}"
msgstr ""

#. type: item
#: orgguide.texi:1915
#, no-wrap
msgid "o"
msgstr ""

#. type: table
#: orgguide.texi:1918
msgid "Delete other windows."
msgstr ""

#. type: item
#: orgguide.texi:1918
#, no-wrap
msgid "d @r{/} w"
msgstr ""

#. type: table
#: orgguide.texi:1921
msgid "Switch to day/week view."
msgstr ""

#. type: item
#: orgguide.texi:1921
#, no-wrap
msgid "f @r{and} b"
msgstr ""

#. type: table
#: orgguide.texi:1926
msgid ""
"Go forward/backward in time to display the following "
"@code{org-agenda-current-span} days.  For example, if the display covers a "
"week, switch to the following/previous week."
msgstr ""

#. type: item
#: orgguide.texi:1926
#, no-wrap
msgid "."
msgstr ""

#. type: table
#: orgguide.texi:1929
msgid "Go to today."
msgstr ""

#. type: item
#: orgguide.texi:1929
#, no-wrap
msgid "j"
msgstr ""

#. type: table
#: orgguide.texi:1932
msgid "Prompt for a date and go there."
msgstr ""

#. type: item
#: orgguide.texi:1932
#, no-wrap
msgid "v l @ @r{or short} @ l"
msgstr ""

#. type: table
#: orgguide.texi:1938
msgid ""
"Toggle Logbook mode.  In Logbook mode, entries that were marked DONE while "
"logging was on (variable @code{org-log-done}) are shown in the agenda, as "
"are entries that have been clocked on that day.  When called with a "
"@kbd{C-u} prefix, show all possible logbook entries, including state "
"changes."
msgstr ""

#. type: item
#: orgguide.texi:1938
#, no-wrap
msgid "r @r{or} g"
msgstr ""

#. type: table
#: orgguide.texi:1940
msgid "Recreate the agenda buffer, to reflect the changes."
msgstr ""

#. type: table
#: orgguide.texi:1943
msgid ""
"Save all Org buffers in the current Emacs session, and also the locations of "
"IDs."
msgstr ""

#. type: table
#: orgguide.texi:1945
msgid "@tsubheading{Secondary filtering and query editing}"
msgstr ""

#. type: item
#: orgguide.texi:1946
#, no-wrap
msgid "/"
msgstr ""

#. type: table
#: orgguide.texi:1949
msgid ""
"Filter the current agenda view with respect to a tag.  You are prompted for "
"a letter to select a tag.  Press @samp{-} first to select against the tag."
msgstr ""

#. type: item
#: orgguide.texi:1950
#, no-wrap
msgid "\\"
msgstr ""

#. type: table
#: orgguide.texi:1952
msgid "Narrow the current agenda filter by an additional condition."
msgstr ""

#. type: table
#: orgguide.texi:1954
msgid "@tsubheading{Remote editing (see the manual for many more commands)}"
msgstr ""

#. type: item
#: orgguide.texi:1955
#, no-wrap
msgid "0-9"
msgstr ""

#. type: table
#: orgguide.texi:1958
msgid "Digit argument."
msgstr ""

#. type: item
#: orgguide.texi:1958
#, no-wrap
msgid "t"
msgstr ""

#. type: table
#: orgguide.texi:1962
msgid "Change the TODO state of the item, in the agenda and in the org file."
msgstr ""

#. type: item
#: orgguide.texi:1962
#, no-wrap
msgid "C-k"
msgstr ""

#. type: table
#: orgguide.texi:1966
msgid ""
"Delete the current agenda item along with the entire subtree belonging to it "
"in the original Org file."
msgstr ""

#. type: table
#: orgguide.texi:1969
msgid "Refile the entry at point."
msgstr ""

#. type: item
#: orgguide.texi:1969
#, no-wrap
msgid "C-c C-x C-a @ @r{or short} @ a"
msgstr ""

#. type: table
#: orgguide.texi:1973
msgid ""
"Archive the subtree corresponding to the entry at point using the default "
"archiving command set in @code{org-archive-default-command}."
msgstr ""

#. type: item
#: orgguide.texi:1973
#, no-wrap
msgid "C-c C-x C-s @ @r{or short} @ $"
msgstr ""

#. type: table
#: orgguide.texi:1976
msgid "Archive the subtree corresponding to the current headline."
msgstr ""

#. type: table
#: orgguide.texi:1979
msgid "Schedule this item, with prefix arg remove the scheduling timestamp"
msgstr ""

#. type: table
#: orgguide.texi:1982
msgid "Set a deadline for this item, with prefix arg remove the deadline."
msgstr ""

#. type: item
#: orgguide.texi:1982
#, no-wrap
msgid "S-@key{right} @r{and} S-@key{left}"
msgstr ""

#. type: table
#: orgguide.texi:1985
msgid "Change the timestamp associated with the current line by one day."
msgstr ""

#. type: item
#: orgguide.texi:1985
#, no-wrap
msgid "I"
msgstr ""

#. type: table
#: orgguide.texi:1988
msgid "Start the clock on the current item."
msgstr ""

#. type: item
#: orgguide.texi:1988
#, no-wrap
msgid "O / X"
msgstr ""

#. type: table
#: orgguide.texi:1990
msgid "Stop/cancel the previously started clock."
msgstr ""

#. type: item
#: orgguide.texi:1991
#, no-wrap
msgid "J"
msgstr ""

#. type: table
#: orgguide.texi:1993
msgid "Jump to the running clock in another window."
msgstr ""

#. type: Plain text
#: orgguide.texi:2007
msgid ""
"The main application of custom searches is the definition of keyboard "
"shortcuts for frequently used searches, either creating an agenda buffer, or "
"a sparse tree (the latter covering of course only the current buffer).  "
"Custom commands are configured in the variable "
"@code{org-agenda-custom-commands}.  You can customize this variable, for "
"example by pressing @kbd{C-c a C}.  You can also directly set it with Emacs "
"Lisp in @file{.emacs}.  The following example contains all valid search "
"types:"
msgstr ""

#. type: group
#: orgguide.texi:2014
#, no-wrap
msgid ""
"(setq org-agenda-custom-commands\n"
"      '((\"w\" todo \"WAITING\")\n"
"        (\"u\" tags \"+boss-urgent\")\n"
"        (\"v\" tags-todo \"+boss-urgent\")))\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2023
msgid ""
"The initial string in each entry defines the keys you have to press after "
"the dispatcher command @kbd{C-c a} in order to access the command.  Usually "
"this will be just a single character.  The second parameter is the search "
"type, followed by the string or regular expression to be used for the "
"matching.  The example above will therefore define:"
msgstr ""

#. type: item
#: orgguide.texi:2025
#, no-wrap
msgid "C-c a w"
msgstr ""

#. type: table
#: orgguide.texi:2028
msgid "as a global search for TODO entries with @samp{WAITING} as the TODO keyword"
msgstr ""

#. type: item
#: orgguide.texi:2028
#, no-wrap
msgid "C-c a u"
msgstr ""

#. type: table
#: orgguide.texi:2031
msgid ""
"as a global tags search for headlines marked @samp{:boss:} but not "
"@samp{:urgent:}"
msgstr ""

#. type: item
#: orgguide.texi:2031
#, no-wrap
msgid "C-c a v"
msgstr ""

#. type: table
#: orgguide.texi:2034
msgid ""
"as the same search as @kbd{C-c a u}, but limiting the search to headlines "
"that are also TODO items"
msgstr ""

#. type: Plain text
#: orgguide.texi:2043
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Agenda-Views.html#Agenda-Views, "
"Chapter 10 of the manual}@* "
"@uref{http://orgmode.org/worg/org-tutorials/org-custom-agenda-commands.php, "
"Mat Lundin's tutorial about custom agenda commands}@* "
"@uref{http://www.newartisans.com/2007/08/using-org-mode-as-a-day-planner.html, "
"John Wiegley's setup}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:2052
msgid ""
"When exporting Org-mode documents, the exporter tries to reflect the "
"structure of the document as accurately as possible in the backend.  Since "
"export targets like HTML, @LaTeX{}, or DocBook allow much richer formatting, "
"Org mode has rules on how to prepare text for rich export.  This section "
"summarizes the markup rules used in an Org-mode buffer."
msgstr ""

#. type: Plain text
#: orgguide.texi:2078
msgid "The title of the exported document is taken from the special line"
msgstr ""

#. type: smallexample
#: orgguide.texi:2081
#, no-wrap
msgid "#+TITLE: This is the title of the document\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2093
msgid ""
"The outline structure of the document as described in @ref{Document "
"Structure}, forms the basis for defining sections of the exported document.  "
"However, since the outline structure is also used for (for example) lists of "
"tasks, only the first three outline levels will be used as headings.  Deeper "
"levels will become itemized lists.  You can change the location of this "
"switch globally by setting the variable @code{org-export-headline-levels}, "
"or on a per-file basis with a line"
msgstr ""

#. type: smallexample
#: orgguide.texi:2096
#, no-wrap
msgid "#+OPTIONS: H:4\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2103
msgid ""
"The table of contents is normally inserted directly before the first "
"headline of the file."
msgstr ""

#. type: smallexample
#: orgguide.texi:2107
#, no-wrap
msgid ""
"#+OPTIONS: toc:2          (only to two levels in TOC)\n"
"#+OPTIONS: toc:nil        (no TOC at all)\n"
msgstr ""

#. type: subheading
#: orgguide.texi:2110
#, no-wrap
msgid "Paragraphs, line breaks, and quoting"
msgstr ""

#. type: Plain text
#: orgguide.texi:2114
msgid ""
"Paragraphs are separated by at least one empty line.  If you need to enforce "
"a line break within a paragraph, use @samp{\\\\} at the end of a line."
msgstr ""

#. type: Plain text
#: orgguide.texi:2117
msgid ""
"To keep the line breaks in a region, but otherwise use normal formatting, "
"you can use this construct, which can also be used to format poetry."
msgstr ""

#. type: smallexample
#: orgguide.texi:2123
#, no-wrap
msgid ""
"#+BEGIN_VERSE\n"
" Great clouds overhead\n"
" Tiny black birds rise and fall\n"
" Snow covers Emacs\n"
"\n"
msgstr ""

#. type: smallexample
#: orgguide.texi:2126
#, no-wrap
msgid ""
"     -- AlexSchroeder\n"
"#+END_VERSE\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2131
msgid ""
"When quoting a passage from another document, it is customary to format this "
"as a paragraph that is indented on both the left and the right margin.  You "
"can include quotations in Org-mode documents like this:"
msgstr ""

#. type: smallexample
#: orgguide.texi:2137
#, no-wrap
msgid ""
"#+BEGIN_QUOTE\n"
"Everything should be made as simple as possible,\n"
"but not any simpler -- Albert Einstein\n"
"#+END_QUOTE\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2140
msgid "If you would like to center some text, do it like this:"
msgstr ""

#. type: smallexample
#: orgguide.texi:2145
#, no-wrap
msgid ""
"#+BEGIN_CENTER\n"
"Everything should be made as simple as possible, \\\\\n"
"but not any simpler\n"
"#+END_CENTER\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2155
msgid ""
"You can make words @b{*bold*}, @i{/italic/}, _underlined_, @code{=code=} and "
"@code{~verbatim~}, and, if you must, @samp{+strike-through+}.  Text in the "
"code and verbatim string is not processed for Org-mode specific syntax, it "
"is exported verbatim.  To insert a horizontal rules, use a line consisting "
"of only dashes, and at least 5 of them."
msgstr ""

#. type: Plain text
#: orgguide.texi:2164
msgid ""
"Lines starting with zero or more whitespace characters followed by @samp{#} "
"are treated as comments and will never be exported.  Also entire subtrees "
"starting with the word @samp{COMMENT} will never be exported.  Finally, "
"regions surrounded by @samp{#+BEGIN_COMMENT} ... @samp{#+END_COMMENT} will "
"not be exported."
msgstr ""

#. type: item
#: orgguide.texi:2166
#, no-wrap
msgid "C-c ;"
msgstr ""

#. type: table
#: orgguide.texi:2168
msgid "Toggle the COMMENT keyword at the beginning of an entry."
msgstr ""

#. type: section
#: orgguide.texi:2171
#, no-wrap
msgid "Images and Tables"
msgstr ""

#. type: Plain text
#: orgguide.texi:2177
msgid ""
"For Org mode tables, the lines before the first horizontal separator line "
"will become table header lines.  You can use the following lines somewhere "
"before the table to assign a caption and a label for cross references, and "
"in the text you can refer to the object with @code{\\ref@{tab:basic-data@}}:"
msgstr ""

#. type: smallexample
#: orgguide.texi:2183
#, no-wrap
msgid ""
"#+CAPTION: This is the caption for the next table (or link)\n"
"#+LABEL:   tbl:basic-data\n"
"   | ... | ...|\n"
"   |-----|----|\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2191
msgid ""
"Some backends (HTML, @LaTeX{}, and DocBook) allow you to directly include "
"images into the exported document.  Org does this, if a link to an image "
"files does not have a description part, for example @code{[[./img/a.jpg]]}.  "
"If you wish to define a caption for the image and maybe a label for internal "
"cross references, you sure that the link is on a line by itself precede it "
"with:"
msgstr ""

#. type: smallexample
#: orgguide.texi:2196
#, no-wrap
msgid ""
"#+CAPTION: This is the caption for the next figure link (or table)\n"
"#+LABEL:   fig:SED-HR4049\n"
"[[./img/a.jpg]]\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2201
msgid ""
"You may also define additional attributes for the figure.  As this is "
"backend-specific, see the sections about the individual backends for more "
"information."
msgstr ""

#. type: Plain text
#: orgguide.texi:2209
msgid ""
"You can include literal examples that should not be subjected to markup.  "
"Such examples will be typeset in monospace, so this is well suited for "
"source code and similar examples."
msgstr ""

#. type: smallexample
#: orgguide.texi:2214
#, no-wrap
msgid ""
"#+BEGIN_EXAMPLE\n"
"Some example from a text file.\n"
"#+END_EXAMPLE\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2219
msgid ""
"For simplicity when using small examples, you can also start the example "
"lines with a colon followed by a space.  There may also be additional "
"whitespace before the colon:"
msgstr ""

#. type: smallexample
#: orgguide.texi:2223
#, no-wrap
msgid ""
"Here is an example\n"
"   : Some example from a text file.\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2228
msgid ""
"For source code from a programming language, or any other text that can be "
"marked up by font-lock in Emacs, you can ask for it to look like the "
"fontified Emacs buffer"
msgstr ""

#. type: smallexample
#: orgguide.texi:2235
#, no-wrap
msgid ""
"#+BEGIN_SRC emacs-lisp\n"
"(defun org-xor (a b)\n"
"   \"Exclusive or.\"\n"
"   (if a (not b) b))\n"
"#+END_SRC\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2239
msgid ""
"To edit the example in a special buffer supporting this language, use "
"@kbd{C-c '} to both enter and leave the editing buffer."
msgstr ""

#. type: Plain text
#: orgguide.texi:2245
msgid ""
"During export, you can include the content of another file.  For example, to "
"include your @file{.emacs} file, you could use:"
msgstr ""

#. type: smallexample
#: orgguide.texi:2248
#, no-wrap
msgid "#+INCLUDE: \"~/.emacs\" src emacs-lisp\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2255
msgid ""
"The optional second and third parameter are the markup (e.g.@: @samp{quote}, "
"@samp{example}, or @samp{src}), and, if the markup is @samp{src}, the "
"language for formatting the contents.  The markup is optional, if it is not "
"given, the text will be assumed to be in Org mode format and will be "
"processed normally. @kbd{C-c '} will visit the included file."
msgstr ""

#. type: Plain text
#: orgguide.texi:2263
msgid ""
"For scientific notes which need to be able to contain mathematical symbols "
"and the occasional formula, Org-mode supports embedding @LaTeX{} code into "
"its files.  You can directly use TeX-like macros for special symbols, enter "
"formulas and entire @LaTeX{} environments."
msgstr ""

#. type: smallexample
#: orgguide.texi:2269
#, no-wrap
msgid ""
"Angles are written as Greek letters \\alpha, \\beta and \\gamma.  The mass "
"if\n"
"the sun is M_sun = 1.989 x 10^30 kg.  The radius of the sun is R_@{sun@} =\n"
"6.96 x 10^8 m.  If $a^2=b$ and $b=2$, then the solution must be either\n"
"$a=+\\sqrt@{2@}$ or $a=-\\sqrt@{2@}$.\n"
"\n"
msgstr ""

#. type: smallexample
#: orgguide.texi:2273
#, no-wrap
msgid ""
"\\begin@{equation@}\n"
"x=\\sqrt@{b@}\n"
"\\end@{equation@}\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2277
msgid ""
"@uref{http://orgmode.org/manual/LaTeX-fragments.html#LaTeX-fragments,special "
"setup}, @LaTeX{} snippets will be included as images when exporting to HTML."
msgstr ""

#. type: Plain text
#: orgguide.texi:2280
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Markup.html#Markup, Chapter 11 of "
"the manual}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:2289
msgid ""
"Org-mode documents can be exported into a variety of other formats: ASCII "
"export for inclusion into emails, HTML to publish on the web, @LaTeX{}/PDF "
"for beautiful printed documents and DocBook to enter the world of many other "
"formats using DocBook tools.  There is also export to iCalendar format so "
"that planning information can be incorporated into desktop calendars."
msgstr ""

#. type: Plain text
#: orgguide.texi:2307
msgid ""
"The exporter recognizes special lines in the buffer which provide additional "
"information.  These lines may be put anywhere in the file.  The whole set of "
"lines can be inserted into the buffer with @kbd{C-c C-e t}."
msgstr ""

#. type: item
#: orgguide.texi:2309
#, no-wrap
msgid "C-c C-e t"
msgstr ""

#. type: table
#: orgguide.texi:2311
msgid "Insert template with export options, see example below."
msgstr ""

#. type: smallexample
#: orgguide.texi:2327
#, no-wrap
msgid ""
"#+TITLE:       the title to be shown (default is the buffer name)\n"
"#+AUTHOR:      the author (default taken from @code{user-full-name})\n"
"#+DATE:        a date, fixed, of a format string for "
"@code{format-time-string}\n"
"#+EMAIL:       his/her email address (default from "
"@code{user-mail-address})\n"
"#+DESCRIPTION: the page description, e.g.@: for the XHTML meta tag\n"
"#+KEYWORDS:    the page keywords, e.g.@: for the XHTML meta tag\n"
"#+LANGUAGE:    language for HTML, e.g.@: @samp{en} "
"(@code{org-export-default-language})\n"
"#+TEXT:        Some descriptive text to be inserted at the beginning.\n"
"#+TEXT:        Several lines may be given.\n"
"#+OPTIONS:     H:2 num:t toc:t \\n:nil @@:t ::t |:t ^:t f:t TeX:t ...\n"
"#+LINK_UP:     the ``up'' link of an exported page\n"
"#+LINK_HOME:   the ``home'' link of an exported page\n"
"#+LATEX_HEADER: extra line(s) for the @LaTeX{} header, like "
"\\usepackage@{xyz@}\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2337
msgid ""
"All export commands can be reached using the export dispatcher, which is a "
"prefix key that prompts for an additional key specifying the command.  "
"Normally the entire file is exported, but if there is an active region that "
"contains one outline tree, the first heading is used as document title and "
"the subtrees are exported."
msgstr ""

#. type: item
#: orgguide.texi:2339
#, no-wrap
msgid "C-c C-e"
msgstr ""

#. type: table
#: orgguide.texi:2341
msgid "Dispatcher for export and publishing commands."
msgstr ""

#. type: Plain text
#: orgguide.texi:2349
msgid ""
"ASCII export produces a simple and very readable version of an Org-mode "
"file, containing only plain ASCII.  Latin-1 and UTF-8 export augment the "
"file with special characters and symbols available in these encodings."
msgstr ""

#. type: item
#: orgguide.texi:2351
#, no-wrap
msgid "C-c C-e a"
msgstr ""

#. type: table
#: orgguide.texi:2353
msgid "Export as ASCII file."
msgstr ""

#. type: item
#: orgguide.texi:2353
#, no-wrap
msgid "C-c C-e n @ @ @r{and} @ @ C-c C-e N"
msgstr ""

#. type: table
#: orgguide.texi:2355
msgid "Like the above commands, but use Latin-1 encoding."
msgstr ""

#. type: item
#: orgguide.texi:2355
#, no-wrap
msgid "C-c C-e u @ @ @r{and} @ @ C-c C-e U"
msgstr ""

#. type: table
#: orgguide.texi:2357
msgid "Like the above commands, but use UTF-8 encoding."
msgstr ""

#. type: item
#: orgguide.texi:2363
#, no-wrap
msgid "C-c C-e h"
msgstr ""

#. type: table
#: orgguide.texi:2365
msgid "Export as HTML file @file{myfile.html}."
msgstr ""

#. type: item
#: orgguide.texi:2365
#, no-wrap
msgid "C-c C-e b"
msgstr ""

#. type: table
#: orgguide.texi:2367
msgid "Export as HTML file and immediately open it with a browser."
msgstr ""

#. type: Plain text
#: orgguide.texi:2371
msgid ""
"To insert HTML that should be copied verbatim to the exported file use "
"either"
msgstr ""

#. type: smallexample
#: orgguide.texi:2374
#, no-wrap
msgid "#+HTML: Literal HTML code for export\n"
msgstr ""

#. type: smallexample
#: orgguide.texi:2380
#, no-wrap
msgid ""
"#+BEGIN_HTML\n"
"All lines between these markers are exported literally\n"
"#+END_HTML\n"
msgstr ""

#. type: item
#: orgguide.texi:2386
#, no-wrap
msgid "C-c C-e l"
msgstr ""

#. type: table
#: orgguide.texi:2388
msgid "Export as @LaTeX{} file @file{myfile.tex}."
msgstr ""

#. type: item
#: orgguide.texi:2388
#, no-wrap
msgid "C-c C-e p"
msgstr ""

#. type: table
#: orgguide.texi:2390
msgid "Export as @LaTeX{} and then process to PDF."
msgstr ""

#. type: item
#: orgguide.texi:2390
#, no-wrap
msgid "C-c C-e d"
msgstr ""

#. type: table
#: orgguide.texi:2392
msgid ""
"Export as @LaTeX{} and then process to PDF, then open the resulting PDF "
"file."
msgstr ""

#. type: Plain text
#: orgguide.texi:2397
msgid ""
"By default, the @LaTeX{} output uses the class @code{article}.  You can "
"change this by adding an option like @code{#+LaTeX_CLASS: myclass} in your "
"file.  The class must be listed in @code{org-export-latex-classes}."
msgstr ""

#. type: Plain text
#: orgguide.texi:2402
msgid ""
"Embedded @LaTeX{} as described in @ref{Embedded @LaTeX{}}, will be correctly "
"inserted into the @LaTeX{} file.  Similarly to the HTML exporter, you can "
"use @code{#+LaTeX:} and @code{#+BEGIN_LaTeX ... #+END_LaTeX} construct to "
"add verbatim @LaTeX{} code."
msgstr ""

#. type: item
#: orgguide.texi:2407
#, no-wrap
msgid "C-c C-e D"
msgstr ""

#. type: table
#: orgguide.texi:2409
msgid "Export as DocBook file."
msgstr ""

#. type: Plain text
#: orgguide.texi:2414
msgid ""
"Similarly to the HTML exporter, you can use @code{#+DOCBOOK:} and "
"@code{#+BEGIN_DOCBOOK ... #+END_DOCBOOK} construct to add verbatim @LaTeX{} "
"code."
msgstr ""

#. type: item
#: orgguide.texi:2419
#, no-wrap
msgid "C-c C-e i"
msgstr ""

#. type: table
#: orgguide.texi:2421
msgid "Create iCalendar entries for the current file in a @file{.ics} file."
msgstr ""

#. type: item
#: orgguide.texi:2421
#, no-wrap
msgid "C-c C-e c"
msgstr ""

#. type: table
#: orgguide.texi:2425
msgid ""
"Create a single large iCalendar file from all files in "
"@code{org-agenda-files} and write it to the file given by "
"@code{org-combined-agenda-icalendar-file}."
msgstr ""

#. type: Plain text
#: orgguide.texi:2435
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Exporting.html#Exporting, Chapter "
"12 of the manual}@* "
"@uref{http://orgmode.org/worg/org-tutorials/images-and-xhtml-export.php, "
"Sebastian Rose's image handling tutorial}@* "
"@uref{http://orgmode.org/worg/org-tutorials/org-latex-export.php, Thomas "
"Dye's LaTeX export tutorial} "
"@uref{http://orgmode.org/worg/org-tutorials/org-beamer/tutorial.php, Eric "
"Fraga's BEAMER presentation tutorial}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:2444
msgid ""
"Org includes a publishing management system that allows you to configure "
"automatic HTML conversion of @emph{projects} composed of interlinked org "
"files.  You can also configure Org to automatically upload your exported "
"HTML pages and related attachments, such as images and source code files, to "
"a web server.  For detailed instructions about setup, see the manual."
msgstr ""

#. type: Plain text
#: orgguide.texi:2446
msgid "Here is an example:"
msgstr ""

#. type: smalllisp
#: orgguide.texi:2457
#, no-wrap
msgid ""
"(setq org-publish-project-alist\n"
"      '((\"org\"\n"
"         :base-directory \"~/org/\"\n"
"         :publishing-directory \"~/public_html\"\n"
"         :section-numbers nil\n"
"         :table-of-contents nil\n"
"         :style \"<link rel=\\\"stylesheet\\\"\n"
"                href=\\\"../other/mystyle.css\\\"\n"
"                type=\\\"text/css\\\"/>\")))\n"
msgstr ""

#. type: item
#: orgguide.texi:2460
#, no-wrap
msgid "C-c C-e C"
msgstr ""

#. type: table
#: orgguide.texi:2462
msgid "Prompt for a specific project and publish all files that belong to it."
msgstr ""

#. type: item
#: orgguide.texi:2462
#, no-wrap
msgid "C-c C-e P"
msgstr ""

#. type: table
#: orgguide.texi:2464
msgid "Publish the project containing the current file."
msgstr ""

#. type: item
#: orgguide.texi:2464
#, no-wrap
msgid "C-c C-e F"
msgstr ""

#. type: table
#: orgguide.texi:2466
msgid "Publish only the current file."
msgstr ""

#. type: item
#: orgguide.texi:2466
#, no-wrap
msgid "C-c C-e E"
msgstr ""

#. type: table
#: orgguide.texi:2468
msgid "Publish every project."
msgstr ""

#. type: Plain text
#: orgguide.texi:2474
msgid ""
"Org uses timestamps to track when a file has changed.  The above functions "
"normally only publish changed files.  You can override this and force "
"publishing of all files by giving a prefix argument to any of the commands "
"above."
msgstr ""

#. type: Plain text
#: orgguide.texi:2482
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Publishing.html#Publishing, "
"Chapter 13 of the manual}@* "
"@uref{http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php, "
"Sebastian Rose's publishing tutorial}@* "
"@uref{http://orgmode.org/worg/org-tutorials/org-jekyll.php, Ian Barton's "
"Jekyll/blogging setup}}"
msgstr ""

#. type: chapter
#: orgguide.texi:2484
#, no-wrap
msgid "Working with source code"
msgstr ""

#. type: Plain text
#: orgguide.texi:2489
msgid ""
"Org-mode provides a number of features for working with source code, "
"including editing of code blocks in their native major-mode, evaluation of "
"code blocks, tangling of code blocks, and exporting code blocks and their "
"results in several formats."
msgstr ""

#. type: subheading
#: orgguide.texi:2490
#, no-wrap
msgid "Structure of Code Blocks"
msgstr ""

#. type: Plain text
#: orgguide.texi:2492
msgid "The structure of code blocks is as follows:"
msgstr ""

#. type: example
#: orgguide.texi:2498
#, no-wrap
msgid ""
"#+NAME: <name>\n"
"#+BEGIN_SRC <language> <switches> <header arguments>\n"
"  <body>\n"
"#+END_SRC\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2507
msgid ""
"Where @code{<name>} is a string used to name the code block, "
"@code{<language>} specifies the language of the code block (e.g.@: "
"@code{emacs-lisp}, @code{shell}, @code{R}, @code{python}, etc...), "
"@code{<switches>} can be used to control export of the code block, "
"@code{<header arguments>} can be used to control many aspects of code block "
"behavior as demonstrated below, and @code{<body>} contains the actual source "
"code."
msgstr ""

#. type: subheading
#: orgguide.texi:2508
#, no-wrap
msgid "Editing source code"
msgstr ""

#. type: Plain text
#: orgguide.texi:2513
msgid ""
"Use @kbd{C-c '} to edit the current code block.  This brings up a language "
"major-mode edit buffer containing the body of the code block.  Saving this "
"buffer will write the new contents back to the Org buffer.  Use @kbd{C-c '} "
"again to exit the edit buffer."
msgstr ""

#. type: subheading
#: orgguide.texi:2514
#, no-wrap
msgid "Evaluating code blocks"
msgstr ""

#. type: Plain text
#: orgguide.texi:2520
msgid ""
"Use @kbd{C-c C-c} to evaluate the current code block and insert its results "
"in the Org-mode buffer.  By default, evaluation is only turned on for "
"@code{emacs-lisp} code blocks, however support exists for evaluating blocks "
"in many languages.  For a complete list of supported languages see the "
"manual.  The following shows a code block and its results."
msgstr ""

#. type: example
#: orgguide.texi:2525
#, no-wrap
msgid ""
"#+BEGIN_SRC emacs-lisp\n"
"  (+ 1 2 3 4)\n"
"#+END_SRC\n"
"\n"
msgstr ""

#. type: example
#: orgguide.texi:2528
#, no-wrap
msgid ""
"#+RESULTS:\n"
": 10\n"
msgstr ""

#. type: subheading
#: orgguide.texi:2530
#, no-wrap
msgid "Extracting source code"
msgstr ""

#. type: Plain text
#: orgguide.texi:2538
msgid ""
"Use @kbd{C-c C-v t} to create pure source code files by extracting code from "
"source blocks in the current buffer.  This is referred to as "
"``tangling''---a term adopted from the literate programming community.  "
"During ``tangling'' of code blocks their bodies are expanded using "
"@code{org-babel-expand-src-block} which can expand both variable and "
"``noweb'' style references.  In order to tangle a code block it must have a "
"@code{:tangle} header argument, see the manual for details."
msgstr ""

#. type: subheading
#: orgguide.texi:2539
#, no-wrap
msgid "Library of Babel"
msgstr ""

#. type: Plain text
#: orgguide.texi:2544
msgid ""
"Use @kbd{C-c C-v l} to load the code blocks from an Org-mode files into the "
"``Library of Babel'', these blocks can then be evaluated from any Org-mode "
"buffer.  A collection of generally useful code blocks is distributed with "
"Org-mode in @code{contrib/library-of-babel.org}."
msgstr ""

#. type: subheading
#: orgguide.texi:2545
#, no-wrap
msgid "Header Arguments"
msgstr ""

#. type: Plain text
#: orgguide.texi:2550
msgid ""
"Many aspects of the evaluation and export of code blocks are controlled "
"through header arguments.  These can be specified globally, at the file "
"level, at the outline subtree level, and at the individual code block "
"level.  The following describes some of the header arguments."
msgstr ""

#. type: item
#: orgguide.texi:2551
#, no-wrap
msgid ":var"
msgstr ""

#. type: table
#: orgguide.texi:2555
msgid ""
"The @code{:var} header argument is used to pass arguments to code blocks.  "
"The values passed to arguments can be literal values, values from org-mode "
"tables and literal example blocks, or the results of other named code "
"blocks."
msgstr ""

#. type: item
#: orgguide.texi:2555
#, no-wrap
msgid ":results"
msgstr ""

#. type: table
#: orgguide.texi:2566
msgid ""
"The @code{:results} header argument controls the @emph{collection}, "
"@emph{type}, and @emph{handling} of code block results.  Values of "
"@code{output} or @code{value} (the default) specify how results are "
"collected from a code block's evaluation.  Values of @code{vector}, "
"@code{scalar} @code{file} @code{raw} @code{html} @code{latex} and "
"@code{code} specify the type of the results of the code block which dictates "
"how they will be incorporated into the Org-mode buffer.  Values of "
"@code{silent}, @code{replace}, @code{prepend}, and @code{append} specify "
"handling of code block results, specifically if and how the results should "
"be inserted into the Org-mode buffer."
msgstr ""

#. type: item
#: orgguide.texi:2566
#, no-wrap
msgid ":session"
msgstr ""

#. type: table
#: orgguide.texi:2571
msgid ""
"A header argument of @code{:session} will cause the code block to be "
"evaluated in a persistent interactive inferior process in Emacs.  This "
"allows for persisting state between code block evaluations, and for manual "
"inspection of the results of evaluation."
msgstr ""

#. type: item
#: orgguide.texi:2571
#, no-wrap
msgid ":exports"
msgstr ""

#. type: table
#: orgguide.texi:2575
msgid ""
"Any combination of the @emph{code} or the @emph{results} of a block can be "
"retained on export, this is specified by setting the @code{:results} header "
"argument to @code{code} @code{results} @code{none} or @code{both}."
msgstr ""

#. type: item
#: orgguide.texi:2575
#, no-wrap
msgid ":tangle"
msgstr ""

#. type: table
#: orgguide.texi:2579
msgid ""
"A header argument of @code{:tangle yes} will cause a code block's contents "
"to be tangled to a file named after the filename of the Org-mode buffer.  An "
"alternate file name can be specified with @code{:tangle filename}."
msgstr ""

#. type: item
#: orgguide.texi:2579
#, no-wrap
msgid ":cache"
msgstr ""

#. type: table
#: orgguide.texi:2583
msgid ""
"A header argument of @code{:cache yes} will cause associate a hash of the "
"expanded code block with the results, ensuring that code blocks are only "
"re-run when their inputs have changed."
msgstr ""

#. type: item
#: orgguide.texi:2583
#, no-wrap
msgid ":noweb"
msgstr ""

#. type: table
#: orgguide.texi:2586
msgid ""
"A header argument of @code{:noweb yes} will expand ``noweb'' style "
"references on evaluation and tangling."
msgstr ""

#. type: item
#: orgguide.texi:2586
#, no-wrap
msgid ":file"
msgstr ""

#. type: table
#: orgguide.texi:2591
msgid ""
"Code blocks which output results to files (e.g.@: graphs, diagrams and "
"figures)  can accept a @code{:file filename} header argument in which case "
"the results are saved to the named file, and a link to the file is inserted "
"into the Org-mode buffer."
msgstr ""

#. type: Plain text
#: orgguide.texi:2598
msgid ""
"@seealso{ "
"@uref{http://orgmode.org/manual/Literal-examples.html#Literal-examples, "
"Chapter 11.3 of the manual}@* "
"@uref{http://orgmode.org/worg/org-contrib/babel/index.php, The Babel site on "
"Worg}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:2617
msgid ""
"Org supports in-buffer completion with @kbd{M-@key{TAB}}.  This type of "
"completion does not make use of the minibuffer.  You simply type a few "
"letters into the buffer and use the key to complete text right there.  For "
"example, this command will complete @TeX{} symbols after @samp{\\}, TODO "
"keywords at the beginning of a headline, and tags after @samp{:} in a "
"headline."
msgstr ""

#. type: section
#: orgguide.texi:2619
#, no-wrap
msgid "A cleaner outline view"
msgstr ""

#. type: Plain text
#: orgguide.texi:2626
msgid ""
"Some people find it noisy and distracting that the Org headlines start with "
"a potentially large number of stars, and that text below the headlines is "
"not indented.  While this is no problem when writing a @emph{book-like} "
"document where the outline headings are really section headings, in a more "
"@emph{list-oriented} outline, indented structure is a lot cleaner:"
msgstr ""

#. type: group
#: orgguide.texi:2636
#, no-wrap
msgid ""
"* Top level headline             |    * Top level headline\n"
"** Second level                  |      * Second level\n"
"*** 3rd level                    |        * 3rd level\n"
"some text                        |          some text\n"
"*** 3rd level                    |        * 3rd level\n"
"more text                        |          more text\n"
"* Another top level headline     |    * Another top level headline\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2646
msgid ""
"If you are using at least Emacs 23.1.50.3 and version 6.29 of Org, this kind "
"of view can be achieved dynamically at display time using "
"@code{org-indent-mode}, which will prepend intangible space to each line.  "
"You can turn on @code{org-indent-mode} for all files by customizing the "
"variable @code{org-startup-indented}, or you can turn it on for individual "
"files using"
msgstr ""

#. type: smallexample
#: orgguide.texi:2649
#, no-wrap
msgid "#+STARTUP: indent\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2657
msgid ""
"If you want a similar effect in earlier version of Emacs and/or Org, or if "
"you want the indentation to be hard space characters so that the plain text "
"file looks as similar as possible to the Emacs display, Org supports you by "
"helping to indent (with @key{TAB}) text below each headline, by hiding "
"leading stars, and by only using levels 1, 3, etc to get two characters "
"indentation for each level.  To get this support in a file, use"
msgstr ""

#. type: smallexample
#: orgguide.texi:2660
#, no-wrap
msgid "#+STARTUP: hidestars odd\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2669
msgid ""
"@i{MobileOrg} is the name of the mobile companion app for Org mode, "
"currently available for iOS and for Android.  @i{MobileOrg} offers offline "
"viewing and capture support for an Org mode system rooted on a ``real'' "
"computer.  It does also allow you to record changes to existing entries."
msgstr ""

#. type: Plain text
#: orgguide.texi:2676
msgid ""
"The @uref{http://mobileorg.ncogni.to/, iOS implementation} for the "
"@i{iPhone/iPod Touch/iPad} series of devices, was developed by Richard "
"Moreland. Android users should check out "
"@uref{http://wiki.github.com/matburt/mobileorg-android/, MobileOrg Android} "
"by Matt Jones.  The two implementations are not identical but offer similar "
"features."
msgstr ""

#. type: Plain text
#: orgguide.texi:2683
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Miscellaneous.html#Miscellaneous, "
"Chapter 15 of the manual}@* "
"@uref{http://orgmode.org/manual/MobileOrg.html#MobileOrg, Appendix B of the "
"manual}@* @uref{http://orgmode.org/orgcard.pdf,Key reference card}}"
msgstr ""

[-- Attachment #3: orgguide.es.po --]
[-- Type: application/octet-stream, Size: 201448 bytes --]

# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2012-11-12 16:27+0100\n"
"PO-Revision-Date: 2012-11-12 22:42+0100\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: title
#: orgguide.texi:4 orgguide.texi:69
#, no-wrap
msgid "The compact Org-mode Guide"
msgstr "La Gu@'{@dotless{i}}a compacta de Org-mode"

#. type: include
#: orgguide.texi:6
#, no-wrap
msgid "org-version.inc"
msgstr ""

#. type: b{#1}
#: orgguide.texi:30 orgguide.texi:33
#, no-wrap
msgid "\\text\\"
msgstr "\\text\\"

#. type: copying
#: orgguide.texi:43
msgid "Copyright @copyright{} 2010-2012 Free Software Foundation"
msgstr "Copyright @copyright{} 2010-2012 Free Software Foundation"

#. type: quotation
#: orgguide.texi:51
msgid ""
"Permission is granted to copy, distribute and/or modify this document under "
"the terms of the GNU Free Documentation License, Version 1.3 or any later "
"version published by the Free Software Foundation; with no Invariant "
"Sections, with the Front-Cover texts being ``A GNU Manual,'' and with the "
"Back-Cover Texts as in (a) below.  A copy of the license is included in the "
"section entitled ``GNU Free Documentation License.''"
msgstr ""
"Se permite la copia, distribuci@'on y/o modificaci@'on de este\n"
"documento bajo los t@'erminos de la GNU Free Documentation License,\n"
"Version 1.3 o posteriores versiones publicadas por la Free Software\n"
"Foundation; sin secciones invariantes, con texto al inicio de la\n"
"cubierta de portada 'A GNU Manual', y con el texto de contraportada\n"
"como se muestra abajo (a). Una copia de esta licencia est@'a incluida\n"
"en la secci@'on titulada 'GNU Free Documentation License''."

#. type: quotation
#: orgguide.texi:55
msgid ""
"(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and modify "
"this GNU manual.  Buying copies from the FSF supports it in developing GNU "
"and promoting software freedom.''"
msgstr ""
"(a) El texto de contraportada de la FSF es: 'Tu tienes la libertad\n"
"para copiar y modificar este manual GNU, Comprando copias desde la FSF\n"
"se facilita el desarrollo de GNU y la promoci@'on del software\n"
"libre'."

#. type: quotation
#: orgguide.texi:60
msgid ""
"This document is part of a collection distributed under the GNU Free "
"Documentation License.  If you want to distribute this document separately "
"from the collection, you can do so by adding a copy of the license to the "
"document, as described in section 6 of the license."
msgstr ""
"Este documento forma parte de una colecci@'on distribuida bajo la GNU\n"
"Free Documentation License. Si desea distribuir este documento\n"
"separadamente de la colecci@'on, puede hacerlo a@~nadiendo una copia de\n"
"la licencia al documento, como se describe en la secci@'on 6 de la\n"
"licencia."

#. type: dircategory
#: orgguide.texi:63
#, no-wrap
msgid "Emacs"
msgstr "Emacs"

#. type: menuentry
#: orgguide.texi:66
msgid "Org Mode Guide: (orgguide)"
msgstr "Gu@'{@dotless{i}}a de Org-mode: (orgguide)"

#. type: menuentry
#: orgguide.texi:66
msgid "Abbreviated Org-mode Manual"
msgstr "Manual de Org-mode Abreviado"

#. type: subtitle
#: orgguide.texi:71
#, no-wrap
msgid "Release @value{VERSION}"
msgstr "Versi@'on @value{VERSION}"

#. type: author
#: orgguide.texi:72
#, no-wrap
msgid "by Carsten Dominik"
msgstr "por Carsten Dominik"

#. type: node
#: orgguide.texi:84 orgguide.texi:227 orgguide.texi:300 orgguide.texi:569
#: orgguide.texi:693 orgguide.texi:834 orgguide.texi:1100 orgguide.texi:1229
#: orgguide.texi:1290 orgguide.texi:1514 orgguide.texi:1681 orgguide.texi:2044
#: orgguide.texi:2281 orgguide.texi:2436 orgguide.texi:2483 orgguide.texi:2599
#, no-wrap
msgid "Top"
msgstr "Top"

#. type: node
#: orgguide.texi:84 orgguide.texi:106 orgguide.texi:111 orgguide.texi:227
#: orgguide.texi:228 orgguide.texi:237 orgguide.texi:250 orgguide.texi:274
#: orgguide.texi:293 orgguide.texi:300
#, no-wrap
msgid "Introduction"
msgstr "Introducci@'on"

#. type: node
#: orgguide.texi:84
#, no-wrap
msgid "(dir)"
msgstr "(dir)"

#. type: top
#: orgguide.texi:85
#, no-wrap
msgid "Org Mode Guide"
msgstr "Gu@'{@dotless{i}}a de Org Mode"

#. type: menuentry
#: orgguide.texi:106
msgid "Getting started"
msgstr "Comenzando"

#. type: node
#: orgguide.texi:106 orgguide.texi:118 orgguide.texi:227 orgguide.texi:300
#: orgguide.texi:301 orgguide.texi:317 orgguide.texi:329 orgguide.texi:352
#: orgguide.texi:394 orgguide.texi:411 orgguide.texi:442 orgguide.texi:468
#: orgguide.texi:535 orgguide.texi:569
#, no-wrap
msgid "Document Structure"
msgstr "Estructura del documento"

#. type: menuentry
#: orgguide.texi:106
msgid "A tree works like your brain"
msgstr "Un @'arbol funciona como tu cerebro"

#. type: node
#: orgguide.texi:106 orgguide.texi:300 orgguide.texi:569 orgguide.texi:570
#: orgguide.texi:693
#, no-wrap
msgid "Tables"
msgstr "Tablas"

#. type: menuentry
#: orgguide.texi:106
msgid "Pure magic for quick formatting"
msgstr "Pura magia para formatear r@'apido"

#. type: node
#: orgguide.texi:106 orgguide.texi:129 orgguide.texi:569 orgguide.texi:693
#: orgguide.texi:694 orgguide.texi:707 orgguide.texi:724 orgguide.texi:736
#: orgguide.texi:780 orgguide.texi:814 orgguide.texi:834
#, no-wrap
msgid "Hyperlinks"
msgstr "Hiperenlaces"

#. type: menuentry
#: orgguide.texi:106
msgid "Notes in context"
msgstr "Notas en contexto"

#. type: node
#: orgguide.texi:106 orgguide.texi:137 orgguide.texi:693 orgguide.texi:834
#: orgguide.texi:835 orgguide.texi:858 orgguide.texi:901 orgguide.texi:951
#: orgguide.texi:1013 orgguide.texi:1039 orgguide.texi:1059 orgguide.texi:1100
#, no-wrap
msgid "TODO Items"
msgstr "Items TODO"

#. type: menuentry
#: orgguide.texi:106
msgid "Every tree branch can be a TODO item"
msgstr "Cada rama del @'arbol puede ser un @'{@dotless{i}}tem TODO"

#. type: node
#: orgguide.texi:106 orgguide.texi:151 orgguide.texi:834 orgguide.texi:1100
#: orgguide.texi:1101 orgguide.texi:1119 orgguide.texi:1145 orgguide.texi:1196
#: orgguide.texi:1229
#, no-wrap
msgid "Tags"
msgstr "Etiquetas"

#. type: menuentry
#: orgguide.texi:106
msgid "Tagging headlines and matching sets of tags"
msgstr "Etiquetando cabeceras y encontrando grupos de etiquetas"

#. type: node
#: orgguide.texi:106 orgguide.texi:1100 orgguide.texi:1229 orgguide.texi:1230
#: orgguide.texi:1290
#, no-wrap
msgid "Properties"
msgstr "Propiedades"

#. type: node
#: orgguide.texi:106 orgguide.texi:157 orgguide.texi:1229 orgguide.texi:1290
#: orgguide.texi:1291 orgguide.texi:1305 orgguide.texi:1363 orgguide.texi:1399
#: orgguide.texi:1462 orgguide.texi:1514
#, no-wrap
msgid "Dates and Times"
msgstr "Fechas y horas"

#. type: menuentry
#: orgguide.texi:106
msgid "Making items useful for planning"
msgstr "Creando @'{@dotless{i}}tems @'utiles para planificar"

#. type: node
#: orgguide.texi:106 orgguide.texi:164 orgguide.texi:1290 orgguide.texi:1514
#: orgguide.texi:1515 orgguide.texi:1530 orgguide.texi:1618 orgguide.texi:1643
#: orgguide.texi:1681
#, no-wrap
msgid "Capture - Refile - Archive"
msgstr "Capture - Refile - Archive"

#. type: menuentry
#: orgguide.texi:106
msgid "The ins and outs for projects"
msgstr "Las entradas y salidas para proyectos"

#. type: node
#: orgguide.texi:106 orgguide.texi:176 orgguide.texi:1514 orgguide.texi:1681
#: orgguide.texi:1682 orgguide.texi:1706 orgguide.texi:1724 orgguide.texi:1745
#: orgguide.texi:1884 orgguide.texi:1995 orgguide.texi:2044
#, no-wrap
msgid "Agenda Views"
msgstr "Vistas de la Agenda"

#. type: menuentry
#: orgguide.texi:106
msgid "Collecting information into views"
msgstr "Recolectando informaci@'on en vistas"

#. type: node
#: orgguide.texi:106 orgguide.texi:1681 orgguide.texi:2044 orgguide.texi:2061
#: orgguide.texi:2170 orgguide.texi:2203 orgguide.texi:2240 orgguide.texi:2256
#: orgguide.texi:2281
#, no-wrap
msgid "Markup"
msgstr "Marcado"

#. type: menuentry
#: orgguide.texi:106
msgid "Prepare text for rich export"
msgstr "Preparar texto para exportaci@'on enriquecida"

#. type: node
#: orgguide.texi:106 orgguide.texi:209 orgguide.texi:2044 orgguide.texi:2281
#: orgguide.texi:2282 orgguide.texi:2300 orgguide.texi:2329 orgguide.texi:2343
#: orgguide.texi:2359 orgguide.texi:2382 orgguide.texi:2403 orgguide.texi:2415
#: orgguide.texi:2436
#, no-wrap
msgid "Exporting"
msgstr "Exportando"

#. type: menuentry
#: orgguide.texi:106
msgid "Sharing and publishing of notes"
msgstr "Compartici@'on y publicaci@'on de notas"

#. type: node
#: orgguide.texi:106 orgguide.texi:2281 orgguide.texi:2436 orgguide.texi:2437
#: orgguide.texi:2483
#, no-wrap
msgid "Publishing"
msgstr "Publicaci@'on"

#. type: menuentry
#: orgguide.texi:106
msgid "Create a web site of linked Org files"
msgstr "Crear un sitio web de ficheros Org enlazados"

#. type: node
#: orgguide.texi:106 orgguide.texi:2436 orgguide.texi:2483 orgguide.texi:2599
#, no-wrap
msgid "Working With Source Code"
msgstr "Trabajando con C@'odigo Fuente"

#. type: menuentry
#: orgguide.texi:106
msgid "Source code snippets embedded in Org"
msgstr "Trozos de c@'odigo fuente embebidos en Org"

#. type: node
#: orgguide.texi:106 orgguide.texi:219 orgguide.texi:2483 orgguide.texi:2599
#: orgguide.texi:2600 orgguide.texi:2608 orgguide.texi:2618 orgguide.texi:2662
#, no-wrap
msgid "Miscellaneous"
msgstr "Miscel@'aneos"

#. type: menuentry
#: orgguide.texi:106
msgid "All the rest which did not fit elsewhere"
msgstr "El resto de cosas que no tienen otro lugar"

#. type: menuentry
#: orgguide.texi:109
msgid "--- The Detailed Node Listing ---"
msgstr "--- El Listado Detallado de Nodos ---"

#. type: node
#: orgguide.texi:116 orgguide.texi:235 orgguide.texi:237 orgguide.texi:238
#: orgguide.texi:250
#, no-wrap
msgid "Preface"
msgstr "Prefacio"

#. type: menuentry
#: orgguide.texi:116 orgguide.texi:235
msgid "Welcome"
msgstr "Bienvenida"

#. type: node
#: orgguide.texi:116 orgguide.texi:235 orgguide.texi:237 orgguide.texi:250
#: orgguide.texi:251 orgguide.texi:274
#, no-wrap
msgid "Installation"
msgstr "Instalaci@'on"

#. type: menuentry
#: orgguide.texi:116 orgguide.texi:235
msgid "How to install a downloaded version of Org"
msgstr "C@'omo instalar una versi@'on descargada de Org"

#. type: node
#: orgguide.texi:116 orgguide.texi:235 orgguide.texi:250 orgguide.texi:274
#: orgguide.texi:275 orgguide.texi:293
#, no-wrap
msgid "Activation"
msgstr "Activaci@'on"

#. type: menuentry
#: orgguide.texi:116 orgguide.texi:235
msgid "How to activate Org for certain buffers"
msgstr "C@'omo activar Org para ciertos buffers"

#. type: section
#: orgguide.texi:116 orgguide.texi:235 orgguide.texi:274 orgguide.texi:293
#: orgguide.texi:294
#, no-wrap
msgid "Feedback"
msgstr "Realimentaci@'on"

#. type: menuentry
#: orgguide.texi:116 orgguide.texi:235
msgid "Bug reports, ideas, patches etc."
msgstr "Informes de error, ideas, parches, etc."

#. type: node
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:317 orgguide.texi:318
#: orgguide.texi:329
#, no-wrap
msgid "Outlines"
msgstr "Outlines"

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "Org is based on Outline mode"
msgstr "Org est@'a basado en el modo Outline"

#. type: node
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:317 orgguide.texi:329
#: orgguide.texi:330 orgguide.texi:352
#, no-wrap
msgid "Headlines"
msgstr "Cabeceras"

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "How to typeset Org tree headlines"
msgstr "C@'omo escribir un @'arbol de cabeceras Org"

#. type: node
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:329 orgguide.texi:352
#: orgguide.texi:353 orgguide.texi:394
#, no-wrap
msgid "Visibility cycling"
msgstr "Visibilidad c@'{@dotless{i}}clica"

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "Show and hide, much simplified"
msgstr "Mostrar y ocultar, muy simplificado"

#. type: node
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:352 orgguide.texi:394
#: orgguide.texi:395 orgguide.texi:411
#, no-wrap
msgid "Motion"
msgstr "Movimiento"

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "Jumping to other headlines"
msgstr "Saltando a otras cabeceras"

#. type: node
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:394 orgguide.texi:411
#: orgguide.texi:412 orgguide.texi:442
#, no-wrap
msgid "Structure editing"
msgstr "Edici@'on de estructura"

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "Changing sequence and level of headlines"
msgstr "Cambiando la secuencia y el nivel de cabeceras"

#. type: node
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:411 orgguide.texi:442
#: orgguide.texi:443 orgguide.texi:468
#, no-wrap
msgid "Sparse trees"
msgstr "@'Arboles poco densos"

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "Matches embedded in context"
msgstr "Correspondencias embebidas en contexto"

#. type: node
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:442 orgguide.texi:468
#: orgguide.texi:469 orgguide.texi:535
#, no-wrap
msgid "Plain lists"
msgstr "Listas planas"

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "Additional structure within an entry"
msgstr "Estructura adicional con una entrada"

#. type: section
#: orgguide.texi:127 orgguide.texi:315 orgguide.texi:468 orgguide.texi:535
#: orgguide.texi:536
#, no-wrap
msgid "Footnotes"
msgstr "Notas al pie"

#. type: menuentry
#: orgguide.texi:127 orgguide.texi:315
msgid "How footnotes are defined in Org's syntax"
msgstr "C@'omo las notas al pie est@'an definidas en sintaxis Org"

#. type: node
#: orgguide.texi:135 orgguide.texi:705 orgguide.texi:707 orgguide.texi:708
#: orgguide.texi:724
#, no-wrap
msgid "Link format"
msgstr "Formato de enlace"

#. type: menuentry
#: orgguide.texi:135 orgguide.texi:705
msgid "How links in Org are formatted"
msgstr "C@'omo los enlaces son formateados en Org"

#. type: node
#: orgguide.texi:135 orgguide.texi:705 orgguide.texi:707 orgguide.texi:724
#: orgguide.texi:725 orgguide.texi:736
#, no-wrap
msgid "Internal links"
msgstr "Enlaces internos"

#. type: menuentry
#: orgguide.texi:135 orgguide.texi:705
msgid "Links to other places in the current file"
msgstr "Enlaces a otros lugares en el fichero actual"

#. type: node
#: orgguide.texi:135 orgguide.texi:705 orgguide.texi:724 orgguide.texi:736
#: orgguide.texi:737 orgguide.texi:780
#, no-wrap
msgid "External links"
msgstr "Enlaces externos"

#. type: menuentry
#: orgguide.texi:135 orgguide.texi:705
msgid "URL-like links to the world"
msgstr "Enlaces tipo URL para el mundo"

#. type: node
#: orgguide.texi:135 orgguide.texi:705 orgguide.texi:736 orgguide.texi:780
#: orgguide.texi:781 orgguide.texi:814
#, no-wrap
msgid "Handling links"
msgstr "Manejando enlaces"

#. type: menuentry
#: orgguide.texi:135 orgguide.texi:705
msgid "Creating, inserting and following"
msgstr "Creando, insertando y siguiendo"

#. type: section
#: orgguide.texi:135 orgguide.texi:705 orgguide.texi:780 orgguide.texi:814
#: orgguide.texi:815
#, no-wrap
msgid "Targeted links"
msgstr "Destinos enlazados"

#. type: menuentry
#: orgguide.texi:135 orgguide.texi:705
msgid "Point at a location in a file"
msgstr "Apuntando a una localizaci@'on en un archivo"

#. type: node
#: orgguide.texi:144 orgguide.texi:856 orgguide.texi:858 orgguide.texi:859
#: orgguide.texi:901
#, no-wrap
msgid "Using TODO states"
msgstr "Usando los estados TODO"

#. type: menuentry
#: orgguide.texi:144 orgguide.texi:856
msgid "Setting and switching states"
msgstr "Poniendo y cambiado estados"

#. type: node
#: orgguide.texi:144 orgguide.texi:856 orgguide.texi:858 orgguide.texi:901
#: orgguide.texi:902 orgguide.texi:951
#, no-wrap
msgid "Multi-state workflows"
msgstr "Flujos de trabajo multi-estado"

#. type: menuentry
#: orgguide.texi:144 orgguide.texi:856
msgid "More than just on/off"
msgstr "M@'as que ahora si/no"

#. type: node
#: orgguide.texi:144 orgguide.texi:146 orgguide.texi:856 orgguide.texi:901
#: orgguide.texi:951 orgguide.texi:952 orgguide.texi:966 orgguide.texi:992
#: orgguide.texi:1013
#, no-wrap
msgid "Progress logging"
msgstr "Proceso de acceso"

#. type: menuentry
#: orgguide.texi:144 orgguide.texi:856
msgid "Dates and notes for progress"
msgstr "Fechas y notas para el progreso"

#. type: node
#: orgguide.texi:144 orgguide.texi:856 orgguide.texi:951 orgguide.texi:1013
#: orgguide.texi:1014 orgguide.texi:1039
#, no-wrap
msgid "Priorities"
msgstr "Prioridades"

#. type: menuentry
#: orgguide.texi:144 orgguide.texi:856
msgid "Some things are more important than others"
msgstr "Algunas cosas son m@'as importantes que otras"

#. type: node
#: orgguide.texi:144 orgguide.texi:856 orgguide.texi:1013 orgguide.texi:1039
#: orgguide.texi:1059
#, no-wrap
msgid "Breaking down tasks"
msgstr "Rompiendo tareas"

#. type: menuentry
#: orgguide.texi:144 orgguide.texi:856
msgid "Splitting a task into manageable pieces"
msgstr "Partiendo una tarea en piezas manejables"

#. type: section
#: orgguide.texi:144 orgguide.texi:856 orgguide.texi:1039 orgguide.texi:1059
#: orgguide.texi:1060
#, no-wrap
msgid "Checkboxes"
msgstr "Cajas de chequeo"

#. type: menuentry
#: orgguide.texi:144 orgguide.texi:856
msgid "Tick-off lists"
msgstr "Listas de marcas"

#. type: node
#: orgguide.texi:149 orgguide.texi:964 orgguide.texi:966 orgguide.texi:967
#: orgguide.texi:992
#, no-wrap
msgid "Closing items"
msgstr "Cerrando items"

#. type: menuentry
#: orgguide.texi:149 orgguide.texi:964
msgid "When was this entry marked DONE?"
msgstr "¿Cuando fu@'e marcada esta entrada a DONE?"

#. type: unnumberedsubsec
#: orgguide.texi:149 orgguide.texi:964 orgguide.texi:966 orgguide.texi:992
#: orgguide.texi:993
#, no-wrap
msgid "Tracking TODO state changes"
msgstr "Trazando los estados TODO"

#. type: menuentry
#: orgguide.texi:149 orgguide.texi:964
msgid "When did the status change?"
msgstr "¿Cuando cambia el estado?"

#. type: node
#: orgguide.texi:155 orgguide.texi:1117 orgguide.texi:1119 orgguide.texi:1120
#: orgguide.texi:1145
#, no-wrap
msgid "Tag inheritance"
msgstr "Marca de herencia"

#. type: menuentry
#: orgguide.texi:155 orgguide.texi:1117
#, fuzzy
msgid "Tags use the tree structure of the outline"
msgstr "Las marcas usan el @'arbol de estructura de outline"

#. type: node
#: orgguide.texi:155 orgguide.texi:1117 orgguide.texi:1119 orgguide.texi:1145
#: orgguide.texi:1146 orgguide.texi:1196
#, no-wrap
msgid "Setting tags"
msgstr "Poniendo marcas"

#. type: menuentry
#: orgguide.texi:155 orgguide.texi:1117
msgid "How to assign tags to a headline"
msgstr "C@'omo asignar etiquetas a una cabecera"

#. type: section
#: orgguide.texi:155 orgguide.texi:1117 orgguide.texi:1145 orgguide.texi:1196
#: orgguide.texi:1197
#, no-wrap
msgid "Tag searches"
msgstr "Buscando marcas"

#. type: menuentry
#: orgguide.texi:155 orgguide.texi:1117
msgid "Searching for combinations of tags"
msgstr "Buscando combinaciones de etiquetas"

#. type: node
#: orgguide.texi:162 orgguide.texi:1302 orgguide.texi:1305 orgguide.texi:1306
#: orgguide.texi:1363
#, no-wrap
msgid "Timestamps"
msgstr "Instante en el tiempo"

#. type: menuentry
#: orgguide.texi:162 orgguide.texi:1302
msgid "Assigning a time to a tree entry"
msgstr "Asignaci@'on de tiempo a una entrada de @'arbol"

#. type: node
#: orgguide.texi:162 orgguide.texi:1302 orgguide.texi:1305 orgguide.texi:1363
#: orgguide.texi:1364 orgguide.texi:1399
#, no-wrap
msgid "Creating timestamps"
msgstr "Creando instantes de tiempo"

#. type: menuentry
#: orgguide.texi:162 orgguide.texi:1302
msgid "Commands which insert timestamps"
msgstr "Comandos para insertar instantes de tiempo"

#. type: node
#: orgguide.texi:162 orgguide.texi:1302 orgguide.texi:1363 orgguide.texi:1399
#: orgguide.texi:1400 orgguide.texi:1462
#, no-wrap
msgid "Deadlines and scheduling"
msgstr "Fecha l@'{@dotless{i}}mite y planificaci@'on"

#. type: menuentry
#: orgguide.texi:162 orgguide.texi:1302
msgid "Planning your work"
msgstr "Planificando tu trabajo"

#. type: section
#: orgguide.texi:162 orgguide.texi:1302 orgguide.texi:1399 orgguide.texi:1462
#: orgguide.texi:1463
#, no-wrap
msgid "Clocking work time"
msgstr "Estableciendo tiempo de trabajo"

#. type: menuentry
#: orgguide.texi:162 orgguide.texi:1302
msgid "Tracking how long you spend on a task"
msgstr "Llevando la cuenta de cuanto se gasta en una tarea"

#. type: node
#: orgguide.texi:168 orgguide.texi:170 orgguide.texi:1528 orgguide.texi:1530
#: orgguide.texi:1531 orgguide.texi:1544 orgguide.texi:1558 orgguide.texi:1575
#: orgguide.texi:1618
#, no-wrap
msgid "Capture"
msgstr "Capturar"

#. type: node
#: orgguide.texi:168 orgguide.texi:1528 orgguide.texi:1530 orgguide.texi:1618
#: orgguide.texi:1619 orgguide.texi:1643
#, no-wrap
msgid "Refile and copy"
msgstr ""

#. type: menuentry
#: orgguide.texi:168 orgguide.texi:1528
msgid "Moving a tree from one place to another"
msgstr "Moviendo un @'arbol de un lugar a otro"

#. type: section
#: orgguide.texi:168 orgguide.texi:1528 orgguide.texi:1618 orgguide.texi:1643
#: orgguide.texi:1644
#, no-wrap
msgid "Archiving"
msgstr "Archivando"

#. type: menuentry
#: orgguide.texi:168 orgguide.texi:1528
msgid "What to do with finished projects"
msgstr "Qu@'e se hace con los proyectos terminados"

#. type: node
#: orgguide.texi:174 orgguide.texi:1542 orgguide.texi:1544 orgguide.texi:1545
#: orgguide.texi:1558
#, fuzzy, no-wrap
msgid "Setting up a capture location"
msgstr "Poniendo una posici@'on de captura"

#. type: menuentry
#: orgguide.texi:174 orgguide.texi:1542
msgid "Where notes will be stored"
msgstr "Donde ser@'an almacenadas las notas"

#. type: node
#: orgguide.texi:174 orgguide.texi:1542 orgguide.texi:1544 orgguide.texi:1558
#: orgguide.texi:1559 orgguide.texi:1575
#, no-wrap
msgid "Using capture"
msgstr "Usando capturas"

#. type: menuentry
#: orgguide.texi:174 orgguide.texi:1542
msgid "Commands to invoke and terminate capture"
msgstr "Comandos para invocar y finalizar capturas"

#. type: unnumberedsubsec
#: orgguide.texi:174 orgguide.texi:1542 orgguide.texi:1558 orgguide.texi:1575
#: orgguide.texi:1576
#, no-wrap
msgid "Capture templates"
msgstr "Plantillas de capturas"

#. type: menuentry
#: orgguide.texi:174 orgguide.texi:1542
#, fuzzy
msgid "Define the outline of different note types"
msgstr "Define el outline de diferentes tipos de notas"

#. type: node
#: orgguide.texi:182 orgguide.texi:1704 orgguide.texi:1706 orgguide.texi:1707
#: orgguide.texi:1724
#, no-wrap
msgid "Agenda files"
msgstr "Archivos de agenda"

#. type: menuentry
#: orgguide.texi:182 orgguide.texi:1704
msgid "Files being searched for agenda information"
msgstr "Archivos buscados para la informaci@'on de la agenda"

#. type: node
#: orgguide.texi:182 orgguide.texi:1704 orgguide.texi:1706 orgguide.texi:1724
#: orgguide.texi:1745
#, no-wrap
msgid "Agenda dispatcher"
msgstr "Despachador de agenda"

#. type: menuentry
#: orgguide.texi:182 orgguide.texi:1704
#, fuzzy
msgid "Keyboard access to agenda views"
msgstr "Acceso a las vistas de la agenda con teclado"

#. type: node
#: orgguide.texi:182 orgguide.texi:1704 orgguide.texi:1724 orgguide.texi:1745
#: orgguide.texi:1756 orgguide.texi:1785 orgguide.texi:1801 orgguide.texi:1847
#: orgguide.texi:1861 orgguide.texi:1884
#, no-wrap
msgid "Built-in agenda views"
msgstr "Vistas de agenda internas"

#. type: menuentry
#: orgguide.texi:182 orgguide.texi:1704
#, fuzzy
msgid "What is available out of the box?"
msgstr "¿Qu@'e hay fuera de la caja?"

#. type: node
#: orgguide.texi:182 orgguide.texi:1704 orgguide.texi:1745 orgguide.texi:1884
#: orgguide.texi:1995
#, no-wrap
msgid "Agenda commands"
msgstr "Comandos de la agenda"

#. type: menuentry
#: orgguide.texi:182 orgguide.texi:1704
#, fuzzy
msgid "Remote editing of Org trees"
msgstr "Edici@'on remota de @'arboles Org"

#. type: section
#: orgguide.texi:182 orgguide.texi:1704 orgguide.texi:1884 orgguide.texi:1995
#: orgguide.texi:1996
#, no-wrap
msgid "Custom agenda views"
msgstr "Vistas de agenda personalizadas"

#. type: menuentry
#: orgguide.texi:182 orgguide.texi:1704
#, fuzzy
msgid "Defining special searches and views"
msgstr "Definiendo b@'usquedas y vistas especiales"

#. type: section
#: orgguide.texi:184 orgguide.texi:1746
#, no-wrap
msgid "The built-in agenda views"
msgstr "Las vistas internas de la agenda"

#. type: node
#: orgguide.texi:190 orgguide.texi:1754 orgguide.texi:1756 orgguide.texi:1785
#, no-wrap
msgid "Weekly/daily agenda"
msgstr "Agenda semanal/diaria"

#. type: menuentry
#: orgguide.texi:190 orgguide.texi:1754
#, fuzzy
msgid "The calendar page with current tasks"
msgstr "La p@'agina del calendario con las tareas actuales"

#. type: node
#: orgguide.texi:190 orgguide.texi:1754 orgguide.texi:1756 orgguide.texi:1785
#: orgguide.texi:1801
#, no-wrap
msgid "Global TODO list"
msgstr "Lista global TODO"

#. type: menuentry
#: orgguide.texi:190 orgguide.texi:1754
#, fuzzy
msgid "All unfinished action items"
msgstr "Todas las acciones de items no finalizados"

#. type: node
#: orgguide.texi:190 orgguide.texi:1754 orgguide.texi:1785 orgguide.texi:1801
#: orgguide.texi:1802 orgguide.texi:1847
#, no-wrap
msgid "Matching tags and properties"
msgstr "Coincidiendo marcas y propiedades"

#. type: menuentry
#: orgguide.texi:190 orgguide.texi:1754
#, fuzzy
msgid "Structured information with fine-tuned search"
msgstr "Informaci@'on estructurada con b@'usquedas afinadas"

#. type: node
#: orgguide.texi:190 orgguide.texi:1754 orgguide.texi:1801 orgguide.texi:1847
#: orgguide.texi:1861
#, no-wrap
msgid "Timeline"
msgstr "L@'{@dotless{i}}nea de tiempo"

#. type: menuentry
#: orgguide.texi:190 orgguide.texi:1754
msgid "Time-sorted view for single file"
msgstr "Vista ordenada en el tiempo de un simple archivo"

#. type: subsection
#: orgguide.texi:190 orgguide.texi:1754 orgguide.texi:1847 orgguide.texi:1861
#: orgguide.texi:1862
#, no-wrap
msgid "Search view"
msgstr "Vista de b@'usqueda"

#. type: menuentry
#: orgguide.texi:190 orgguide.texi:1754
msgid "Find entries by searching for text"
msgstr "Encontrando entradas buscando texto"

#. type: chapter
#: orgguide.texi:192 orgguide.texi:2045
#, no-wrap
msgid "Markup for rich export"
msgstr "Marcas para enriquecer la exportaci@'on"

#. type: node
#: orgguide.texi:198 orgguide.texi:200 orgguide.texi:2059 orgguide.texi:2061
#: orgguide.texi:2062 orgguide.texi:2073 orgguide.texi:2083 orgguide.texi:2098
#: orgguide.texi:2109 orgguide.texi:2147 orgguide.texi:2156 orgguide.texi:2170
#, no-wrap
msgid "Structural markup elements"
msgstr "Elementos del marcado estructural"

#. type: menuentry
#: orgguide.texi:198 orgguide.texi:2059
#, fuzzy
msgid "The basic structure as seen by the exporter"
msgstr "La estructura b@'asica es vista por el exportador"

#. type: node
#: orgguide.texi:198 orgguide.texi:2059 orgguide.texi:2061 orgguide.texi:2170
#: orgguide.texi:2203
#, fuzzy, no-wrap
msgid "Images and tables"
msgstr "Im@'agenes y tablas"

#. type: menuentry
#: orgguide.texi:198 orgguide.texi:2059
#, fuzzy
msgid "Tables and Images will be included"
msgstr "Tablas e im@'agenes ser@'an incluidas"

#. type: node
#: orgguide.texi:198 orgguide.texi:2059 orgguide.texi:2170 orgguide.texi:2203
#: orgguide.texi:2204 orgguide.texi:2240
#, fuzzy, no-wrap
msgid "Literal examples"
msgstr "Ejemplos literales"

#. type: menuentry
#: orgguide.texi:198 orgguide.texi:2059
#, fuzzy
msgid "Source code examples with special formatting"
msgstr "Ejemplos de c@'odigo fuente con formato especial"

#. type: node
#: orgguide.texi:198 orgguide.texi:2059 orgguide.texi:2203 orgguide.texi:2240
#: orgguide.texi:2241 orgguide.texi:2256
#, no-wrap
msgid "Include files"
msgstr "Archivos Include"

#. type: menuentry
#: orgguide.texi:198 orgguide.texi:2059
#, fuzzy
msgid "Include additional files into a document"
msgstr "Archivos adicionales Include dentro de un documento"

#. type: section
#: orgguide.texi:198 orgguide.texi:2059 orgguide.texi:2240 orgguide.texi:2256
#: orgguide.texi:2257
#, no-wrap
msgid "Embedded @LaTeX{}"
msgstr "@LaTeX{} embebido"

#. type: menuentry
#: orgguide.texi:198 orgguide.texi:2059
#, fuzzy
msgid "@LaTeX{} can be freely used inside Org documents"
msgstr "@LaTeX{} puede usarse libremente dentro de los documentos Org"

#. type: node
#: orgguide.texi:207 orgguide.texi:2071 orgguide.texi:2073 orgguide.texi:2074
#: orgguide.texi:2083
#, no-wrap
msgid "Document title"
msgstr "T@'{@dotless{i}}tulo de documento"

#. type: menuentry
#: orgguide.texi:207 orgguide.texi:2071
#, fuzzy
msgid "Where the title is taken from"
msgstr "Desde donde el t@'{@dotless{i}}tulo es tomado"

#. type: node
#: orgguide.texi:207 orgguide.texi:2071 orgguide.texi:2073 orgguide.texi:2083
#: orgguide.texi:2084 orgguide.texi:2098
#, no-wrap
msgid "Headings and sections"
msgstr "Encabezados y secciones"

#. type: menuentry
#: orgguide.texi:207 orgguide.texi:2071
#, fuzzy
msgid "The document structure as seen by the exporter"
msgstr "La estructura del documento es vista por el exportador"

#. type: node
#: orgguide.texi:207 orgguide.texi:2071 orgguide.texi:2083 orgguide.texi:2098
#: orgguide.texi:2099 orgguide.texi:2109
#, no-wrap
msgid "Table of contents"
msgstr "Tabla de contenidos"

#. type: menuentry
#: orgguide.texi:207 orgguide.texi:2071
#, fuzzy
msgid "The if and where of the table of contents"
msgstr "El si y el donde de la tabla de contenidos"

#. type: node
#: orgguide.texi:207 orgguide.texi:2071 orgguide.texi:2098 orgguide.texi:2109
#: orgguide.texi:2147
#, no-wrap
msgid "Paragraphs"
msgstr "P@'arrafos"

#. type: node
#: orgguide.texi:207 orgguide.texi:2071 orgguide.texi:2109 orgguide.texi:2147
#: orgguide.texi:2148 orgguide.texi:2156
#, no-wrap
msgid "Emphasis and monospace"
msgstr "@'Enfasis y monoespacio"

#. type: menuentry
#: orgguide.texi:207 orgguide.texi:2071
msgid "Bold, italic, etc."
msgstr "Negrilla, it@'alica, etc."

#. type: subheading
#: orgguide.texi:207 orgguide.texi:2071 orgguide.texi:2147 orgguide.texi:2156
#: orgguide.texi:2157
#, no-wrap
msgid "Comment lines"
msgstr "L@'{@dotless{i}}neas de comentarios"

#. type: menuentry
#: orgguide.texi:207 orgguide.texi:2071
msgid "What will *not* be exported"
msgstr "Qu@'e *no* ser@'a exportado"

#. type: node
#: orgguide.texi:217 orgguide.texi:2298 orgguide.texi:2300 orgguide.texi:2301
#: orgguide.texi:2329
#, no-wrap
msgid "Export options"
msgstr "Opciones de exportaci@'on"

#. type: menuentry
#: orgguide.texi:217 orgguide.texi:2298
#, fuzzy
msgid "Per-file export settings"
msgstr "Configuraci@'on del perf@'{@dotless{i}}l de exportaci@'on"

#. type: node
#: orgguide.texi:217 orgguide.texi:2298 orgguide.texi:2300 orgguide.texi:2329
#: orgguide.texi:2330 orgguide.texi:2343
#, no-wrap
msgid "The export dispatcher"
msgstr "El dispensador de exportaci@'on"

#. type: menuentry
#: orgguide.texi:217 orgguide.texi:2298
#, fuzzy
msgid "How to access exporter commands"
msgstr "Como acceder a los comandos del exportador"

#. type: node
#: orgguide.texi:217 orgguide.texi:2298 orgguide.texi:2329 orgguide.texi:2343
#: orgguide.texi:2344 orgguide.texi:2359
#, no-wrap
msgid "ASCII/Latin-1/UTF-8 export"
msgstr "Exportaci@'on ASCII/Latin-1/UTF-8"

#. type: menuentry
#: orgguide.texi:217 orgguide.texi:2298
#, fuzzy
msgid "Exporting to flat files with encoding"
msgstr "Exportando a ficheros planos con codificaci@'on"

#. type: node
#: orgguide.texi:217 orgguide.texi:2298 orgguide.texi:2343 orgguide.texi:2359
#: orgguide.texi:2360 orgguide.texi:2382
#, no-wrap
msgid "HTML export"
msgstr "HTML export"

#. type: menuentry
#: orgguide.texi:217 orgguide.texi:2298
msgid "Exporting to HTML"
msgstr "Exportando a HTML"

#. type: node
#: orgguide.texi:217 orgguide.texi:2298 orgguide.texi:2359 orgguide.texi:2382
#: orgguide.texi:2383 orgguide.texi:2403
#, no-wrap
msgid "@LaTeX{} and PDF export"
msgstr "Exportar @LaTeX{} y PDF"

#. type: menuentry
#: orgguide.texi:217 orgguide.texi:2298
msgid "Exporting to @LaTeX{}, and processing to PDF"
msgstr "Exportando a @LaTeX{}, y procesando a PDF"

#. type: node
#: orgguide.texi:217 orgguide.texi:2298 orgguide.texi:2382 orgguide.texi:2403
#: orgguide.texi:2404 orgguide.texi:2415
#, no-wrap
msgid "DocBook export"
msgstr "Exportar DocBook"

#. type: menuentry
#: orgguide.texi:217 orgguide.texi:2298
msgid "Exporting to DocBook"
msgstr "Exportando a DocBook"

#. type: section
#: orgguide.texi:217 orgguide.texi:2298 orgguide.texi:2403 orgguide.texi:2415
#: orgguide.texi:2416
#, no-wrap
msgid "iCalendar export"
msgstr "Exportar iCalendar"

#. type: node
#: orgguide.texi:223 orgguide.texi:2606 orgguide.texi:2608 orgguide.texi:2609
#: orgguide.texi:2618
#, no-wrap
msgid "Completion"
msgstr "Terminaci@'on"

#. type: menuentry
#: orgguide.texi:223 orgguide.texi:2606
msgid "M-TAB knows what you need"
msgstr "M-TAB sabe qu@'e necesita"

#. type: node
#: orgguide.texi:223 orgguide.texi:2606 orgguide.texi:2608 orgguide.texi:2618
#: orgguide.texi:2662
#, no-wrap
msgid "Clean view"
msgstr "Vista limpia"

#. type: menuentry
#: orgguide.texi:223 orgguide.texi:2606
msgid "Getting rid of leading stars in the outline"
msgstr "Eliminaci@'on de los asteriscos iniciales en el outline"

#. type: section
#: orgguide.texi:223 orgguide.texi:2606 orgguide.texi:2618 orgguide.texi:2662
#: orgguide.texi:2663
#, no-wrap
msgid "MobileOrg"
msgstr "Org m@'ovil"

#. type: menuentry
#: orgguide.texi:223 orgguide.texi:2606
msgid "Org-mode on the iPhone"
msgstr "Org-mode en el iPhone"

#. type: Plain text
#: orgguide.texi:243
msgid ""
"Org is a mode for keeping notes, maintaining TODO lists, and doing project "
"planning with a fast and effective plain-text system.  It is also an "
"authoring and publishing system."
msgstr ""
"Org es un modo para guardar notas, manteniendo listas TODO (por\n"
"hacer), y haciendo planes de proyectos con un r@'apido y efectivo\n"
"sistema de texto plano. Es adem@'as un sistema de publicaci@'on y\n"
"autor@'{@dotless{i}}a."

#. type: i{#1}
#: orgguide.texi:249
#, fuzzy
msgid ""
"This document is a much compressed derivative of the @uref{http://orgmode."
"org/index.html#sec-4_1, comprehensive Org-mode manual}.  It contains all "
"basic features and commands, along with important hints for customization.  "
"It is intended for beginners who would shy back from a 200 page manual "
"because of sheer size."
msgstr ""
"Este documento es un resumen derivado del\n"
"@uref{http://orgmode.org/index.html#sec-4-1, manual completo de\n"
"Org-mode}. Contiene todas las funcionalidades b@'asicas y comandos,\n"
"junto con importantes detalles de personalizaci@'on. Se recomienda\n"
"para principiantes que se asustan con manuales de 200 p@'aginas por su\n"
"puro tama@~no."

#. type: Plain text
#: orgguide.texi:256
msgid ""
"@b{Important:} @i{If you are using a version of Org that is part of the "
"Emacs distribution or an XEmacs package, please skip this section and go "
"directly to @ref{Activation}.}"
msgstr ""
"@b{Importante:} @i{Si se usa una versi@'on de Org que es parte de una\n"
"distribuci@'on de Emacs o un paquete de XEmacs, por favor s@'altese\n"
"esta secci@'on y vaya directamente a @ref{Activaci@'on}.}"

#. type: Plain text
#: orgguide.texi:261
msgid ""
"If you have downloaded Org from the Web, either as a distribution @file{."
"zip} or @file{.tar} file, or as a Git archive, it is best to run it directly "
"from the distribution directory.  You need to add the @file{lisp} "
"subdirectories to the Emacs load path.  To do this, add the following line "
"to @file{.emacs}:"
msgstr ""
"Si se ha descargado Org de la web, como distribuci@'on de ficheros\n"
"bien @file{.zip}, o bien @file{.tar}, o como un archivo Git, es\n"
"preferible ejecutarlo directamente desde el directorio de la\n"
"distribuci@'on. Necesitar@'a a@~nadir los subdirectorios @file{lisp}\n"
"al camino de carga de Emacs. Para hacer esto, a@~nada la siguiente\n"
"l@'{@dotless{i}}nea al archivo @file{.emacs}:"

#. type: smallexample
#: orgguide.texi:265
#, fuzzy, no-wrap
msgid ""
"(setq load-path (cons \"~/path/to/orgdir/lisp\" load-path))\n"
"(setq load-path (cons \"~/path/to/orgdir/contrib/lisp\" load-path))\n"
msgstr ""
"(setq load-path (cons \"~/camino/a/orgdir/lisp\" load-path))\n"
"(setq load-path (cons \"~/camino/a/orgdir/contrib/lisp\" load-path)"

#. type: Plain text
#: orgguide.texi:269
msgid "command:"
msgstr "comando:"

#. type: smallexample
#: orgguide.texi:272
#, no-wrap
msgid "make\n"
msgstr "make"

#. type: Plain text
#: orgguide.texi:280
msgid ""
"Add the following lines to your @file{.emacs} file.  The last three lines "
"define @emph{global} keys for some commands --- please choose suitable keys "
"yourself."
msgstr ""
"A@~nada las siguientes l@'{@dotless{i}}neas a su archivo\n"
"@file{.emacs}. Las @'ultimas tres l@'{@dotless{i}}neas definen las\n"
"claves @emph{global} de algunos comandos ---por favor, elija claves\n"
"apropiadas por s@'{@dotless{i}} mismo."

#. type: smalllisp
#: orgguide.texi:288
#, fuzzy, no-wrap
msgid ""
";; The following lines are always needed.  Choose your own keys.\n"
"(add-to-list 'auto-mode-alist '(\"\\\\.org\\\\'\" . org-mode)) ; not needed since Emacs 22.2\n"
"(add-hook 'org-mode-hook 'turn-on-font-lock) ; not needed when global-font-lock-mode is on\n"
"(global-set-key \"\\C-cl\" 'org-store-link)\n"
"(global-set-key \"\\C-ca\" 'org-agenda)\n"
"(global-set-key \"\\C-cb\" 'org-iswitchb)\n"
msgstr ""
";; Las siguientes l@'{@dotless{i}}neas son siempre necesarias.\n"
";; Elija sus propias claves.\n"
"(add-to-list 'auto-mode-alist '(\".org'\" . org-mode))\n"
"(add-hook 'org-mode-hook 'turn-on-font-lock)\n"
";; no es necesario cuando global-font-lock-mode est@'a activado\n"
"(global-set-key \"\\C-cl\" 'org-store-link)\n"
"(global-set-key \"\\C-ca\" 'org-agenda)\n"
"(global-set-key \"\\C-cb\" 'org-iswitchb)\n"

#. type: Plain text
#: orgguide.texi:292
msgid ""
"With this setup, all files with extension @samp{.org} will be put into Org "
"mode."
msgstr ""
"Con esta configuraci@'on, todos los archivos con extensi@'on\n"
"@samp{.org} ser@'an tratados en modo Org."

#. type: Plain text
#: orgguide.texi:299
msgid ""
"If you find problems with Org, or if you have questions, remarks, or ideas "
"about it, please mail to the Org mailing list @email{emacs-orgmode@@gnu."
"org}.  For information on how to submit bug reports, see the main manual."
msgstr ""
"Si encuentra problemas con Org, o si tiene preguntas, comentarios, u\n"
"otras ideas acerca de @'el, por favor envie un correo a la lista de\n"
"Org @email{emacs-orgmode@@gnu.org}. Para m@'as informaci@'on de c@'omo\n"
"enviar informes de error, lea el manual principal."

#. type: Plain text
#: orgguide.texi:305
msgid ""
"Org is based on Outline mode and provides flexible commands to edit the "
"structure of the document."
msgstr ""
"Org est@'a basado en el modo Outline y suministra flexibles comandos\n"
"para editar la estructura de un documento."

#. type: Plain text
#: orgguide.texi:328
msgid ""
"Org is implemented on top of Outline mode.  Outlines allow a document to be "
"organized in a hierarchical structure, which (at least for me) is the best "
"representation of notes and thoughts.  An overview of this structure is "
"achieved by folding (hiding) large parts of the document to show only the "
"general document structure and the parts currently being worked on.  Org "
"greatly simplifies the use of outlines by compressing the entire show/hide "
"functionality into a single command, @command{org-cycle}, which is bound to "
"the @key{TAB} key."
msgstr ""
"Org est@'a implementado en lo alto del modo outline. Los outlines\n"
"(@'{@dotless{i}}tems de contenido) permiten a un documento estar\n"
"organizado en una estructura jer@'arquica, lo cual (al menos para\n"
"m@'{@dotless{i}}) es la mejor forma para representar notas y\n"
"pensamientos. Una visi@'on preliminar de esta estructura es lograda al\n"
"encoger (ocultando) grandes partes del documento y mostrar s@'olo la\n"
"estructura general del documento y las partes en las que se est@'a\n"
"trabajando. Org simplifica enormemente el uso de outlines para\n"
"comprender la funcionalidad completa de mostrar/ocultar en un simple\n"
"comando, @command{org-cycle}, el cual est@'a asignado a la tecla\n"
"@key{TAB}."

#. type: Plain text
#: orgguide.texi:336
msgid ""
"Headlines define the structure of an outline tree.  The headlines in Org "
"start with one or more stars, on the left margin@footnote{See the variable "
"@code{org-special-ctrl-a/e} to configure special behavior of @kbd{C-a} and "
"@kbd{C-e} in headlines.}.  For example:"
msgstr ""
"Los cabeceras@footnote{Nota del Traductor. Headlines es traducido por\n"
"cabecera y hace referencia a t@'{@dotless{i}}tulos y subt@'{@dotless{i}}"
"tulos}\n"
"definen la estructura del @'arbol de sangrado (@'{@dotless{i}}tems de\n"
"contenido). Los t@'{@dotless{i}}tulos y subt@'{@dotless{i}}tulos en\n"
"Org comienzan con uno o m@'as asteriscos, en el margen\n"
"izquierdo@footnote{Vea la variable @code{org-special-crtl-a/e} para\n"
"configurar el comportamiento de @kbd{C-a} y @kbd{C-e} en los\n"
"t@'{@dotless{i}}tulos.}. Por ejemplo:"

#. type: smallexample
#: orgguide.texi:344
#, fuzzy, no-wrap
msgid ""
"* Top level headline\n"
"** Second level\n"
"*** 3rd level\n"
"    some text\n"
"*** 3rd level\n"
"    more text\n"
"\n"
msgstr ""
"* Cabecera de nivel superior\n"
"** Segundo nivel\n"
"*** Tercer nivel\n"
"    cualquier texto\n"
"*** Tercer nivel\n"
"    m@'as texto\n"
"\n"

#. type: smallexample
#: orgguide.texi:346
#, fuzzy, no-wrap
msgid "* Another top level headline\n"
msgstr "* Otro t@'{@dotless{i}}tulo de nivel superior\n"

#. type: Plain text
#: orgguide.texi:351
#, fuzzy
msgid ""
"outline that has whitespace followed by a single star as headline starters.  "
"@ref{Clean view}, describes a setup to realize this."
msgstr ""
"El outline que tiene un espacio en blanco seguido por un asterisco es\n"
"el comienzo de un subt@'{@dotless{i}}tulo o headline. @ref{Vista\n"
"limpia}, describe una configuraci@'on para realizar esto."

#. type: Plain text
#: orgguide.texi:358
msgid ""
"Outlines make it possible to hide parts of the text in the buffer.  Org uses "
"just two commands, bound to @key{TAB} and @kbd{S-@key{TAB}} to change the "
"visibility in the buffer."
msgstr ""
"Los outlines hacen posible ocultar partes del texto en el buffer. Org\n"
"usa solo dos comandos, asignados a @key{TAB} y @kbd{S-@key{TAB}}, para\n"
"cambiar la visibilidad en el buffer."

#. type: key{#1}
#: orgguide.texi:360 orgguide.texi:511 orgguide.texi:636 orgguide.texi:1906
#, no-wrap
msgid "TAB"
msgstr "TAB"

#. type: table
#: orgguide.texi:362
#, fuzzy
msgid "@emph{Subtree cycling}: Rotate current subtree among the states"
msgstr ""
"@emph{Sub@'arbol c@'{@dotless{i}}clico}: Rotaci@'on en el sub@'arbol\n"
"entre los estados"

#. type: smallexample
#: orgguide.texi:366
#, fuzzy, no-wrap
msgid ""
",-> FOLDED -> CHILDREN -> SUBTREE --.\n"
"'-----------------------------------'\n"
msgstr ""
",-> ENCOGIDO -> HIJO -> SUB@'ARBOL --.\n"
"'------------------------------------'"

#. type: table
#: orgguide.texi:370
msgid ""
"When called with a prefix argument (@kbd{C-u @key{TAB}}) or with the shift "
"key, global cycling is invoked."
msgstr ""
"Cuando es llamado con el argumento prefijo (@kbd{C-u @key{TAB}}) o con\n"
"la tecla de desplazamiento (@kbd{Shift}), es invocado el ciclo global."

#. type: item
#: orgguide.texi:371
#, no-wrap
msgid "S-@key{TAB} @r{and} C-u @key{TAB}"
msgstr "S-@key{TAB} @r{y} C-u @key{TAB}"

#. type: table
#: orgguide.texi:373
#, fuzzy
msgid "@emph{Global cycling}: Rotate the entire buffer among the states"
msgstr "@emph{Ciclo global}: Rotar el buffer entero entre los estados"

#. type: smallexample
#: orgguide.texi:377
#, fuzzy, no-wrap
msgid ""
",-> OVERVIEW -> CONTENTS -> SHOW ALL --.\n"
"'--------------------------------------'\n"
msgstr ""
",-> RESUMEN -> CONTENIDO -> MOSTRAR TODO --.\n"
"'------------------------------------------'"

#. type: item
#: orgguide.texi:379
#, no-wrap
msgid "C-u C-u C-u @key{TAB}"
msgstr "C-u C-u C-u @key{TAB}"

#. type: table
#: orgguide.texi:381
msgid "Show all, including drawers."
msgstr "Mostrar todo, incluidos los calzoncillos"

#. type: Plain text
#: orgguide.texi:388
msgid ""
"When Emacs first visits an Org file, the global state is set to OVERVIEW, i."
"e.@: only the top level headlines are visible.  This can be configured "
"through the variable @code{org-startup-folded}, or on a per-file basis by "
"adding a startup keyword @code{overview}, @code{content}, @code{showall}, "
"like this:"
msgstr ""
"Cuando Emacs abre por primera vez un archivo Org, pone el estado\n"
"global a RESUMEN (OVERVIEW) p.e.@: s@'olo las cabeceras de nivel\n"
"superior son visibles. Esto puede ser configurado a trav@'es de la\n"
"variable @code{org-startup-folded}, o v@'{@dotless{i}}a fichero\n"
"a@~nadiendo una palabra reservada @code{overview}, @code{content},\n"
"@code{showall}, como esta:"

#. type: smallexample
#: orgguide.texi:391
#, no-wrap
msgid "#+STARTUP: content\n"
msgstr "#+STARTUP: content\n"

#. type: Plain text
#: orgguide.texi:397
msgid "The following commands jump to other headlines in the buffer."
msgstr "El siguiente comando salta a la siguiente cabecera en el buffer."

#. type: item
#: orgguide.texi:399
#, no-wrap
msgid "C-c C-n"
msgstr "C-c C-n"

#. type: table
#: orgguide.texi:401
msgid "Next heading."
msgstr "Siguiente cabecera."

#. type: item
#: orgguide.texi:401
#, no-wrap
msgid "C-c C-p"
msgstr "C-c C-p"

#. type: table
#: orgguide.texi:403
msgid "Previous heading."
msgstr "Cabecera previa."

#. type: item
#: orgguide.texi:403
#, no-wrap
msgid "C-c C-f"
msgstr "C-c C-f"

#. type: table
#: orgguide.texi:405
msgid "Next heading same level."
msgstr "Siguiente cabecera del mismo nivel."

#. type: item
#: orgguide.texi:405
#, no-wrap
msgid "C-c C-b"
msgstr "C-c C-b"

#. type: table
#: orgguide.texi:407
msgid "Previous heading same level."
msgstr "Cabecera previa del mismo nivel."

#. type: item
#: orgguide.texi:407
#, no-wrap
msgid "C-c C-u"
msgstr "C-c C-u"

#. type: table
#: orgguide.texi:409
msgid "Backward to higher level heading."
msgstr "Retroceder a la cabecera de nivel superior."

#. type: item
#: orgguide.texi:415 orgguide.texi:513
#, no-wrap
msgid "M-@key{RET}"
msgstr "M-@key{RET}"

#. type: table
#: orgguide.texi:421
msgid ""
"Insert new heading with same level as current.  If the cursor is in a plain "
"list item, a new item is created (@pxref{Plain lists}).  When this command "
"is used in the middle of a line, the line is split and the rest of the line "
"becomes the new headline@footnote{If you do not want the line to be split, "
"customize the variable @code{org-M-RET-may-split-line}.}."
msgstr ""
"Inserta una nueva cabecera al mismo nivel que la actual. Si el cursor\n"
"est@'a en un item de una lista plana, un nuevo item es creado\n"
"(@pxref{Listas planas}). Cuando este comando es usado en medio de una\n"
"l@'{@dotless{i}}nea, la l@'{@dotless{i}}nea es partida y el resto de\n"
"la l@'{@dotless{i}}nea ser@'a una nueva cabecera@footnote{Si no desea\n"
"que la l@'{@dotless{i}}nea sea partida, personalice la variable\n"
"@code{org-M-RET-may-split-line}.}."

#. type: item
#: orgguide.texi:421 orgguide.texi:516 orgguide.texi:1087
#, no-wrap
msgid "M-S-@key{RET}"
msgstr "M-S-@key{RET}"

#. type: table
#: orgguide.texi:423
msgid "Insert new TODO entry with same level as current heading."
msgstr ""
"Inserta una nueva entrada TODO con el mismo nivel de la cabecera actual."

#. type: item
#: orgguide.texi:423
#, no-wrap
msgid "@key{TAB} @r{in new, empty entry}"
msgstr "@key{TAB} @r{en nueva, entrada vacia}"

#. type: table
#: orgguide.texi:426
msgid ""
"In a new entry with no text yet, @key{TAB} will cycle through reasonable "
"levels."
msgstr ""
"En una nueva entrada sin texto a@'un, @key{TAB} rotar@'a\n"
"c@'{@dotless{i}}clicamente a trav@'es de niveles similares."

#. type: item
#: orgguide.texi:426
#, no-wrap
msgid "M-@key{left}@r{/}@key{right}"
msgstr "M-@key{left}@r{/}@key{right}"

#. type: table
#: orgguide.texi:428
msgid "Promote/demote current heading by one level."
msgstr "Promociona/devalua la cabecera actual en un nivel."

#. type: item
#: orgguide.texi:428 orgguide.texi:524
#, no-wrap
msgid "M-S-@key{left}@r{/}@key{right}"
msgstr "M-S-@key{left}@r{/}@key{right}"

#. type: table
#: orgguide.texi:430
msgid "Promote/demote the current subtree by one level."
msgstr "Promociona/devalua el subarbol actual en un nivel."

#. type: item
#: orgguide.texi:430 orgguide.texi:518
#, no-wrap
msgid "M-S-@key{up}@r{/}@key{down}"
msgstr "M-S-@key{up}@r{/}@key{down}"

#. type: table
#: orgguide.texi:433
msgid "Move subtree up/down (swap with previous/next subtree of same level)."
msgstr ""
"Mueve el subarbol arriba/abajo (intercambia entre anterior/siguiente\n"
"subarbol del mismo nivel)."

#. type: item
#: orgguide.texi:433 orgguide.texi:1569 orgguide.texi:1630 orgguide.texi:1966
#, no-wrap
msgid "C-c C-w"
msgstr "C-c C-w"

#. type: table
#: orgguide.texi:435
#, fuzzy
msgid ""
"Refile entry or region to a different location.  @xref{Refile and copy}."
msgstr ""
"Mueve la entrada o regi@'on en una lozalizaci@'on\n"
"diferente. @xref{Moviendo notas}."

#. type: item
#: orgguide.texi:435
#, no-wrap
msgid "C-x n s/w"
msgstr "C-x n s/w"

#. type: table
#: orgguide.texi:437
msgid "Narrow buffer to current subtree / widen it again"
msgstr "Limitar la memoria intermedia al @'arbol actual / ocult@'andolo"

#. type: Plain text
#: orgguide.texi:441
msgid ""
"When there is an active region (Transient Mark mode), promotion and demotion "
"work on all headlines in the region."
msgstr ""
"Cuando esto es en una regi@'on activa (Transient Mark mode), promueve\n"
"y devalua todas las cabeceras en la regi@'on."

#. type: Plain text
#: orgguide.texi:453
msgid ""
"An important feature of Org mode is the ability to construct @emph{sparse "
"trees} for selected information in an outline tree, so that the entire "
"document is folded as much as possible, but the selected information is made "
"visible along with the headline structure above it@footnote{See also the "
"variables @code{org-show-hierarchy-above}, @code{org-show-following-"
"heading}, @code{org-show-siblings}, and @code{org-show-entry-below} for "
"detailed control on how much context is shown around each match.}.  Just try "
"it out and you will see immediately how it works."
msgstr ""
"Una importante caracter@'{@dotless{i}}stica de Org-mode es su\n"
"posibilidad para construir @emph{@'arboles poco densos} para la\n"
"informaci@'on seleccionada en un arbol de outline, as@'{@dotless{i}}\n"
"que el documento entero es manejado como es posible, pero la\n"
"informaci@'on seleccionada es hecha visible con la estructura de\n"
"cabaceras de encima@footnote{Vea adem@'as las variables\n"
"@code{org-show-hierarchy-above}, @code{org-show-following-heading},\n"
"@code{org-show-siblings} y @code{org-show-entry-below} para controlar\n"
"los detalles de c@'omo el contexto se muestra en cada\n"
"coincidencia.}. Int@'entelo ahora y ver@'a inmediatamente como\n"
"funciona."

#. type: Plain text
#: orgguide.texi:456
msgid ""
"Org mode contains several commands creating such trees, all these commands "
"can be accessed through a dispatcher:"
msgstr ""
"Org-mode contiene varios comandos para crear @'arboles, todos estos\n"
"comandos pueden ser accedidos a trav@'es del despachador:"

#. type: item
#: orgguide.texi:458
#, no-wrap
msgid "C-c /"
msgstr "C-c /"

#. type: table
#: orgguide.texi:460
msgid "This prompts for an extra key to select a sparse-tree creating command."
msgstr ""
"Este prompt es una clave especial para seleccionar un comando de\n"
"creaci@'on de un @'arbol poco denso."

#. type: item
#: orgguide.texi:460
#, no-wrap
msgid "C-c / r"
msgstr "C-c / r"

#. type: table
#: orgguide.texi:463
#, fuzzy
msgid ""
"Occur.  Prompts for a regexp and shows a sparse tree with all matches.  Each "
"match is also highlighted; the highlights disappear by pressing @kbd{C-c C-"
"c}."
msgstr ""
"Ocurrencia. Prompt para una expresi@'on regular y muestra un @'arbol\n"
"poco denso con todas sus coincidencias. Cada coincidencia ser@'a\n"
"sobresaltada; El sobresaltado desaparecer@'a presionando @kbd{C-c\n"
"C-c}."

#. type: Plain text
#: orgguide.texi:467
msgid ""
"The other sparse tree commands select headings based on TODO keywords, tags, "
"or properties and will be discussed later in this manual."
msgstr ""
"Otros comandos de @'arbol poco denso seleccionan las cabeceras basadas\n"
"en la palabra reservada TODO, etiquetas o propiedades y ser@'an discutidos\n"
"posteriormente en este manual."

#. type: Plain text
#: orgguide.texi:475
msgid ""
"Within an entry of the outline tree, hand-formatted lists can provide "
"additional structure.  They also provide a way to create lists of checkboxes "
"(@pxref{Checkboxes}).  Org supports editing such lists, and the HTML "
"exporter (@pxref{Exporting}) parses and formats them."
msgstr ""
"Sin una entrada en el @'arbol de outline, listas formateadas a mano\n"
"pueden suministrar una estructura adicional. Ello tambi@'en\n"
"proporciona una forma de crear listas de cajas de chequeo\n"
"(@pxref{Cajas de chequeo}). Org soporta la edici@'on de tales listas,\n"
"y el conversor HTML (@pxref{Exportando}) los analiza y formatea."

#. type: Plain text
#: orgguide.texi:477
msgid "Org knows ordered lists, unordered lists, and description lists."
msgstr "Org permite listas ordenadas, desordenadas y describirlas."

#. type: itemize
#: orgguide.texi:481
msgid ""
"@emph{Unordered} list items start with @samp{-}, @samp{+}, or @samp{*} as "
"bullets."
msgstr ""
"@emph{Desordenada} los items de la lista comienzan con @samp{-},\n"
"@samp{+} o @samp{*} como marcas."

#. type: itemize
#: orgguide.texi:483
msgid "@emph{Ordered} list items start with @samp{1.} or @samp{1)}."
msgstr ""
"@emph{Ordenada} los items de la lista comienzan con @samp{1.} o\n"
"@samp{1)}."

#. type: itemize
#: orgguide.texi:486
msgid ""
"@emph{Description} list use @samp{ :: } to separate the @emph{term} from the "
"description."
msgstr ""
"@emph{Descripci@'on} la lista usa @samp{ :: } para separar el\n"
"@emph{t@'ermino} de la descripci@'on."

#. type: Plain text
#: orgguide.texi:492
msgid ""
"Items belonging to the same list must have the same indentation on the first "
"line.  An item ends before the next line that is indented like its bullet/"
"number, or less.  A list ends when all items are closed, or before two blank "
"lines.  An example:"
msgstr ""
"Los items subsiguientes de la misma lista deben tener el mismo\n"
"sangrado en la primera l@'{@dotless{i}}nea. Un item que termine antes\n"
"de la siguiente l@'{@dotless{i}}nea ser@'a sangrado como\n"
"bola/n@'umero, o no. Una lista termina cuando todos los items est@'an\n"
"cerrados, o antes de dos l@'{@dotless{i}}neas en blanco. Un ejemplo:"

#. type: group
#: orgguide.texi:504
#, fuzzy, no-wrap
msgid ""
"** Lord of the Rings\n"
"   My favorite scenes are (in this order)\n"
"   1. The attack of the Rohirrim\n"
"   2. Eowyn's fight with the witch king\n"
"      + this was already my favorite scene in the book\n"
"      + I really like Miranda Otto.\n"
"   Important actors in this film are:\n"
"   - @b{Elijah Wood} :: He plays Frodo\n"
"   - @b{Sean Austin} :: He plays Sam, Frodo's friend.\n"
msgstr ""
"** El se@~nor de los Anillos\n"
"   Mis escenas favoritas son (en este orden)\n"
"   1. El ataque de Rohirrim\n"
"   2. Combate de Eowyn con el rey\n"
"      + Esta es tambi@'en mi escena favorita en el libro\n"
"      + Es realmente como Miranda Otto.\n"
"   Actores importantes es esta pel@'{@dotless{i}}cula:\n"
"   - @b{Elijah Wood} :: En el papel de Frodo\n"
"   - @b{Sean Austin} :: En el papel de Sam, amigo de Frodo."

#. type: Plain text
#: orgguide.texi:509
msgid ""
"The following commands act on items when the cursor is in the first line of "
"an item (the line with the bullet or number)."
msgstr ""
"Los siguientes comandos actuan en items cuando el cursor est@'a en la\n"
"primera l@'{@dotless{i}}mea de un item (la l@'{@dotless{i}}nea con la\n"
"bola o el n@'umero). "

#. type: table
#: orgguide.texi:513
msgid "Items can be folded just like headline levels."
msgstr "Los items pueden ser manejados como cabeceras de niveles."

#. type: table
#: orgguide.texi:516
msgid ""
"Insert new item at current level.  With a prefix argument, force a new "
"heading (@pxref{Structure editing})."
msgstr ""
"Inserta un nuevo item al nivel actual. Con el argumento de prefijo,\n"
"fuerza a una nueva cabecera (@pxref{Edici@'on de estructura})."

#. type: table
#: orgguide.texi:518
msgid "Insert a new item with a checkbox (@pxref{Checkboxes})."
msgstr ""
"Inserta un nuevo item con una caja de chequeo (@pxref{Cajas de chequeo})."

#. type: table
#: orgguide.texi:522
msgid ""
"Move the item including subitems up/down (swap with previous/next item of "
"same indentation).  If the list is ordered, renumbering is automatic."
msgstr ""
"Mueve el item incluyendo los subitems arriba/abajo (intercambia con\n"
"el item previo/siguiente del mismo sangrado. Si la lista es ordenada,\n"
"la renumeraci@'on es autom@'atica."

#. type: item
#: orgguide.texi:522
#, no-wrap
msgid "M-@key{left}@r{/}M-@key{right}"
msgstr "M-@key{left}@r{/}M-@key{right}"

#. type: table
#: orgguide.texi:524
msgid "Decrease/increase the indentation of an item, leaving children alone."
msgstr "Decrementa/incrementa el sangrado del item, dejando los hijos sueltos."

#. type: table
#: orgguide.texi:526
msgid "Decrease/increase the indentation of the item, including subitems."
msgstr "Decrementa/incrementa el sangrado del item. incluyendo los subitems."

#. type: item
#: orgguide.texi:526 orgguide.texi:558 orgguide.texi:633 orgguide.texi:1085
#: orgguide.texi:1160 orgguide.texi:1498 orgguide.texi:1565
#, no-wrap
msgid "C-c C-c"
msgstr "C-c C-c"

#. type: table
#: orgguide.texi:530
msgid ""
"If there is a checkbox (@pxref{Checkboxes}) in the item line, toggle the "
"state of the checkbox.  Also verify bullets and indentation consistency in "
"the whole list."
msgstr ""
"Si es una caja de chequeo (@pxref{Cajas de chequeo}) en una\n"
"l@'{@dotless{i}}nea item, cambia el estado de la caja de\n"
"chequeo. Adem@'as verifica las bolas y el sangrado consistente en la\n"
"lista completa."

#. type: item
#: orgguide.texi:530 orgguide.texi:669
#, no-wrap
msgid "C-c -"
msgstr "C-c -"

#. type: table
#: orgguide.texi:533
msgid ""
"Cycle the entire list level through the different itemize/enumerate bullets "
"(@samp{-}, @samp{+}, @samp{*}, @samp{1.}, @samp{1)})."
msgstr ""
"Rota la lista entera a trav@'es de diferentes bolas de\n"
"numeraci@'on/marcado (@samp{-}, @samp{+}, @samp{*}, @samp{1.},\n"
"@samp{1)})."

#. type: Plain text
#: orgguide.texi:541
msgid ""
"A footnote is defined in a paragraph that is started by a footnote marker in "
"square brackets in column 0, no indentation allowed.  The footnote reference "
"is simply the marker in square brackets, inside text.  For example:"
msgstr ""
"Una Nota al pie es definida como un p@'arrafo que comienza con una\n"
"nota al pie marcada entre corchetes en la columna 0, sin ning@'un\n"
"sangrado. La referencia a la nota al pie es simplemente una marcha de\n"
"corchetes, texto incluido. Por ejemplo:"

#. type: smallexample
#: orgguide.texi:546
#, fuzzy, no-wrap
msgid ""
"The Org homepage[fn:1] now looks a lot better than it used to.\n"
"...\n"
"[fn:1] The link is: http://orgmode.org\n"
msgstr ""
"La p@'agina web de Org[fn:1] ahora parece un poco mejor que cuando la\n"
"usaba.\n"
"...\n"
"[fn:1] El enlace es: http://orgmode.org"

#. type: item
#: orgguide.texi:551
#, no-wrap
msgid "C-c C-x f"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:557
#, fuzzy
msgid ""
"The footnote action command.  When the cursor is on a footnote reference, "
"jump to the definition.  When it is at a definition, jump to the (first)  "
"reference.  Otherwise, create a new footnote.  When this command is called "
"with a prefix argument, a menu of additional options including renumbering "
"is offered."
msgstr ""
"El comando de acci@'on de Nota al pie. Cuando el cursor est@'a en una\n"
"referencia a un nota al pie, salta a su definici@'on. Cuando est@'a en\n"
"la definici@'on, salta a la (primera) referencia. En otro caso, crea\n"
"una nueva nota al pie. Cuando este comando es llamado con un\n"
"arguimento como prefijo, aparecer@'a un men@'u adicional incluyendo\n"
"opciones de renumeraci@'on."

#. type: table
#: orgguide.texi:560
#, fuzzy
msgid "Jump between definition and reference."
msgstr "Salta entre definici@'on y referencia."

#. type: Plain text
#: orgguide.texi:567
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Document-Structure.html#Document-"
"Structure, Chapter 2 of the manual}@* @uref{http://sachachua.com/wp/2008/01/"
"outlining-your-notes-with-org/, Sacha Chua's tutorial}}"
msgstr ""
"@seealso{@uref{http://orgmode.org/manual/Document-Structure.html#Document-"
"Structure,\n"
"Cap@'{@dotless{i}}tulo 2 del manual de Org-mode}@*@uref{http://sachachua.com/"
"wp/2008/01/outlining-your-notes-with-org/,\n"
"Tutorial de Sacha Chua}}"

#. type: Plain text
#: orgguide.texi:575
#, fuzzy
msgid ""
"Org comes with a fast and intuitive table editor.  Spreadsheet-like "
"calculations are supported in connection with the Emacs @file{calc} package"
msgstr ""
"Org viene con un r@'apido e intuitivo editor de tablas. C@'alculos\n"
"similares a los de una hoja de c@'alculo son soportados en conexi@'on\n"
"con el paquete Emacs @file{calc}"

#. type: ifinfo
#: orgguide.texi:577
msgid "(@pxref{Top,Calc,,Calc,Gnu Emacs Calculator Manual})."
msgstr "(@pxref{Top,Calc,,Calc,Gnu Emacs Calculator Manual})."

#. type: ifnotinfo
#: orgguide.texi:581
msgid ""
"(see the Emacs Calculator manual for more information about the Emacs "
"calculator)."
msgstr ""
"(vea el manual de Emacs Calculator para m@'as informaci@'on sobre la\n"
"calculadora de Emacs)."

#. type: Plain text
#: orgguide.texi:587
msgid ""
"Org makes it easy to format tables in plain ASCII.  Any line with @samp{|} "
"as the first non-whitespace character is considered part of a table.  @samp"
"{|} is also the column separator.  A table might look like this:"
msgstr ""
"Org hace f@'acil formatear tablas en ASCII plano. Cualquier\n"
"l@'{@dotless{i}}nea con @samp{|} como primer car@'acter no-espacio es\n"
"considerado parte de una tabla. @samp{|} es adem@'as el separador de\n"
"columnas. Una tabla puede parecer algo as@'{@dotless{i}}:"

#. type: smallexample
#: orgguide.texi:593
#, fuzzy, no-wrap
msgid ""
"| Name  | Phone | Age |\n"
"|-------+-------+-----|\n"
"| Peter |  1234 |  17 |\n"
"| Anna  |  4321 |  25 |\n"
msgstr ""
"| Nombre  | Tel@'efono | Edad |\n"
"|---------+----------+------|\n"
"| Pedro   | 12345678 |  17  |\n"
"| Ana     | 87654321 |  25  |\n"

#. type: Plain text
#: orgguide.texi:603
msgid ""
"A table is re-aligned automatically each time you press @key{TAB} or @key"
"{RET} or @kbd{C-c C-c} inside the table.  @key{TAB} also moves to the next "
"field (@key{RET} to the next row) and creates new table rows at the end of "
"the table or before horizontal lines.  The indentation of the table is set "
"by the first line.  Any line starting with @samp{|-} is considered as a "
"horizontal separator line and will be expanded on the next re-align to span "
"the whole table width.  So, to create the above table, you would only type"
msgstr ""
"Una tabla es realineada autom@'aticamente cada vez que se presione\n"
"@key{TAB} o @key{RET} o @kbd{C-c C-c} dentro de la tabla. @key{TAB}\n"
"adem@'as mueve al siguiente campo (@key{RET} a la siguiente fila) y\n"
"crea una nueva tabla de filas al final de la tabla o antes de las\n"
"l@'{@dotless{i}}neas horizontales. El sangrado de la tabla es puesto\n"
"por la primera l@'{@dotless{i}}nea. Cualquier l@'{@dotless{i}}nea\n"
"comenzando con @samp{|-} es considerada como un separador horizontal\n"
"de l@'{@dotless{i}}nea y ser@'a expandido en la siguiente\n"
"realineaci@'on para expandirse al ancho completo de la\n"
"tabla. As@'{@dotless{i}}, para crear una tabla dentro, debe s@'olo\n"
"introducir "

#. type: smallexample
#: orgguide.texi:607
#, no-wrap
msgid ""
"|Name|Phone|Age|\n"
"|-\n"
msgstr ""
"|Nombre|Tel@'efono|Edad|\n"
"|-\n"

#. type: Plain text
#: orgguide.texi:612
#, fuzzy
msgid ""
"fields.  Even faster would be to type @code{|Name|Phone|Age} followed by @kbd"
"{C-c @key{RET}}."
msgstr ""
"entonces presione @key{TAB} para alinear la tabla y comenzar a\n"
"introducir datos. M@'as r@'apido debe ser introducir\n"
"@code{|Nombre|Tel@'efono|Edad} seguido de @kbd{C-c @key{RET}}."

#. type: Plain text
#: orgguide.texi:619
msgid ""
"When typing text into a field, Org treats @key{DEL}, @key{Backspace}, and "
"all character keys in a special way, so that inserting and deleting avoids "
"shifting other fields.  Also, when typing @emph{immediately after the cursor "
"was moved into a new field with @kbd{@key{TAB}}, @kbd{S-@key{TAB}} or @kbd"
"{@key{RET}}}, the field is automatically made blank."
msgstr ""
"Cuando se introduce texto en un campo, Org trata @key{DEL},\n"
"@key{Backspace} y todas las teclas de forma especial, para que la\n"
"inserci@'on y el borrado eviten desplazarse a otros campos. Por tanto,\n"
"cuando se introduce @emph{inmediatamente despu@'es de que el cursor se\n"
"haya movido dentro de un nuevo campo con @kbd{@key{TAB}},\n"
"@kbd{S-@key{TAB}} o @kbd{@key{RET}}}, el campo es autom@'aticamente\n"
"puesto en blanco."

#. type: table
#: orgguide.texi:622
msgid "@tsubheading{Creation and conversion}"
msgstr "@tsubheading{Creaci@'on y conversi@'on}"

#. type: item
#: orgguide.texi:622
#, no-wrap
msgid "C-c |"
msgstr "C-c |"

#. type: table
#: orgguide.texi:631
#, fuzzy
msgid ""
"Convert the active region to table.  If every line contains at least one TAB "
"character, the function assumes that the material is tab separated.  If "
"every line contains a comma, comma-separated values (CSV) are assumed.  If "
"not, lines are split at whitespace into fields.  @* If there is no active "
"region, this command creates an empty Org table.  But it's easier just to "
"start typing, like @kbd{|Name|Phone|Age C-c @key{RET}}."
msgstr ""
"Convierte la regi@'on activa en tabla. Si cada l@'{@dotless{i}}nea\n"
"contiene al menos un car@'acter TAB, la funci@'on asume que la\n"
"informaci@'on est@'a separada por tabuladores. Si cada\n"
"l@'{@dotless{i}}nea contiene una coma, se asumen valores separados por\n"
"coma (CSV). Si no, las l@'{@dotless{i}}neas son partidas en campos por\n"
"los espacios. @* Si no hay regi@'on activa, este comando crea una\n"
"tabla Org vacia. Pero es f@'acil justo ahora comenzar a introducir\n"
"algo como @kbd{|Nombre|Tel@'efono|Edad C-c @key{RET}}."

#. type: table
#: orgguide.texi:633
msgid "@tsubheading{Re-aligning and field motion}"
msgstr "@tsubheading{Realineaci@'on y movimiento}"

#. type: table
#: orgguide.texi:636
msgid "Re-align the table without moving the cursor."
msgstr "Realinea la tabla sin mover el cursor."

#. type: table
#: orgguide.texi:640
msgid ""
"Re-align the table, move to the next field.  Creates a new row if necessary."
msgstr ""
"Realinea la tabla, se mueve al siguiente campo. Crea una nueva fila si\n"
"es necesario."

#. type: item
#: orgguide.texi:640
#, no-wrap
msgid "S-@key{TAB}"
msgstr "S-@key{TAB}"

#. type: table
#: orgguide.texi:643
msgid "Re-align, move to previous field."
msgstr "Realinea, moverse al campo anterior."

#. type: key{#1}
#: orgguide.texi:643 orgguide.texi:1910
#, no-wrap
msgid "RET"
msgstr "RET"

#. type: table
#: orgguide.texi:646
msgid ""
"Re-align the table and move down to next row.  Creates a new row if "
"necessary."
msgstr ""
"Realinea la tabla y se mueve abajo a la siguiente fila. Crea una nueva\n"
"fila si es necesario."

#. type: table
#: orgguide.texi:648
msgid "@tsubheading{Column and row editing}"
msgstr "@tsubheading{Edici@'on de filas y columnas}"

#. type: item
#: orgguide.texi:648
#, no-wrap
msgid "M-@key{left}"
msgstr "M-@key{left}"

#. type: itemx
#: orgguide.texi:649
#, no-wrap
msgid "M-@key{right}"
msgstr "M-@key{right}"

#. type: table
#: orgguide.texi:652
msgid "Move the current column left/right."
msgstr "Mueve el cursor a la columna izquierda/derecha."

#. type: item
#: orgguide.texi:652
#, no-wrap
msgid "M-S-@key{left}"
msgstr "M-S-@key{left}"

#. type: table
#: orgguide.texi:655
msgid "Kill the current column."
msgstr "Elimina la columna actual."

#. type: item
#: orgguide.texi:655
#, no-wrap
msgid "M-S-@key{right}"
msgstr "M-S-@key{right}"

#. type: table
#: orgguide.texi:658
msgid "Insert a new column to the left of the cursor position."
msgstr "Inserta una nueva columna a la izquierda de la posici@'on del cursor."

#. type: item
#: orgguide.texi:658
#, no-wrap
msgid "M-@key{up}"
msgstr "M-@key{up}"

#. type: itemx
#: orgguide.texi:659
#, no-wrap
msgid "M-@key{down}"
msgstr "M-@key{down}"

#. type: table
#: orgguide.texi:662
msgid "Move the current row up/down."
msgstr "Mueve la actual fila arriba/abajo."

#. type: item
#: orgguide.texi:662
#, no-wrap
msgid "M-S-@key{up}"
msgstr "M-S-@key{up}"

#. type: table
#: orgguide.texi:665
msgid "Kill the current row or horizontal line."
msgstr "Elimina la fila o l@'{@dotless{i}}nea horizontal actual."

#. type: item
#: orgguide.texi:665
#, no-wrap
msgid "M-S-@key{down}"
msgstr "M-S-@key{down}"

#. type: table
#: orgguide.texi:669
msgid ""
"Insert a new row above the current row.  With a prefix argument, the line is "
"created below the current one."
msgstr ""
"Inserta una nueva fila sobre la fila actual. Con prefijo argumento, la\n"
"l@'{@dotless{i}}nea es creada debajo de la actual."

#. type: table
#: orgguide.texi:673
msgid ""
"Insert a horizontal line below current row.  With a prefix argument, the "
"line is created above the current line."
msgstr ""
"Inserta una l@'{@dotless{i}}nea horizontal bajo la fila actual. Con\n"
"prefijo argumento, la l@'{@dotless{i}}nea es creada sobre la\n"
"l@'{@dotless{i}}nea actual."

#. type: item
#: orgguide.texi:673
#, no-wrap
msgid "C-c @key{RET}"
msgstr "C-c @key{RET}"

#. type: table
#: orgguide.texi:677
msgid ""
"Insert a horizontal line below current row, and move the cursor into the row "
"below that line."
msgstr ""
"Inserta una l@'{@dotless{i}}nea horizontal bajo la fila actual, y\n"
"mueve el cursor a la fila bajo la l@'{@dotless{i}}nea."

#. type: item
#: orgguide.texi:677
#, no-wrap
msgid "C-c ^"
msgstr "C-c ^"

#. type: table
#: orgguide.texi:681
msgid ""
"Sort the table lines in the region.  The position of point indicates the "
"column to be used for sorting, and the range of lines is the range between "
"the nearest horizontal separator lines, or the entire table."
msgstr ""
"Ordena las l@'{@dotless{i}}neas de una tabla en una regi@'on. La\n"
"posici@'on del punto indica la columna usada para la ordenaci@'on, y\n"
"el rango de l@'{@dotless{i}}neas es el rango entre el separador de\n"
"l@'{@dotless{i}}neas m@'as pr@'oximo, o la tabla completa."

#. type: Plain text
#: orgguide.texi:692
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Tables.html#Tables, Chapter 3 of "
"the manual}@* @uref{http://orgmode.org/worg/org-tutorials/tables.php, "
"Bastien's table tutorial}@* @uref{http://orgmode.org/worg/org-tutorials/org-"
"spreadsheet-intro.php, Bastien's spreadsheet tutorial}@* @uref{http://"
"orgmode.org/worg/org-tutorials/org-plot.php, Eric's plotting tutorial}}"
msgstr ""
"@seealso{ @uref{http://orgmode.org/manual/Tables.html#Tables,\n"
"Cap@'{@dotless{i}}tulo 3 del manual de Org }@*\n"
"@uref{http://orgmode.org/worg/org-tutorials/tables.php, Tutorial de\n"
"tablas de Bastien}@*\n"
"@uref{http://orgmode.org/worg/org-tutorials/org-spreadsheet-intro.php,\n"
"Tutorial de hojas de c@'alculo de Bastien}@*\n"
"@uref{http://orgmode.org/worg/org-tutorials/org-plot.php, Tutorial de\n"
"gr@'aficos de Eric}}"

#. type: Plain text
#: orgguide.texi:698
msgid ""
"Like HTML, Org provides links inside a file, external links to other files, "
"Usenet articles, emails, and much more."
msgstr ""
"Al igual que HTML, Org permite enlaces dentro de archivos, enlaces\n"
"externos a otros archivos, art@'{@dotless{i}}culos de Usenet, correos\n"
"electr@'onicos y mucho m@'as."

#. type: Plain text
#: orgguide.texi:712
msgid ""
"Org will recognize plain URL-like links and activate them as clickable "
"links.  The general link format, however, looks like this:"
msgstr ""
"Org reconocer@'a enlaces de texto tipo URL y los activar@'a como\n"
"enlaces en los que se puede hacer click. El formato de enlace general,\n"
"sin embargo, se ve de la siguiente manera:"

#. type: smallexample
#: orgguide.texi:715
#, fuzzy, no-wrap
msgid "[[link][description]]       @r{or alternatively}           [[link]]\n"
msgstr "[[enlace][descripcion]]   @r{o de manera alternativa}    [[enlace]]\n"

#. type: Plain text
#: orgguide.texi:723
#, fuzzy
msgid ""
"Once a link in the buffer is complete (all brackets present), Org will "
"change the display so that @samp{description} is displayed instead of @samp"
"{[[link][description]]} and @samp{link} is displayed instead of @samp"
"{[[link]]}.  To edit the invisible @samp{link} part, use @kbd{C-c C-l} with "
"the cursor on the link."
msgstr ""
"Una vez que un enlace en el buffer est@'a completo (con todos los\n"
"corchetes presentes), Org cambiar@'a la vista de tal manera que la\n"
"@samp{descripci@'on} se mostrar@'a en vez de\n"
"@samp{[[enlace][descripci@'on]]} y @samp{enlace} ser@'a mostrado en\n"
"vez de @samp{[[enlace]]}. Para editar la parte invisible de\n"
"@samp{enlace}, use @kbd{C-c C-l} con el cursor en el enlace."

#. type: Plain text
#: orgguide.texi:731
msgid ""
"If the link does not look like a URL, it is considered to be internal in the "
"current file.  The most important case is a link like @samp{[[#my-custom-"
"id]]} which will link to the entry with the @code{CUSTOM_ID} property @samp"
"{my-custom-id}."
msgstr ""
"Si el enlace no parece una URL, puede ser debido a que es un enlace\n"
"interno en el fichero actual. El caso m@'as importante en un enlace\n"
"como @samp{[[#mi-id-personal]]} que enlazar@'a a la entrada con la\n"
"propiedad @code{CUSTOM_ID} como @samp{[[#mi-id-personal]]}."

#. type: Plain text
#: orgguide.texi:735
#, fuzzy
msgid ""
"Links such as @samp{[[My Target]]} or @samp{[[My Target][Find my target]]} "
"lead to a text search in the current file for the corresponding target which "
"looks like @samp{<<My Target>>}."
msgstr ""
"Enlaces tales como @samp{[[Mi Objetivo]]} o @samp{[[Mi\n"
"Objetivo][Encuentra mi objetivo]]} conduce a una b@'usqueda de texto\n"
"en el fichero actual para el correspondiente objetivo se parezca a\n"
"@samp{<<Mi objetivo>>}"

#. type: Plain text
#: orgguide.texi:744
msgid ""
"Org supports links to files, websites, Usenet and email messages, BBDB "
"database entries and links to both IRC conversations and their logs.  "
"External links are URL-like locators.  They start with a short identifying "
"string followed by a colon.  There can be no space after the colon.  Here "
"are some examples:"
msgstr ""
"Org tiene soporte para enlaces a ficheros, sitios web, mensajes de\n"
"correo electr@'onico y de News, entradas de bases de datos BBDB y\n"
"enlaces a conversaciones de IRC y sus logs. Enlaces externos son\n"
"identificadores tipo URL. Estos empiezan con una breve cadena de\n"
"identificaci@'on seguida por dos puntos. Sin espacio despu@'es de los\n"
"dos puntos. Aqu@'{@dotless{i}} se presentan algunos ejemplos:"

#. type: smallexample
#: orgguide.texi:764
#, fuzzy, no-wrap
msgid ""
"http://www.astro.uva.nl/~dominik          @r{on the web}\n"
"file:/home/dominik/images/jupiter.jpg     @r{file, absolute path}\n"
"/home/dominik/images/jupiter.jpg          @r{same as above}\n"
"file:papers/last.pdf                      @r{file, relative path}\n"
"file:projects.org                         @r{another Org file}\n"
"docview:papers/last.pdf::NNN              @r{open file in doc-view mode at page NNN}\n"
"id:B7423F4D-2E8A-471B-8810-C40F074717E9   @r{Link to heading by ID}\n"
"news:comp.emacs                           @r{Usenet link}\n"
"mailto:adent@@galaxy.net                   @r{Mail link}\n"
"vm:folder                                 @r{VM folder link}\n"
"vm:folder#id                              @r{VM message link}\n"
"wl:folder#id                              @r{WANDERLUST message link}\n"
"mhe:folder#id                             @r{MH-E message link}\n"
"rmail:folder#id                           @r{RMAIL message link}\n"
"gnus:group#id                             @r{Gnus article link}\n"
"bbdb:R.*Stallman                          @r{BBDB link (with regexp)}\n"
"irc:/irc.com/#emacs/bob                   @r{IRC link}\n"
"info:org:External%20links                 @r{Info node link (with encoded space)}\n"
msgstr ""
"http://www.astro.uva.nl/~dominik          @r{en la web}\n"
"file:/home/dominik/images/jupiter.jpg     @r{fichero, ruta absoluta}\n"
"/home/dominik/images/jupiter.jpg          @r{lo mismo que arriba}\n"
"file:papers/last.pdf                      @r{fichero, ruta relativa}\n"
"file:projects.org                         @r{otro fichero org}\n"
"docview:papers/last.pdf::NNN              @r{fichero abierto en modo doc-view en la p@'agina NNN}\n"
"id:B7423F4D-2E8A-471B-8810-C40F074717E9   @r{Enlace a un identificador}\n"
"news:comp.emacs                           @r{Enlace a un grupo de news}\n"
"mailto:adent@@galaxy.net                  @r{Enlace de Correo}\n"
"vm:folder                                 @r{Enlace a una carpeta de VM}\n"
"vm:folder#id                              @r{Enlace a un mensaje de VM}\n"
"wl:folder#id                              @r{Enlace a un mensaje de WANDERLUST}\n"
"mhe:folder#id                             @r{Enlace a un mensaje de MH-E}\n"
"rmail:folder#id                           @r{Enlace a un mensaje de RMAIL}\n"
"gnus:group#id                             @r{Enlace a un mensaje de GNUS}\n"
"bbdb:R.*Stallman                          @r{enlace a una entrada de BBDB (con expresi@'on regular)}\n"
"irc:/irc.com/#emacs/bob                   @r{enlace de IRC}\n"
"info:org:External%20links                 @r{Enlace a un nodo Info\n"
"(con el espacio en blaco codificado)}\n"

#. type: Plain text
#: orgguide.texi:769
msgid ""
"A link should be enclosed in double brackets and may contain a descriptive "
"text to be displayed instead of the URL (@pxref{Link format}), for example:"
msgstr ""
"Un enlace debe ser encerrado entre corchetes y puede tener un texto\n"
"descriptivo que ser@'a mostrado en vez de la URL (@pxref{Formato de\n"
"enlace}), por ejemplo:"

#. type: smallexample
#: orgguide.texi:772
#, fuzzy, no-wrap
msgid "[[http://www.gnu.org/software/emacs/][GNU Emacs]]\n"
msgstr "[[http://www.gnu.org/software/emacs/][GNU Emacs]]\n"

#. type: Plain text
#: orgguide.texi:779
#, fuzzy
msgid ""
"If the description is a file name or URL that points to an image, HTML "
"export (@pxref{HTML export}) will inline the image as a clickable button.  "
"If there is no description at all and the link points to an image, that "
"image will be inlined into the exported HTML file."
msgstr ""
"Si la descripci@'on es un nombre de fichero o URL que apunta a una\n"
"imagen, la exportaci@'on HTML (@pxref{HTML export}) introducir@'a la\n"
"imagen como un bot@'on al que se puede hacer click. Si no hay\n"
"descripci@'on y el enlace apunta a una imagen, esta imagen se\n"
"incrustar@'a dentro del fichero HTML exportado."

#. type: Plain text
#: orgguide.texi:785
msgid ""
"Org provides methods to create a link in the correct syntax, to insert it "
"into an Org file, and to follow the link."
msgstr ""
"Org provee m@'etodos para crear un enlace con la sintaxis correcta,\n"
"para insertarlo en un fichero Org, y poder seguir el enlace."

#. type: item
#: orgguide.texi:787
#, no-wrap
msgid "C-c l"
msgstr "C-c l"

#. type: table
#: orgguide.texi:793
msgid ""
"Store a link to the current location.  This is a @emph{global} command (you "
"must create the key binding yourself) which can be used in any buffer to "
"create a link.  The link will be stored for later insertion into an Org "
"buffer (see below)."
msgstr ""
"Almacena un enlace desde la posici@'on actual. @'Este es un comando\n"
"@emph{global} (debes crear el atajo de teclado por t@'{@dotless{i}}\n"
"mismo) el cual puede ser usado en cualquier buffer para crear un\n"
"enlace. El enlace ser@'a almacenado para posteriores inserciones\n"
"dentro de un buffer Org (ver m@'as abajo)."

#. type: item
#: orgguide.texi:793
#, no-wrap
msgid "C-c C-l"
msgstr "C-c C-l"

#. type: table
#: orgguide.texi:800
msgid ""
"Insert a link.  This prompts for a link to be inserted into the buffer.  You "
"can just type a link, or use history keys @key{up} and @key{down} to access "
"stored links.  You will be prompted for the description part of the link.  "
"When called with a @kbd{C-u} prefix argument, file name completion is used "
"to link to a file."
msgstr ""
"Inserta un enlace. Esto sugiere un enlace que ser@'a insertado dentro\n"
"del buffer. Se puede escribir un enlace, o usar la teclas del\n"
"historial @key{arriba} y @key{abajo} para acceder a los enlaces\n"
"almacenados. Tambi@'en ser@'a consultado por la parte de descripci@'on\n"
"del enlace. Cuando es llamado con el prefijo @kbd{C-u}, se usa el\n"
"autocompletado del nombre del fichero para enlazar a un fichero."

#. type: item
#: orgguide.texi:800
#, no-wrap
msgid "C-c C-l @r{(with cursor on existing link)}"
msgstr "C-c C-l @r{(con el cursor en un enlace existente)}"

#. type: table
#: orgguide.texi:804
msgid ""
"When the cursor is on an existing link, @kbd{C-c C-l} allows you to edit the "
"link and description parts of the link."
msgstr ""
"Cuando el cursor est@'a en enlace existente, @kbd{C-c C-l} permite\n"
"editar el enlace y las partes de descripci@'on del enlace."

#. type: item
#: orgguide.texi:804
#, no-wrap
msgid "C-c C-o @r{or} mouse-1 @r{or} mouse-2"
msgstr "C-c C-o @r{o} mouse-1 @r{o} mouse-2"

#. type: table
#: orgguide.texi:806
msgid "Open link at point."
msgstr "Abre el enlace en el que est@'a el cursor."

#. type: item
#: orgguide.texi:806
#, no-wrap
msgid "C-c &"
msgstr "C-c &"

#. type: table
#: orgguide.texi:812
msgid ""
"Jump back to a recorded position.  A position is recorded by the commands "
"following internal links, and by @kbd{C-c %}.  Using this command several "
"times in direct succession moves through a ring of previously recorded "
"positions."
msgstr ""
"Salta a una posici@'on grabada. Una posici@'on es grabada por los\n"
"siguientes comandos de enlaces internos, y por @kbd{C-c %}. Usando\n"
"este comando varias veces se mueve a trav@'es de un anillo de\n"
"posiciones previamente grabadas en una sucesi@'on directa."

#. type: Plain text
#: orgguide.texi:820
msgid ""
"File links can contain additional information to make Emacs jump to a "
"particular location in the file when following a link.  This can be a line "
"number or a search option after a double colon."
msgstr ""
"Los enlaces de ficheros pueden contener informaci@'on adicional para\n"
"hacer que Emacs salte a una posici@'on particular en el fichero cuando\n"
"se sigue un enlace. Esto puede ser un n@'umero de l@'{@dotless{i}}nea\n"
"o una opci@'on de b@'usqueda despu@'es de dos puntos dobles."

#. type: Plain text
#: orgguide.texi:823
msgid ""
"Here is the syntax of the different ways to attach a search to a file link, "
"together with an explanation:"
msgstr ""
"Aqu@'{@dotless{i}} est@'a la sintaxis de los diferentes caminos para\n"
"adjuntar una b@'usqueda a un enlace de fichero, junto con una explicaci@'on:"

#. type: smallexample
#: orgguide.texi:828
#, fuzzy, no-wrap
msgid ""
"[[file:~/code/main.c::255]]                 @r{Find line 255}\n"
"[[file:~/xx.org::My Target]]                @r{Find @samp{<<My Target>>}}\n"
"[[file:~/xx.org::#my-custom-id]]            @r{Find entry with custom id}\n"
msgstr ""
"[[file:~/code/main.c::255]]                 @r{Encontrar l@'{@dotless{i}}nea 255}\n"
"[[file:~/xx.org::Mi Objetivo]]              @r{Encontrar @samp{<<Mi Objetivo>>}}\n"
"[[file:~/xx.org::#mi-id-personal]]          @r{Encontrar entrada con\n"
"id personal}\n"

#. type: Plain text
#: orgguide.texi:833
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Hyperlinks.html#Hyperlinks, "
"Chapter 4 of the manual}}"
msgstr ""
"@seealso{ @uref{http://orgmode.org/manual/Hyperlinks.html#Hyperlinks,\n"
"Cap@'{@dotless{i}}tulo 4 del manual}}"

#. type: Plain text
#: orgguide.texi:844
msgid ""
"Org mode does not maintain TODO lists as separate documents@footnote{Of "
"course, you can make a document that contains only long lists of TODO items, "
"but this is not required.}.  Instead, TODO items are an integral part of the "
"notes file, because TODO items usually come up while taking notes! With Org "
"mode, simply mark any entry in a tree as being a TODO item.  In this way, "
"information is not duplicated, and the entire context from which the TODO "
"item emerged is always present."
msgstr ""
"El modo Org no mantiene listas TODO (tareas por hacer) como documentos\n"
"separados@footnote{De acuerdo, puede crear un documento que contenga\n"
"solo largas listas de @'{@dotless{i}}tems TODO, pero esto no se\n"
"requiere.}. En vez de eso, los @'{@dotless{i}}tems TODO son una parte\n"
"integral de los ficheros de notas, porque ¡los @'{@dotless{i}}tems TODO\n"
"normalmente aparecen mientras tomas notas!. De este modo, la\n"
"informaci@'on no est@'a duplicada, y el contexto entero desde el que\n"
"el @'{@dotless{i}}tem TODO emergi@'o est@'a siempre presente."

#. type: Plain text
#: orgguide.texi:848
msgid ""
"Of course, this technique for managing TODO items scatters them throughout "
"your notes file.  Org mode compensates for this by providing methods to give "
"you an overview of all the things that you have to do."
msgstr ""
"De acuerdo, esta t@'ecnica sirve para gestionar @'{@dotless{i}}tems\n"
"TODO esparcidos a trav@'es de tu fichero de notas. Org mode compensa\n"
"esto proveyendo m@'etodos para darte una visi@'on de alto nivel de\n"
"todas las cosas que tu tienes que hacer."

#. type: Plain text
#: orgguide.texi:863
msgid ""
"Any headline becomes a TODO item when it starts with the word @samp{TODO}, "
"for example:"
msgstr ""
"Cualquier t@'{@dotless{i}}tulo o subt@'{@dotless{i}}tulo puede llegar\n"
"a ser un @'{@dotless{i}}tem TODO cuando empieza con la palabra\n"
"@samp{TODO}, por ejemplo:"

#. type: smallexample
#: orgguide.texi:866
#, fuzzy, no-wrap
msgid "*** TODO Write letter to Sam Fortune\n"
msgstr "*** TODO Escribir carta a la Caba@~na del T@'{@dotless{i}}o Sam.\n"

#. type: Plain text
#: orgguide.texi:870
#, fuzzy
msgid "The most important commands to work with TODO entries are:"
msgstr "Los comandos m@'as importantes para trabajar con entradas TODO son:"

#. type: item
#: orgguide.texi:872
#, no-wrap
msgid "C-c C-t"
msgstr "C-c C-t"

#. type: table
#: orgguide.texi:874
#, fuzzy
msgid "Rotate the TODO state of the current item among"
msgstr "Rotar el estado TODO del @'{@dotless{i}}tem actual"

#. type: smallexample
#: orgguide.texi:878
#, fuzzy, no-wrap
msgid ""
",-> (unmarked) -> TODO -> DONE --.\n"
"'--------------------------------'\n"
msgstr ""
",-> (no marcado) -> TODO -> DONE --.\n"
"'----------------------------------'\n"

#. type: table
#: orgguide.texi:882
msgid ""
"The same rotation can also be done ``remotely'' from the timeline and agenda "
"buffers with the @kbd{t} command key (@pxref{Agenda commands})."
msgstr ""
"La misma rotaci@'on puede tambi@'en ser hecha ``de manera remota''\n"
"desde los buffers de agenda y l@'{@dotless{i}}nea de tiempo con la\n"
"tecla @kbd{t} (@pxref{Comandos de la agenda})."

#. type: item
#: orgguide.texi:883
#, no-wrap
msgid "S-@key{right}@r{/}@key{left}"
msgstr "S-@key{derecha}@r{/}@key{izquierda}"

#. type: table
#: orgguide.texi:885
msgid "Select the following/preceding TODO state, similar to cycling."
msgstr "Seleccionar el siguiente/precedente estado TODO, similar a rotar."

#. type: item
#: orgguide.texi:885
#, no-wrap
msgid "C-c / t"
msgstr "C-c / t"

#. type: table
#: orgguide.texi:889
msgid ""
"View TODO items in a @emph{sparse tree} (@pxref{Sparse trees}).  Folds the "
"buffer, but shows all TODO items and the headings hierarchy above them."
msgstr ""
"Ver @'{@dotless{i}}tems TODO en un @emph{@'arbol poco denso}\n"
"(@pxref{@'Arboles poco densos}). Encoge el buffer, pero muestra todos\n"
"los @'{@dotless{i}}tems y la jerarqu@'{@dotless{i}}a de\n"
"t@'{@dotless{i}}tulos y subt@'{@dotless{i}}tulos por encima de ellos."

#. type: item
#: orgguide.texi:889 orgguide.texi:1794
#, no-wrap
msgid "C-c a t"
msgstr "C-c a t"

#. type: table
#: orgguide.texi:893
#, fuzzy
msgid ""
"Show the global TODO list.  Collects the TODO items from all agenda files "
"(@pxref{Agenda Views}) into a single buffer.  @xref{Global TODO list}, for "
"more information."
msgstr ""
"Muestra la lista global TODO. Esta colecci@'on de items TODO de todos\n"
"los archivos de la agenda (@pxref{Vistas de la Agenda}) en un @'unico\n"
"buffer."

#. type: item
#: orgguide.texi:893
#, no-wrap
msgid "S-M-@key{RET}"
msgstr "S-M-@key{RET}"

#. type: table
#: orgguide.texi:895
msgid "Insert a new TODO entry below the current one."
msgstr "Inserta una nueva entrada TODO debajo del @'{@dotless{i}}tem actual."

#. type: Plain text
#: orgguide.texi:900
#, fuzzy
msgid ""
"Changing a TODO state can also trigger tag changes.  See the docstring of "
"the option @code{org-todo-state-tags-triggers} for details."
msgstr ""
"Al cambiar el estado de un @'{@dotless{i}}tem TODO se puede tambi@'en\n"
"activar cambios de etiqueta. Ver el docstring de la opci@'on\n"
"@code{org-todo-state-tags-triggers} para m@'as detalles."

#. type: Plain text
#: orgguide.texi:906
msgid ""
"You can use TODO keywords to indicate different @emph{sequential} states in "
"the process of working on an item, for example:"
msgstr ""
"Se pueden usar palabras reservadas TODO para indicar diferentes\n"
"estados @emph{secuenciales} en el proceso de trabajo con respecto a un\n"
"@'{@dotless{i}}tem, por ejemplo:"

#. type: smalllisp
#: orgguide.texi:910
#, fuzzy, no-wrap
msgid ""
"(setq org-todo-keywords\n"
"  '((sequence \"TODO\" \"FEEDBACK\" \"VERIFY\" \"|\" \"DONE\" \"DELEGATED\")))\n"
msgstr ""
"(setq org-todo-keywords\n"
"  '((sequence \"TODO\" \"FEEDBACK\" \"VERIFY\" \"|\" \"DONE\" \"DELEGATED\")))\n"

#. type: Plain text
#: orgguide.texi:918
msgid ""
"The vertical bar separates the TODO keywords (states that @emph{need "
"action}) from the DONE states (which need @emph{no further action}).  If you "
"don't provide the separator bar, the last state is used as the DONE state.  "
"With this setup, the command @kbd{C-c C-t} will cycle an entry from TODO to "
"FEEDBACK, then to VERIFY, and finally to DONE and DELEGATED."
msgstr ""
"La barra vertical separa las palabras reservadas TODO (estados que\n"
"@emph{necesitan acci@'on}) de los estados DONE (realizados, que\n"
"@emph{no necesitan m@'as acci@'on}). Si no se proporciona la barra\n"
"separadora, el @'ultimo estado es usado como estado DONE. Con esta\n"
"configuraci@'on, el comando @kbd{C-c C-t} rotar@'a una entrada desde\n"
"TODO a FEEDBACK, despu@'es a VERIFY y finalmente a DONE y DELEGATED."

#. type: Plain text
#: orgguide.texi:925
msgid ""
"Sometimes you may want to use different sets of TODO keywords in parallel.  "
"For example, you may want to have the basic @code{TODO}/@code{DONE}, but "
"also a workflow for bug fixing, and a separate state indicating that an item "
"has been canceled (so it is not DONE, but also does not require action).  "
"Your setup would then look like this:"
msgstr ""
"Algunas veces se puede querer usar diferentes configuraciones de\n"
"palabras reservadas TODO en paralelo. Por ejemplo, se puede querer\n"
"tener el b@'asico @code{TODO}/@code{DONE}, pero tambi@'en un flujo de\n"
"trabajo para la correcci@'on de errores, y un estado separando el\n"
"estado que indica que un @'{@dotless{i}}tem ha sido cancelado\n"
"(as@'{@dotless{i}} no est@'a DONE, pero tampoco requiere acci@'on). La\n"
"configuraci@'on ser@'{@dotless{i}}a la siguiente:"

#. type: smalllisp
#: orgguide.texi:931
#, fuzzy, no-wrap
msgid ""
"(setq org-todo-keywords\n"
"      '((sequence \"TODO(t)\" \"|\" \"DONE(d)\")\n"
"        (sequence \"REPORT(r)\" \"BUG(b)\" \"KNOWNCAUSE(k)\" \"|\" \"FIXED(f)\")\n"
"        (sequence \"|\" \"CANCELED(c)\")))\n"
msgstr ""
"(setq org-todo-keywords\n"
"      '((sequence \"TODO(t)\" \"|\" \"DONE(d)\")\n"
"        (sequence \"REPORT(r)\" \"BUG(b)\" \"KNOWNCAUSE(k)\" \"|\" \"FIXED(f)\")\n"
"        (sequence \"|\" \"CANCELED(c)\")))\n"

#. type: Plain text
#: orgguide.texi:938
msgid ""
"The keywords should all be different, this helps Org mode to keep track of "
"which subsequence should be used for a given entry.  The example also shows "
"how to define keys for fast access of a particular state, by adding a letter "
"in parenthesis after each keyword - you will be prompted for the key after "
"@kbd{C-c C-t}."
msgstr ""
"Las palabras reservadas son todas diferentes, esto ayuda a Org mode a\n"
"guardar la traza de que subsecuencia deber@'{@dotless{i}}a ser usada\n"
"para una entrada dada. El ejemplo tambi@'en muestra c@'omo definir\n"
"teclas para un r@'apido acceso a un estado particular, a@~nadiendo una\n"
"letra entre par@'entesis despu@'es de cada palabra reservada - se\n"
"preguntar@'a por la letra despu@'es de @kbd{C-c C-t}."

#. type: Plain text
#: orgguide.texi:941
msgid ""
"To define TODO keywords that are valid only in a single file, use the "
"following text anywhere in the file."
msgstr ""
"Para definir palabras reservadas TODO que son v@'alidas @'unicamente\n"
"en un solo fichero, use el siguiente texto en cualquier lugar del\n"
"fichero."

#. type: smallexample
#: orgguide.texi:946
#, fuzzy, no-wrap
msgid ""
"#+TODO: TODO(t) | DONE(d)\n"
"#+TODO: REPORT(r) BUG(b) KNOWNCAUSE(k) | FIXED(f)\n"
"#+TODO: | CANCELED(c)\n"
msgstr ""
"#+TODO: TODO(t) | DONE(d)\n"
"#+TODO: REPORT(r) BUG(b) KNOWNCAUSE(k) | FIXED(f)\n"
"#+TODO: | CANCELED(c)\n"

#. type: Plain text
#: orgguide.texi:950
msgid ""
"After changing one of these lines, use @kbd{C-c C-c} with the cursor still "
"in the line to make the changes known to Org mode."
msgstr ""
"Despu@'es de cambiar una de estas l@'{@dotless{i}}neas, use @kbd{C-c\n"
"C-c} con el cursor todav@'{@dotless{i}}a en la l@'{@dotless{i}}nea\n"
"para que Org mode reconozca los cambios."

#. type: Plain text
#: orgguide.texi:960
msgid ""
"Org mode can automatically record a timestamp and possibly a note when you "
"mark a TODO item as DONE, or even each time you change the state of a TODO "
"item.  This system is highly configurable, settings can be on a per-keyword "
"basis and can be localized to a file or even a subtree.  For information on "
"how to clock working time for a task, see @ref{Clocking work time}."
msgstr ""
"Org mode puede grabar autom@'aticamente un timestamp y posiblemente\n"
"una nota cuando se marca un @'{@dotless{i}}tem TODO como DONE, @'o\n"
"incluso cada vez que se cambia el estado de un @'{@dotless{i}}tem\n"
"TODO. Este sistema es altamente configurable, las configuraciones\n"
"pueden seguir una l@'ogica por tecla y pueden afectar a un fichero o\n"
"incluso a un sub@'arbol. Para m@'as informaci@'on de c@'omo fijar\n"
"fecha y hora de una tareas, lea @ref{Estableciendo tiempo de trabajo}."

#. type: Plain text
#: orgguide.texi:972
msgid ""
"The most basic logging is to keep track of @emph{when} a certain TODO item "
"was finished.  This is achieved with@footnote{The corresponding in-buffer "
"setting is: @code{#+STARTUP: logdone}}."
msgstr ""
"El registro m@'as b@'asico es guardar @emph{cuando} un\n"
"@'{@dotless{i}}tem TODO se finaliz@'o. Esto se logra con@footnote{La\n"
"correspondiente configuraci@'on en el buffer es @code{#+STARTUP:\n"
"logdone}}."

#. type: smalllisp
#: orgguide.texi:975
#, fuzzy, no-wrap
msgid "(setq org-log-done 'time)\n"
msgstr "(setq org-log-done 'time)\n"

#. type: Plain text
#: orgguide.texi:983
#, fuzzy
msgid ""
"Then each time you turn an entry from a TODO (not-done) state into any of "
"the DONE states, a line @samp{CLOSED: [timestamp]} will be inserted just "
"after the headline.  If you want to record a note along with the timestamp, "
"use@footnote{The corresponding in-buffer setting is: @code{#+STARTUP: "
"lognotedone}}"
msgstr ""
"As@'{@dotless{i}}, cada vez que se cambia una entrada desde un estado\n"
"TODO (no DONE) a cualquiera de los estados DONE, una\n"
"l@'{@dotless{i}}nea @samp{CLOSED: [timestamp]} ser@'a insertada justo\n"
"despu@'es de la cabecera. Si quieres grabar una nota con una marca de\n"
"tiempo (timestamp) usa@footnote{La correspondiente configuraci@'on en\n"
"el buffer es: @code{#+STARTUP: lognotedone}} "

#. type: smalllisp
#: orgguide.texi:986
#, fuzzy, no-wrap
msgid "(setq org-log-done 'note)\n"
msgstr "(setq org-log-done 'note)\n"

#. type: Plain text
#: orgguide.texi:991
#, fuzzy
msgid ""
"You will then be prompted for a note, and that note will be stored below the "
"entry with a @samp{Closing Note} heading."
msgstr ""
"Entonces, se preguntar@'a por la nota, y la nota ser@'a almacenada\n"
"debajo de la entrada con una cabercera @samp{Closing Note} (Cerrando Nota)."

#. type: Plain text
#: orgguide.texi:1000
msgid ""
"You might want to keep track of TODO state changes.  You can either record "
"just a timestamp, or a time-stamped note for a change.  These records will "
"be inserted after the headline as an itemized list.  When taking a lot of "
"notes, you might want to get the notes out of the way into a drawer.  "
"Customize the variable @code{org-log-into-drawer} to get this behavior."
msgstr ""
"Se podr@'{@dotless{i}}a querer guardar la traza de cambios de estado\n"
"TODO. Se puede o bien registrar solo una marca de tiempo (timestamp),\n"
"o bien una nota con una estampa de tiempo para un cambio. Estos\n"
"registros ser@'an insertados despu@'es de la cabecera como una lista\n"
"de @'{@dotless{i}}tems. Cuando se toman un mont@'on de notas, se\n"
"podr@'{@dotless{i}}a querer tener las notas fuera de la vista dentro\n"
"de un \"@i{caj@'on}\" (drawer)\n"
"@seealso{@uref{http://www.gnu.org/software/emacs/manual/html_node/org/"
"Drawers.html#Drawers,\n"
"Drawers en el Cap@'{@dotless{i}}tulo 2 del manual}}"

#. type: Plain text
#: orgguide.texi:1004
#, fuzzy
msgid ""
"For state logging, Org mode expects configuration on a per-keyword basis.  "
"This is achieved by adding special markers @samp{!} (for a timestamp) and "
"@samp{@@} (for a note) in parentheses after each keyword.  For example:"
msgstr ""
"Para el registro de estados, Org mode conf@'{@dotless{i}}a en una\n"
"configuraci@'on basada en palabras reservadas. Esto se logra\n"
"a@~nadiendo marcas especiales @samp{!} (para una marca de tiempo) y\n"
"@samp{@@} (para una nota) entre par@'entesis despu@'es de cada palabra\n"
"reservada. Por ejemplo:"

#. type: smallexample
#: orgguide.texi:1006
#, no-wrap
msgid "#+TODO: TODO(t) WAIT(w@@/!) | DONE(d!) CANCELED(c@@)\n"
msgstr "#+TODO: TODO(t) WAIT(w@@/!) | DONE(d!) CANCELED(c@@)\n"

#. type: Plain text
#: orgguide.texi:1012
#, fuzzy
msgid ""
"will define TODO keywords and fast access keys, and also request that a time "
"is recorded when the entry is set to DONE, and that a note is recorded when "
"switching to WAIT or CANCELED.  The same syntax works also when setting @code"
"{org-todo-keywords}."
msgstr ""
"define las palabras reservadas TODO y el acceso a los atajos de\n"
"teclado, y tambi@'en solicita que se grabe el momento en el que la\n"
"entrada se estableci@'o como DONE, y que una nota es grabada cuando se\n"
"cambie a WAIT o CANCELED. La misma sintaxis funciona tambi@'en cuando\n"
"se define @code{org-todo-keywords}."

#. type: Plain text
#: orgguide.texi:1019
msgid ""
"If you use Org mode extensively, you may end up with enough TODO items that "
"it starts to make sense to prioritize them.  Prioritizing can be done by "
"placing a @emph{priority cookie} into the headline of a TODO item, like this"
msgstr ""
"Si usa Org mode intensamente, puede acabar con suficientes\n"
"@'{@dotless{i}}tems TODO que empiece a tener sentido\n"
"priorizarlos. Priorizar puede ser hecho poniendo una @emph{marca de\n"
"prioridad} en la cabecera de un @'{@dotless{i}}tem TODO, como esta"

#. type: smallexample
#: orgguide.texi:1022
#, fuzzy, no-wrap
msgid "*** TODO [#A] Write letter to Sam Fortune\n"
msgstr "*** TODO [#A] Escribir carta a Santa Fortuna"

#. type: Plain text
#: orgguide.texi:1028
#, fuzzy
msgid ""
"Org mode supports three priorities: @samp{A}, @samp{B}, and @samp{C}.  @samp"
"{A} is the highest, @samp{B} the default if none is given.  Priorities make "
"a difference only in the agenda."
msgstr ""
"Org mode soporta tres prioridades: @samp{A}, @samp{B},\n"
"@samp{C}. @samp{A} es la m@'as alta, por defecto ser@'a @samp{B} si\n"
"ninguna es dada. Las prioridades marcan diferencia s@'olo en la\n"
"agenda."

#. type: kbd{#1}
#: orgguide.texi:1030
#, no-wrap
msgid "C-c ,"
msgstr "C-c ,"

#. type: table
#: orgguide.texi:1034
#, fuzzy
msgid ""
"Set the priority of the current headline.  Press @samp{A}, @samp{B} or @samp"
"{C} to select a priority, or @key{SPC} to remove the cookie."
msgstr ""
"Pone una prioridad a la actual cabecera. Presionando @samp{A},\n"
"@samp{B} o @samp{C} se selecciona la prioridad, o @key{SPC} para\n"
"eliminar la marca."

#. type: item
#: orgguide.texi:1034
#, no-wrap
msgid "S-@key{up}"
msgstr "S-@key{up}"

#. type: itemx
#: orgguide.texi:1035
#, no-wrap
msgid "S-@key{down}"
msgstr "S-@key{down}"

#. type: table
#: orgguide.texi:1037
msgid "Increase/decrease priority of current headline"
msgstr "Incremente/decrementa la prioridad de la cabecera actual"

#. type: section
#: orgguide.texi:1040
#, no-wrap
msgid "Breaking tasks down into subtasks"
msgstr "Partiendo tareas en subtareas"

#. type: Plain text
#: orgguide.texi:1049
msgid ""
"It is often advisable to break down large tasks into smaller, manageable "
"subtasks.  You can do this by creating an outline tree below a TODO item, "
"with detailed subtasks on the tree.  To keep the overview over the fraction "
"of subtasks that are already completed, insert either @samp{[/]} or @samp"
"{[%]} anywhere in the headline.  These cookies will be updated each time the "
"TODO status of a child changes, or when pressing @kbd{C-c C-c} on the "
"cookie.  For example:"
msgstr ""
"Es a menudo ventajoso dividir grandes tareas en peque@~nas y\n"
"manejables subtareas. Puede realizar esto creando un @'arbol de\n"
"outline bajo un item TODO, el cual detalla las subtareas en el\n"
"@'arbol. Para poner la vista sobre la fracci@'on de subtareas que\n"
"est@'an ya completadas, inserte un @samp{[/]} o @samp{[%]} en\n"
"cualquier lugar de la cabecera. Estas marcas ser@'an actualizadas cada\n"
"vez que el estado TODO de alg@'un hijo cambie, o presionando @kbd{C-c\n"
"C-c} en la marca. Por ejemplo:"

#. type: smallexample
#: orgguide.texi:1057
#, fuzzy, no-wrap
msgid ""
"* Organize Party [33%]\n"
"** TODO Call people [1/2]\n"
"*** TODO Peter\n"
"*** DONE Sarah\n"
"** TODO Buy food\n"
"** DONE Talk to neighbor\n"
msgstr ""
"* Organizar Fiesta [33%]\n"
"** TODO Llamar a la gente [1/2]\n"
"*** TODO Pedro\n"
"*** DONE Sara\n"
"** TODO Comprar comida\n"
"** DONE Hablar con el vecino"

#. type: Plain text
#: orgguide.texi:1067
msgid ""
"Every item in a plain list (@pxref{Plain lists}) can be made into a checkbox "
"by starting it with the string @samp{[ ]}.  Checkboxes are not included into "
"the global TODO list, so they are often great to split a task into a number "
"of simple steps.  Here is an example of a checkbox list."
msgstr ""
"Cada item en una lista plana (@pxref{Listas planas}) puede ser un\n"
"cuadro de chequeo comenzando con la cadena @samp{[]}. Los cuadros de\n"
"chequeo nos est@'an incluidos en la lista TODO global,\n"
"as@'{@dotless{i}} a menudo es preferible dividir la tarea en un\n"
"n@'umero reducido de pasos."

#. type: smallexample
#: orgguide.texi:1075
#, fuzzy, no-wrap
msgid ""
"* TODO Organize party [1/3]\n"
"  - [-] call people [1/2]\n"
"    - [ ] Peter\n"
"    - [X] Sarah\n"
"  - [X] order food\n"
"  - [ ] think about what music to play\n"
msgstr ""
"* TODO Organizar Fiesta [1/3]\n"
"  - [-] Llamar a la gente [1/2]\n"
"    - [ ] Pedro\n"
"    - [X] Sara\n"
"  - [X] Comprar comida\n"
"  - [ ] pensar qu@'e m@'usica escuchar\n"

#. type: Plain text
#: orgguide.texi:1081
msgid ""
"Checkboxes work hierarchically, so if a checkbox item has children that are "
"checkboxes, toggling one of the children checkboxes will make the parent "
"checkbox reflect if none, some, or all of the children are checked."
msgstr ""
"Las cajas de chequeo funcionan jer@'arquicamente, si un item es caja de\n"
"chequeo y tiene hijos que son cajas de chequeo, marcando las cajas de\n"
"chequeo hijos se marcar@'a la caja de chequeo del padre para reflejar\n"
"si ninguno, alguno o todos los hijos est@'an marcados."

#. type: table
#: orgguide.texi:1087
msgid "Toggle checkbox status or (with prefix arg) checkbox presence at point."
msgstr ""
"Cambia el estado de la caja de chequeo o (con prefijo) a@~nade una\n"
"caja de chequeo."

#. type: table
#: orgguide.texi:1091
#, fuzzy
msgid ""
"Insert a new item with a checkbox.  This works only if the cursor is already "
"in a plain list item (@pxref{Plain lists})."
msgstr ""
"Inserta un nuevo item con un cuadro de chequeo. Esto funciona solo si\n"
"el cursor est@'a en un item de la lista plana (@pxref{Listas planas})."

#. type: Plain text
#: orgguide.texi:1099
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/TODO-Items.html#TODO-Items, "
"Chapter 5 of the manual}@* @uref{http://orgmode.org/worg/org-tutorials/"
"orgtutorial_dto.php, David O'Toole's introductory tutorial}@* @uref{http://"
"members.optusnet.com.au/~charles57/GTD/gtd_workflow.html, Charles Cave's GTD "
"setup}}"
msgstr ""
"@seealso{ @uref{http://orgmode.org/manual/TODO-Items.html#TODO-Items, \n"
"Cap@'{@dotless{i}}tulo 5 del manual}@* @uref{http://orgmode.org/worg/org-"
"tutorials/\n"
"orgtutorial_dto.php, Tutorial de introducci@'on de David O'Toole}@* @uref"
"{http://\n"
"members.optusnet.com.au/~charles57/GTD/gtd_workflow.html,\n"
"Configuraci@'on de GTD de Charles Cave}}"

#. type: Plain text
#: orgguide.texi:1106
msgid ""
"An excellent way to implement labels and contexts for cross-correlating "
"information is to assign @i{tags} to headlines.  Org mode has extensive "
"support for tags."
msgstr ""
"Una excelante forma de nombrar y contextualizar informaci@'on\n"
"interrelacionada es asignar @i{etiquetas} a las cabeceras. Org mode\n"
"tiene un amplio soporte para etiquetas. @footnote{Nota del Traductor: Tanto\n"
"label como tag se traduce como etiqueta. En general, label se utiliza\n"
"más como nombre que se le asigna a algo y tag como palabra clave, si\n"
"bien ambas suelen traducirse como etiqueta. As@'{@dotless{i}}, he\n"
"decidido traducir @i{implement label} como nombrar y @i{tag} como\n"
"etiqueta.}"

#. type: Plain text
#: orgguide.texi:1112
msgid ""
"Every headline can contain a list of tags; they occur at the end of the "
"headline.  Tags are normal words containing letters, numbers, @samp{_}, and "
"@samp{@@}.  Tags must be preceded and followed by a single colon, e.g., @samp"
"{:work:}.  Several tags can be specified, as in @samp{:work:urgent:}.  Tags "
"will by default be in bold face with the same color as the headline."
msgstr ""
"Cada cabecera puede contener una lista de etiquetas; se introducen al\n"
"final de una cabecera. Las etiquetas son palabras normales conteniendo\n"
"letras, números, @samp{_} y @samp{@@}. Las etiquetas deben estar\n"
"precedidas y seguidas por dos puntos, por ejemplo,\n"
"@samp{:trabajo:}. Es posible asignar varias etiquetas, como en\n"
"@samp{:trabajo:urgente:}. Las etiquetas por defecto estar@'an en\n"
"negrilla con el mismo color que la cabecera."

#. type: Plain text
#: orgguide.texi:1125
msgid ""
"@i{Tags} make use of the hierarchical structure of outline trees.  If a "
"heading has a certain tag, all subheadings will inherit the tag as well.  "
"For example, in the list"
msgstr ""
"Las @i{etiquetas} hacen uso de la estructura jer@'arquica de los\n"
"@'arboles de org-mode. Si una cabecera tiene una cierta etiqueta,\n"
"todas las subcabeceras heredar@'an la etiqueta tambi@'en. Por ejemplo,\n"
"en la lista"

#. type: smallexample
#: orgguide.texi:1130
#, fuzzy, no-wrap
msgid ""
"* Meeting with the French group      :work:\n"
"** Summary by Frank                  :boss:notes:\n"
"*** TODO Prepare slides for him      :action:\n"
msgstr ""
"* Encuentro con franceses                  :trabajo:\n"
"** Resumen para Carolina                   :jefa:notas:\n"
"*** TODO Preparar presentaciones para ella :actividad:\n"

#. type: Plain text
#: orgguide.texi:1140
#, fuzzy
msgid ""
"the final heading will have the tags @samp{:work:}, @samp{:boss:}, @samp{:"
"notes:}, and @samp{:action:} even though the final heading is not explicitly "
"marked with those tags.  You can also set tags that all entries in a file "
"should inherit just as if these tags were defined in a hypothetical level "
"zero that surrounds the entire file.  Use a line like this@footnote{As with "
"all these in-buffer settings, pressing @kbd{C-c C-c} activates any changes "
"in the line.}:"
msgstr ""
"la cabecera final tendr@'a las etiquetas @samp{:trabajo:},\n"
"@samp{:jefa:}, @samp{:notas:} y @samp{:actividad:} incluso aunque la\n"
"cabecera final no est@'e expl@'{@dotless{i}}citamente marcada con\n"
"estas etiquetas. Se puede tambi@'en asignar etiquetas para que todas\n"
"las entradas en un fichero hereden si estas etiquetas fueron definidas\n"
"en un hipot@'etico nivel cero alrededor del fichero entero. Usa una\n"
"l@'{@dotless{i}}nea como esta@footnote{Como siempre estas\n"
"configuraciones de buffer se activan presionando @kbd{C-c C-c}.}:"

#. type: smallexample
#: orgguide.texi:1143
#, no-wrap
msgid "#+FILETAGS: :Peter:Boss:Secret:\n"
msgstr "#+FILETAGS: :Pedro:Jefe:Secreto:\n"

#. type: Plain text
#: orgguide.texi:1151
msgid ""
"Tags can simply be typed into the buffer at the end of a headline.  After a "
"colon, @kbd{M-@key{TAB}} offers completion on tags.  There is also a special "
"command for inserting tags:"
msgstr ""
"Las etiquetas pueden simplemente ser escritas en un bufer al final de\n"
"una cabecera. Despu@'es de los dos puntos, @kbd{M-@key{TAB}}\n"
"autocompleta etiquetas. Hay tambi@'en un comando para insertar etiquetas:"

#. type: item
#: orgguide.texi:1153
#, no-wrap
msgid "C-c C-q"
msgstr "C-c C-q"

#. type: table
#: orgguide.texi:1160
#, fuzzy
msgid ""
"Enter new tags for the current headline.  Org mode will either offer "
"completion or a special single-key interface for setting tags, see below.  "
"After pressing @key{RET}, the tags will be inserted and aligned to @code{org-"
"tags-column}.  When called with a @kbd{C-u} prefix, all tags in the current "
"buffer will be aligned to that column, just to make things look nice."
msgstr ""
"Introduce nuevas etiquetas para la cabecera actual. Org mode\n"
"ofrecer@'a autocompletado o una interfaz especial de una sola tecla\n"
"para asignar etiquetas, ver m@'as abajo. Despu@'es de presionar\n"
"@key{RET}, las etiquetas ser@'an insertadas y alineadas para\n"
"@code{org-tags-column}. Cuando se llama con el prefijo @kbd{C-u},\n"
"todas las etiquetas en el buffer actual ser@'an alineadas a esta\n"
"columna, solo para que las cosas se vean bien."

#. type: table
#: orgguide.texi:1162
msgid "When the cursor is in a headline, this does the same as @kbd{C-c C-q}."
msgstr ""
"Cuando el cursor est@'a en una cabecera, hace lo mismo que @kbd{C-c\n"
"C-q}."

#. type: Plain text
#: orgguide.texi:1169
msgid ""
"Org will support tag insertion based on a @emph{list of tags}.  By default "
"this list is constructed dynamically, containing all tags currently used in "
"the buffer.  You may also globally specify a hard list of tags with the "
"variable @code{org-tag-alist}.  Finally you can set the default tags for a "
"given file with lines like"
msgstr ""
"Org soporta inserci@'on de etiquetas basado en una @emph{lista de\n"
"etiquetas}. Por defecto esta lista es construida din@'amicamente,\n"
"conteniendo todas las etiquetas actualmente usadas en el\n"
"buffer. Tambi@'en se puede especificar globalmente una lista dura de\n"
"etiquetas con la variable @code{org-tag-alist}. Finalmente se puede\n"
"asignar las etiquetas por defecto para un fichero dado con\n"
"l@'{@dotless{i}}neas como"

#. type: smallexample
#: orgguide.texi:1173
#, fuzzy, no-wrap
msgid ""
"#+TAGS: @@work @@home @@tennisclub\n"
"#+TAGS: laptop car pc sailboat\n"
msgstr "#+TAGS: @@trabajo(t)  @@casa(c)  @@futbol(f)  servidor(s)  pc(p)\n"

#. type: Plain text
#: orgguide.texi:1184
msgid ""
"By default Org mode uses the standard minibuffer completion facilities for "
"entering tags.  However, it also implements another, quicker, tag selection "
"method called @emph{fast tag selection}.  This allows you to select and "
"deselect tags with just a single key press.  For this to work well you "
"should assign unique letters to most of your commonly used tags.  You can do "
"this globally by configuring the variable @code{org-tag-alist} in your @file"
"{.emacs} file.  For example, you may find the need to tag many items in "
"different files with @samp{:@@home:}.  In this case you can set something "
"like:"
msgstr ""
"Por defecto, Org mode usa las facilidades de compleci@'on del\n"
"minibuffer para introducir etiquetas. Sin embargo, tambi@'en\n"
"implementa otro r@'apido m@'etodo de selecci@'on de etiquetas llamado\n"
"@emph{fast tag selection}. Este permite que tu selecciones y\n"
"dejes de seleccionar etiquetas con solo presionar una sola tecla. Para\n"
"que esto funcione bien se debe asignar letras @'unicas para las\n"
"etiquetas m@'as usadas. Se puede hacer esto de manera global\n"
"configurando la variable @code{org-tag-alist} en el fichero\n"
"@file{.emacs}. Por ejemplo, se puede encontrar la necesidad de\n"
"etiquetar muchos @'{@dotless{i}}tems en diferentes ficheros con\n"
"@samp{:@@casa:}. En este caso se puede hacer algo como:"

#. type: smalllisp
#: orgguide.texi:1187
#, fuzzy, no-wrap
msgid "(setq org-tag-alist '((\"@@work\" . ?w) (\"@@home\" . ?h) (\"laptop\" . ?l)))\n"
msgstr "(setq org-tag-alist '((\"@@trabajo\" . ?t) (\"@@casa\" . ?c) (\"portatil\" . ?p)))\n"

#. type: Plain text
#: orgguide.texi:1191
msgid "can instead set the TAGS option line as:"
msgstr "o bien establecer en la l@'{@dotless{i}}nea TAGS una opci@'on como:"

#. type: smallexample
#: orgguide.texi:1194
#, no-wrap
msgid "#+TAGS: @@work(w)  @@home(h)  @@tennisclub(t)  laptop(l)  pc(p)\n"
msgstr "#+TAGS: @@trabajo(t)  @@casa(c)  @@futbol(f)  servidor(s)  pc(p)\n"

#. type: Plain text
#: orgguide.texi:1201
msgid ""
"Once a system of tags has been set up, it can be used to collect related "
"information into special lists."
msgstr ""
"Una vez que un sistema de etiquetas ha sido configurado, puede ser\n"
"usado para recoger informaci@'on dentro de listas especiales."

#. type: item
#: orgguide.texi:1203
#, no-wrap
msgid "C-c \\"
msgstr "C-c \\"

#. type: itemx
#: orgguide.texi:1204
#, no-wrap
msgid "C-c / m"
msgstr "C-c / m"

#. type: table
#: orgguide.texi:1207
msgid ""
"Create a sparse tree with all headlines matching a tags search.  With a @kbd"
"{C-u} prefix argument, ignore headlines that are not a TODO line."
msgstr ""
"Crear un @'arbol expandido con todas las cabeceras coincidentes con la\n"
"etiqueta (tag) buscada. Con el prefijo @kbd{C-u}, ignora las cabeceras\n"
"que no son TODO."

#. type: item
#: orgguide.texi:1207 orgguide.texi:1812
#, no-wrap
msgid "C-c a m"
msgstr "C-c a m"

#. type: table
#: orgguide.texi:1210
msgid ""
"Create a global list of tag matches from all agenda files.  @xref{Matching "
"tags and properties}."
msgstr ""
"Crea una lista global de marcas coincidentes de todos los archivos de la "
"agenda. @xref{Coincidiendo marcas y propiedades}."

#. type: item
#: orgguide.texi:1210 orgguide.texi:1818
#, no-wrap
msgid "C-c a M"
msgstr "C-c a M"

#. type: table
#: orgguide.texi:1214
#, fuzzy
msgid ""
"Create a global list of tag matches from all agenda files, but check only "
"TODO items and force checking subitems (see variable @code{org-tags-match-"
"list-sublevels})."
msgstr ""
"Crea una lista global de marcas coincidentes de todos los archivos de la "
"agenda. @xref{Coincidiendo marcas y propiedades}."

#. type: Plain text
#: orgguide.texi:1223
msgid ""
"These commands all prompt for a match string which allows basic Boolean "
"logic like @samp{+boss+urgent-project1}, to find entries with tags @samp"
"{boss} and @samp{urgent}, but not @samp{project1}, or @samp{Kathy|Sally} to "
"find entries which are tagged, like @samp{Kathy} or @samp{Sally}.  The full "
"syntax of the search string is rich and allows also matching against TODO "
"keywords, entry levels and properties.  For a complete description with many "
"examples, see @ref{Matching tags and properties}."
msgstr ""
"Estos comandos buscan coincidencias de cadenas que permiten una\n"
"l@'ogica b@'asica como @samp{+jefe+urgente-proyecto1}, para encontrar\n"
"entradas con marcas @samp{jefe} y @samp{urgente}, pero sin\n"
"@samp{proyecto1}, o @samp{Jos@'e|Juan} para encontrar ambas entradas,\n"
"tanto @samp{Jos@'e} como @samp{Juan}. La sint@'axis completa de las\n"
"cadenas de b@'usqueda es rica y permite adem@'as coincidencias con\n"
"todas las palabras clave TODO, entradas de nivel y propiedades. Para\n"
"una completa descripci@'on con muchos ejemplos, vea @ref{Coincidiendo marcas "
"y propiedades}."

#. type: Plain text
#: orgguide.texi:1228
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Tags.html#Tags, Chapter 6 of the "
"manual}@* @uref{http://sachachua.com/wp/2008/01/tagging-in-org-plus-bonus-"
"code-for-timeclocks-and-tags/, Sacha Chua's article about tagging in Org-"
"mode}}"
msgstr ""
"@seealso{ @uref{http://orgmode.org/manual/Tags.html#Tags,\n"
"Cap@'{@dotless{i}}tulo 6 del manual}@*\n"
"@uref{http://sachachua.com/wp/2008/01/tagging-in-org-plus-bonus-code-for-"
"timeclocks-and-tags/,\n"
"art@'{@dotless{i}}culo de Sacha Chua acerca de etiquetado en Org-mode}}"

#. type: Plain text
#: orgguide.texi:1236
msgid ""
"Properties are key-value pairs associates with and entry.  They live in a "
"special drawer with the name @code{PROPERTIES}.  Each property is specified "
"on a single line, with the key (surrounded by colons)  first, and the value "
"after it:"
msgstr ""
"Las propiedades son pares clave valor asociados con una entrada. Estos\n"
"se encuentran en un lugar especial con el nombre\n"
"@code{PROPERTIES}. Cada propiedad se especifica en una\n"
"l@'{@dotless{i}}nea simple, con la clave (rodeada por dos puntos)\n"
"primero, y el valor despu@'es de @'esta."

#. type: smallexample
#: orgguide.texi:1247
#, fuzzy, no-wrap
msgid ""
"* CD collection\n"
"** Classic\n"
"*** Goldberg Variations\n"
"    :PROPERTIES:\n"
"    :Title:     Goldberg Variations\n"
"    :Composer:  J.S. Bach\n"
"    :Publisher: Deutsche Grammophon\n"
"    :NDisks:    1\n"
"    :END:\n"
msgstr ""
"* Colecci@'on de CDs \n"
"** Cl@'asica\n"
"*** Variaciones de Goldberg \n"
"    :PROPERTIES:\n"
"    :T@'{@dotless{i}}tulo:     Goldberg Variations\n"
"    :Compositor:  J.S. Bach\n"
"    :Discogr@'afica: Deutsche Grammophon\n"
"    :Discos:    1\n"
"    :END:\n"

#. type: Plain text
#: orgguide.texi:1256
msgid ""
"You may define the allowed values for a particular property @samp{:Xyz:} by "
"setting a property @samp{:Xyz_ALL:}.  This special property is @emph"
"{inherited}, so if you set it in a level 1 entry, it will apply to the "
"entire tree.  When allowed values are defined, setting the corresponding "
"property becomes easier and is less prone to typing errors.  For the example "
"with the CD collection, we can predefine publishers and the number of disks "
"in a box like this:"
msgstr ""
"Se pueden definir los valores permitidos para una propiedad particular\n"
"@samp{:Xyz:} asignando un propiedad @samp{:Xyz_ALL:}. Esta propiedad\n"
"especial es @emph{heredada}, as@'{@dotless{i}} si se asigna en una\n"
"entrada de nivel 1, se aplicar@'a al @'arbol entero. Cuando los\n"
"valores permitidos est@'an definidos, asignar la propiedad\n"
"correspondiente llega a ser f@'acil y es menos propensa a\n"
"errores. Para el ejemplo de la colecci@'on de CDs, se pueden\n"
"predefinir las discogr@'aficas y el n@'umero de discos en una caja\n"
"como esta:"

#. type: smallexample
#: orgguide.texi:1263
#, fuzzy, no-wrap
msgid ""
"* CD collection\n"
"  :PROPERTIES:\n"
"  :NDisks_ALL:  1 2 3 4\n"
"  :Publisher_ALL: \"Deutsche Grammophon\" Philips EMI\n"
"  :END:\n"
msgstr ""
"* Colecci@'on de CDs\n"
"   :PROPERTIES:\n"
"   :Discos_ALL: 1 2 3 4\n"
"   :Discogr@'afica_ALL: \"Deutsche Grammophon\" Philips EMI\n"
"   :END:\n"

#. type: Plain text
#: orgguide.texi:1265
msgid "or globally using @code{org-global-properties}, or file-wide like this:"
msgstr ""
"o globalmente usando @code{org-global-properties}, o un fichero amplio\n"
"como este:"

#. type: smallexample
#: orgguide.texi:1267
#, no-wrap
msgid "#+PROPERTY: NDisks_ALL 1 2 3 4\n"
msgstr "#+PROPERTY: Discos_ALL 1 2 3 4\n"

#. type: item
#: orgguide.texi:1270
#, no-wrap
msgid "C-c C-x p"
msgstr "C-c C-x p"

#. type: table
#: orgguide.texi:1272
msgid "Set a property.  This prompts for a property name and a value."
msgstr ""
"Asigna una propiedad. Se solicitar@'a un nombre y un valor para la propiedad."

#. type: item
#: orgguide.texi:1272
#, no-wrap
msgid "C-c C-c d"
msgstr "C-c C-c d"

#. type: table
#: orgguide.texi:1274
msgid "Remove a property from the current entry."
msgstr "Elimina una propiedad de la entrada actual."

#. type: Plain text
#: orgguide.texi:1280
msgid ""
"To create sparse trees and special lists with selection based on properties, "
"the same commands are used as for tag searches (@pxref{Tag searches}).  The "
"syntax for the search string is described in @ref{Matching tags and "
"properties}."
msgstr ""
"Para crear @'arboles expandidos y listas especiales con selecci@'on\n"
"basada en propiedades, los mismos comandos son usados para buscar\n"
"marcas (@pxref{Buscando marcas}). La sintaxis completa para la\n"
"b@'usqueda de cadenas es descrita en @ref{Coincidiendo marcas y\n"
"propiedades}."

#. type: Plain text
#: orgguide.texi:1289
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Properties-and-Columns."
"html#Properties-and-Columns, Chapter 7 of the manual}@* @uref{http://orgmode."
"org/worg/org-tutorials/org-column-view-tutorial.php,Bastien Guerry's column "
"view tutorial}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:1296
msgid ""
"To assist project planning, TODO items can be labeled with a date and/or a "
"time.  The specially formatted string carrying the date and time information "
"is called a @emph{timestamp} in Org mode."
msgstr ""

#. type: Plain text
#: orgguide.texi:1314
#, fuzzy
msgid ""
"A timestamp is a specification of a date (possibly with a time or a range of "
"times) in a special format, either @samp{<2003-09-16 Tue>} or @samp"
"{<2003-09-16 Tue 09:39>} or @samp{<2003-09-16 Tue 12:00-12:30>}.  A "
"timestamp can appear anywhere in the headline or body of an Org tree entry.  "
"Its presence causes entries to be shown on specific dates in the agenda "
"(@pxref{Weekly/daily agenda}).  We distinguish:"
msgstr ""
"Una marca de tiempo es una especificaci@'on de una fecha (posiblemente\n"
"con un tiempo o un rango de tiempos) en un formato especial. Como\n"
"@samp{<2003-09-16 Jue>} o @samp{<2003-09-16 Jue 09:39>} o\n"
"@samp{<2003-09-16 Jue 12:00-12:30>}. Una marca de tiempo puede\n"
"aparecer en cualquier lugar, titular o cuerpo de una entrada del\n"
"@'abol Org. Su presencia causa que la entrada sea mostrada en una\n"
"fecha espec@'{@dotless{i}}fica de la agenda (@pxref{Agenda\n"
"semanal/diaria}). Distinguimos:"

#. type: Plain text
#: orgguide.texi:1318
msgid ""
"A simple timestamp just assigns a date/time to an item.  This is just like "
"writing down an appointment or event in a paper agenda."
msgstr ""

#. type: smallexample
#: orgguide.texi:1324
#, no-wrap
msgid ""
"* Meet Peter at the movies\n"
"  <2006-11-01 Wed 19:15>\n"
"* Discussion on climate change\n"
"  <2006-11-02 Thu 20:00-22:00>\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1331
msgid ""
"A timestamp may contain a @emph{repeater interval}, indicating that it "
"applies not only on the given date, but again and again after a certain "
"interval of N days (d), weeks (w), months (m), or years (y).  The following "
"will show up in the agenda every Wednesday:"
msgstr ""

#. type: smallexample
#: orgguide.texi:1334
#, no-wrap
msgid ""
"* Pick up Sam at school\n"
"  <2007-05-16 Wed 12:30 +1w>\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1340
msgid ""
"For more complex date specifications, Org mode supports using the special "
"sexp diary entries implemented in the Emacs calendar/diary package.  For "
"example"
msgstr ""

#. type: smallexample
#: orgguide.texi:1343
#, no-wrap
msgid ""
"* The nerd meeting on every 2nd Thursday of the month\n"
"  <%%(diary-float t 4 2)>\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1347
msgid "Two timestamps connected by @samp{--} denote a range."
msgstr ""

#. type: smallexample
#: orgguide.texi:1350
#, no-wrap
msgid ""
"** Meeting in Amsterdam\n"
"   <2004-08-23 Mon>--<2004-08-26 Thu>\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1356
msgid ""
"Just like a plain timestamp, but with square brackets instead of angular "
"ones.  These timestamps are inactive in the sense that they do @emph{not} "
"trigger an entry to show up in the agenda."
msgstr ""

#. type: smallexample
#: orgguide.texi:1360
#, no-wrap
msgid ""
"* Gillian comes late for the fifth time\n"
"  [2006-11-01 Wed]\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1369
msgid ""
"For Org mode to recognize timestamps, they need to be in the specific "
"format.  All commands listed below produce timestamps in the correct format."
msgstr ""

#. type: item
#: orgguide.texi:1371
#, fuzzy, no-wrap
msgid "C-c ."
msgstr "C-c /"

#. type: table
#: orgguide.texi:1378
msgid ""
"Prompt for a date and insert a corresponding timestamp.  When the cursor is "
"at an existing timestamp in the buffer, the command is used to modify this "
"timestamp instead of inserting a new one.  When this command is used twice "
"in succession, a time range is inserted.  With a prefix, also add the "
"current time."
msgstr ""

#. type: item
#: orgguide.texi:1378
#, fuzzy, no-wrap
msgid "C-c !"
msgstr "C-c /"

#. type: table
#: orgguide.texi:1382
msgid ""
"Like @kbd{C-c .}, but insert an inactive timestamp that will not cause an "
"agenda entry."
msgstr ""

#. type: item
#: orgguide.texi:1382
#, fuzzy, no-wrap
msgid "S-@key{left}@r{/}@key{right}"
msgstr "M-S-@key{left}@r{/}@key{right}"

#. type: table
#: orgguide.texi:1385
msgid "Change date at cursor by one day."
msgstr ""

#. type: item
#: orgguide.texi:1385
#, fuzzy, no-wrap
msgid "S-@key{up}@r{/}@key{down}"
msgstr "M-S-@key{up}@r{/}@key{down}"

#. type: table
#: orgguide.texi:1391
msgid ""
"Change the item under the cursor in a timestamp.  The cursor can be on a "
"year, month, day, hour or minute.  When the timestamp contains a time range "
"like @samp{15:30-16:30}, modifying the first time will also shift the "
"second, shifting the time block with constant length.  To change the length, "
"modify the second time."
msgstr ""

#. type: Plain text
#: orgguide.texi:1398
msgid ""
"When Org mode prompts for a date/time, it will accept any string containing "
"some date and/or time information, and intelligently interpret the string, "
"deriving defaults for unspecified information from the current date and "
"time.  You can also select a date in the pop-up calendar.  See the manual "
"for more information on how exactly the date/time prompt works."
msgstr ""

#. type: Plain text
#: orgguide.texi:1403
msgid "A timestamp may be preceded by special keywords to facilitate planning:"
msgstr ""

#. type: Plain text
#: orgguide.texi:1407
msgid ""
"Meaning: the task (most likely a TODO item, though not necessarily) is "
"supposed to be finished on that date."
msgstr ""

#. type: item
#: orgguide.texi:1408 orgguide.texi:1979
#, fuzzy, no-wrap
msgid "C-c C-d"
msgstr "C-c C-c d"

#. type: table
#: orgguide.texi:1411
msgid ""
"Insert @samp{DEADLINE} keyword along with a stamp, in the line following the "
"headline."
msgstr ""

#. type: Plain text
#: orgguide.texi:1418
msgid ""
"On the deadline date, the task will be listed in the agenda.  In addition, "
"the agenda for @emph{today} will carry a warning about the approaching or "
"missed deadline, starting @code{org-deadline-warning-days} before the due "
"date, and continuing until the entry is marked DONE.  An example:"
msgstr ""

#. type: smallexample
#: orgguide.texi:1423
#, no-wrap
msgid ""
"*** TODO write article about the Earth for the Guide\n"
"    The editor in charge is [[bbdb:Ford Prefect]]\n"
"    DEADLINE: <2004-02-29 Sun>\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1431
msgid ""
"Meaning: you are @i{planning to start working} on that task on the given "
"date@footnote{This is quite different from what is normally understood by @i"
"{scheduling a meeting}, which is done in Org-mode by just inserting a time "
"stamp without keyword.}."
msgstr ""

#. type: item
#: orgguide.texi:1433 orgguide.texi:1976
#, fuzzy, no-wrap
msgid "C-c C-s"
msgstr "C-c C-n"

#. type: table
#: orgguide.texi:1436
msgid ""
"Insert @samp{SCHEDULED} keyword along with a stamp, in the line following "
"the headline."
msgstr ""

#. type: Plain text
#: orgguide.texi:1444
msgid ""
"The headline will be listed under the given date@footnote{It will still be "
"listed on that date after it has been marked DONE.  If you don't like this, "
"set the variable @code{org-agenda-skip-scheduled-if-done}.}.  In addition, a "
"reminder that the scheduled date has passed will be present in the "
"compilation for @emph{today}, until the entry is marked DONE.  I.e.@: the "
"task will automatically be forwarded until completed."
msgstr ""

#. type: smallexample
#: orgguide.texi:1448
#, no-wrap
msgid ""
"*** TODO Call Trillian for a date on New Years Eve.\n"
"    SCHEDULED: <2004-12-25 Sat>\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1453
msgid ""
"Some tasks need to be repeated again and again.  Org mode helps to organize "
"such tasks using a so-called repeater in a DEADLINE, SCHEDULED, or plain "
"timestamp.  In the following example"
msgstr ""

#. type: smallexample
#: orgguide.texi:1456
#, no-wrap
msgid ""
"** TODO Pay the rent\n"
"   DEADLINE: <2005-10-01 Sat +1m>\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1461
msgid ""
"the @code{+1m} is a repeater; the intended interpretation is that the task "
"has a deadline on <2005-10-01> and repeats itself every (one) month starting "
"from that time."
msgstr ""

#. type: Plain text
#: orgguide.texi:1467
msgid ""
"Org mode allows you to clock the time you spend on specific tasks in a "
"project."
msgstr ""

#. type: item
#: orgguide.texi:1469
#, fuzzy, no-wrap
msgid "C-c C-x C-i"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:1474
msgid ""
"Start the clock on the current item (clock-in).  This inserts the CLOCK "
"keyword together with a timestamp.  When called with a @kbd{C-u} prefix "
"argument, select the task from a list of recently clocked tasks."
msgstr ""

#. type: item
#: orgguide.texi:1474
#, fuzzy, no-wrap
msgid "C-c C-x C-o"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:1479
msgid ""
"Stop the clock (clock-out).  This inserts another timestamp at the same "
"location where the clock was last started.  It also directly computes the "
"resulting time in inserts it after the time range as @samp{=> HH:MM}."
msgstr ""

#. type: item
#: orgguide.texi:1479
#, fuzzy, no-wrap
msgid "C-c C-x C-e"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:1481
msgid "Update the effort estimate for the current clock task."
msgstr ""

#. type: item
#: orgguide.texi:1481
#, fuzzy, no-wrap
msgid "C-c C-x C-x"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:1484
msgid ""
"Cancel the current clock.  This is useful if a clock was started by mistake, "
"or if you ended up working on something else."
msgstr ""

#. type: item
#: orgguide.texi:1484
#, fuzzy, no-wrap
msgid "C-c C-x C-j"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:1488
msgid ""
"Jump to the entry that contains the currently running clock.  With a @kbd{C-"
"u} prefix arg, select the target task from a list of recently clocked tasks."
msgstr ""

#. type: item
#: orgguide.texi:1488
#, fuzzy, no-wrap
msgid "C-c C-x C-r"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:1492
msgid ""
"Insert a dynamic block containing a clock report as an Org-mode table into "
"the current file.  When the cursor is at an existing clock table, just "
"update it."
msgstr ""

#. type: smallexample
#: orgguide.texi:1495
#, no-wrap
msgid ""
"#+BEGIN: clocktable :maxlevel 2 :emphasize nil :scope file\n"
"#+END: clocktable\n"
msgstr ""

#. type: table
#: orgguide.texi:1498
msgid ""
"For details about how to customize this view, see @uref{http://orgmode.org/"
"manual/Clocking-work-time.html#Clocking-work-time,the manual}."
msgstr ""

#. type: table
#: orgguide.texi:1501
msgid ""
"Update dynamic block at point.  The cursor needs to be in the @code{#+BEGIN} "
"line of the dynamic block."
msgstr ""

#. type: Plain text
#: orgguide.texi:1506
msgid ""
"The @kbd{l} key may be used in the timeline (@pxref{Timeline}) and in the "
"agenda (@pxref{Weekly/daily agenda}) to show which tasks have been worked on "
"or closed during a day."
msgstr ""
"La tecla @kbd{l} puede ser usada en la l@'{@dotless{i}}nea de tiempo\n"
"(@pxref{L@'{@dotless{i}}nea de tiempo}) y en la agenda (@pxref{Agenda\n"
"semanal/diaria}) para mostrar las tareas en las que se trabajar@'a o\n"
"cerrar@'an durante el d@'{@dotless{i}}a."

#. type: Plain text
#: orgguide.texi:1513
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Dates-and-Times.html#Dates-and-"
"Times, Chapter 8 of the manual}@* @uref{http://members.optusnet.com.au/"
"~charles57/GTD/org_dates/, Charles Cave's Date and Time tutorial}@* @uref"
"{http://doc.norang.ca/org-mode.html#Clocking, Bernt Hansen's clocking "
"workflow}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:1523
msgid ""
"An important part of any organization system is the ability to quickly "
"capture new ideas and tasks, and to associate reference material with them.  "
"Org defines a capture process to create tasks.  It stores files related to a "
"task (@i{attachments}) in a special directory.  Once in the system, tasks "
"and projects need to be moved around.  Moving completed project trees to an "
"archive file keeps the system compact and fast."
msgstr ""

#. type: Plain text
#: orgguide.texi:1537
msgid ""
"Org's method for capturing new items is heavily inspired by John Wiegley "
"excellent remember package.  It lets you store quick notes with little "
"interruption of your work flow.  Org lets you define templates for new "
"entries and associate them with different targets for storing notes."
msgstr ""

#. type: Plain text
#: orgguide.texi:1552
msgid ""
"The following customization sets a default target@footnote{Using capture "
"templates, you can define more fine-grained capture locations, see @ref"
"{Capture templates}.} file for notes, and defines a global key@footnote"
"{Please select your own key, @kbd{C-c c} is only a suggestion.} for "
"capturing new stuff."
msgstr ""
"............... @footnote{Usando plantillas de capturas\n"
".......@ref{Plantillas de capturas}.} ............."

#. type: example
#: orgguide.texi:1556
#, no-wrap
msgid ""
"(setq org-default-notes-file (concat org-directory \"/notes.org\"))\n"
"(define-key global-map \"\\C-cc\" 'org-capture)\n"
msgstr ""

#. type: item
#: orgguide.texi:1562
#, fuzzy, no-wrap
msgid "C-c c"
msgstr "C-c C-c"

#. type: table
#: orgguide.texi:1565
msgid ""
"Start a capture process.  You will be placed into a narrowed indirect buffer "
"to edit the item."
msgstr ""

#. type: table
#: orgguide.texi:1569
msgid ""
"Once you are done entering information into the capture buffer, @kbd{C-c C-"
"c} will return you to the window configuration before the capture process, "
"so that you can resume your work without further distraction."
msgstr ""

#. type: table
#: orgguide.texi:1571
#, fuzzy
msgid ""
"Finalize by moving the entry to a refile location (@pxref{Refile and copy})."
msgstr ""
"Finaliza moviendo la entrada a una nueva localizaci@'on\n"
"(@pxref{Moviendo notas}). "

#. type: item
#: orgguide.texi:1571
#, fuzzy, no-wrap
msgid "C-c C-k"
msgstr "C-c C-n"

#. type: table
#: orgguide.texi:1573
msgid "Abort the capture process and return to the previous state."
msgstr ""

#. type: Plain text
#: orgguide.texi:1583
msgid ""
"You can use templates to generate different types of capture notes, and to "
"store them in different places.  For example, if you would like to store new "
"tasks under a heading @samp{Tasks} in file @file{TODO.org}, and journal "
"entries in a date tree in @file{journal.org} you could use:"
msgstr ""

#. type: smallexample
#: orgguide.texi:1590
#, no-wrap
msgid ""
"(setq org-capture-templates\n"
" '((\"t\" \"Todo\" entry (file+headline \"~/org/gtd.org\" \"Tasks\")\n"
"        \"* TODO %?\\n  %i\\n  %a\")\n"
"   (\"j\" \"Journal\" entry (file+datetree \"~/org/journal.org\")\n"
"        \"* %?\\nEntered on %U\\n  %i\\n  %a\")))\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1597
msgid ""
"template, the second is a short description.  Then follows the type of the "
"entry and a definition of the target location for storing the note.  "
"Finally, the template itself, a string with %-escapes to fill in information "
"based on time and context."
msgstr ""

#. type: Plain text
#: orgguide.texi:1600
msgid ""
"When you call @kbd{M-x org-capture}, Org will prompt for a key to select the "
"template (if you have more than one template) and then prepare the buffer "
"like"
msgstr ""

#. type: smallexample
#: orgguide.texi:1603
#, no-wrap
msgid ""
"* TODO\n"
"  [[file:@var{link to where you were when initiating capture}]]\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1610
msgid ""
"During expansion of the template, special @kbd{%}-escapes@footnote{If you "
"need one of these sequences literally, escape the @kbd{%} with a backslash.} "
"allow dynamic insertion of content.  Here is a small selection of the "
"possibilities, consult the manual for more."
msgstr ""

#. type: smallexample
#: orgguide.texi:1616
#, no-wrap
msgid ""
"%a          @r{annotation, normally the link created with @code{org-store-link}}\n"
"%i          @r{initial content, the region when remember is called with C-u.}\n"
"%t          @r{timestamp, date only}\n"
"%T          @r{timestamp with date and time}\n"
"%u, %U      @r{like the above, but inactive timestamps}\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1625
msgid ""
"When reviewing the captured data, you may want to refile or copy some of the "
"entries into a different list, for example into a project.  Cutting, finding "
"the right location, and then pasting the note is cumbersome.  To simplify "
"this process, you can use the following special command:"
msgstr ""

#. type: item
#: orgguide.texi:1627
#, fuzzy, no-wrap
msgid "C-c M-x"
msgstr "C-c -"

#. type: table
#: orgguide.texi:1630
msgid ""
"Copy the entry or region at point.  This command behaves like @code{org-"
"refile}, except that the original note will not be deleted."
msgstr ""

#. type: table
#: orgguide.texi:1637
msgid ""
"Refile the entry or region at point.  This command offers possible locations "
"for refiling the entry and lets you select one with completion.  The item "
"(or all items in the region) is filed below the target heading as a subitem."
"@* By default, all level 1 headlines in the current buffer are considered to "
"be targets, but you can have more complex definitions across a number of "
"files.  See the variable @code{org-refile-targets} for details."
msgstr ""

#. type: item
#: orgguide.texi:1637
#, fuzzy, no-wrap
msgid "C-u C-c C-w"
msgstr "C-c C-w"

#. type: table
#: orgguide.texi:1639
msgid "Use the refile interface to jump to a heading."
msgstr ""

#. type: item
#: orgguide.texi:1639
#, fuzzy, no-wrap
msgid "C-u C-u C-c C-w"
msgstr "C-c C-w"

#. type: table
#: orgguide.texi:1641
msgid "Jump to the location where @code{org-refile} last moved a tree to."
msgstr ""

#. type: Plain text
#: orgguide.texi:1652
msgid ""
"When a project represented by a (sub)tree is finished, you may want to move "
"the tree out of the way and to stop it from contributing to the agenda.  "
"Archiving is important to keep your working files compact and global "
"searches like the construction of agenda views fast.  The most common "
"archiving action is to move a project tree to another file, the archive file."
msgstr ""

#. type: item
#: orgguide.texi:1654
#, fuzzy, no-wrap
msgid "C-c C-x C-a"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:1657
msgid ""
"Archive the current entry using the command specified in the variable @code"
"{org-archive-default-command}."
msgstr ""

#. type: item
#: orgguide.texi:1657
#, no-wrap
msgid "C-c C-x C-s@ @r{or short} @ C-c $"
msgstr ""

#. type: table
#: orgguide.texi:1660
msgid ""
"Archive the subtree starting at the cursor position to the location given by "
"@code{org-archive-location}."
msgstr ""

#. type: Plain text
#: orgguide.texi:1668
msgid ""
"The default archive location is a file in the same directory as the current "
"file, with the name derived by appending @file{_archive} to the current file "
"name.  For information and examples on how to change this, see the "
"documentation string of the variable @code{org-archive-location}.  There is "
"also an in-buffer option for setting this variable, for example"
msgstr ""

#. type: smallexample
#: orgguide.texi:1671
#, no-wrap
msgid "#+ARCHIVE: %s_done::\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1680
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Capture-_002d-Refile-_002d-Archive."
"html#Capture-_002d-Refile-_002d-Archive, Chapter 9 of the manual}@* @uref"
"{http://members.optusnet.com.au/~charles57/GTD/remember.html, Charles Cave's "
"remember tutorial}@* @uref{http://orgmode.org/worg/org-tutorials/org-"
"protocol-custom-handler.php, Sebastian Rose's tutorial for capturing from a "
"web browser}}@uref{}@*"
msgstr ""

#. type: Plain text
#: orgguide.texi:1689
msgid ""
"Due to the way Org works, TODO items, time-stamped items, and tagged "
"headlines can be scattered throughout a file or even a number of files.  To "
"get an overview of open action items, or of events that are important for a "
"particular date, this information must be collected, sorted and displayed in "
"an organized way.  There are several different views, see below."
msgstr ""

#. type: Plain text
#: orgguide.texi:1697
msgid ""
"The extracted information is displayed in a special @emph{agenda buffer}.  "
"This buffer is read-only, but provides commands to visit the corresponding "
"locations in the original Org files, and even to edit these files remotely.  "
"Remote editing from the agenda buffer means, for example, that you can "
"change the dates of deadlines and appointments from the agenda buffer.  The "
"commands available in the Agenda buffer are listed in @ref{Agenda commands}."
msgstr "......................@ref{Comandos de la agenda}."

#. type: Plain text
#: orgguide.texi:1712
msgid ""
"The information to be shown is normally collected from all @emph{agenda "
"files}, the files listed in the variable @code{org-agenda-files}."
msgstr ""

#. type: item
#: orgguide.texi:1714
#, fuzzy, no-wrap
msgid "C-c ["
msgstr "C-c /"

#. type: table
#: orgguide.texi:1718
msgid ""
"Add current file to the list of agenda files.  The file is added to the "
"front of the list.  If it was already in the list, it is moved to the "
"front.  With a prefix argument, file is added/moved to the end."
msgstr ""

#. type: item
#: orgguide.texi:1718
#, fuzzy, no-wrap
msgid "C-c ]"
msgstr "C-c /"

#. type: table
#: orgguide.texi:1720
msgid "Remove current file from the list of agenda files."
msgstr ""

#. type: item
#: orgguide.texi:1720
#, fuzzy, no-wrap
msgid "C-,"
msgstr "C-c ,"

#. type: table
#: orgguide.texi:1722
msgid "Cycle through agenda file list, visiting one file after the other."
msgstr ""

#. type: section
#: orgguide.texi:1725
#, fuzzy, no-wrap
msgid "The agenda dispatcher"
msgstr "Despachador de agenda"

#. type: Plain text
#: orgguide.texi:1730
msgid ""
"The views are created through a dispatcher, which should be bound to a "
"global key---for example @kbd{C-c a} (@pxref{Installation}).  After pressing "
"@kbd{C-c a}, an additional letter is required to execute a command:"
msgstr "............................. (@pxref{Instalaci@'on}). ....."

#. type: item
#: orgguide.texi:1731
#, no-wrap
msgid "a"
msgstr ""

#. type: table
#: orgguide.texi:1733
msgid "The calendar-like agenda (@pxref{Weekly/daily agenda})."
msgstr "La agenda como calendario (@pxref{Agenda semanal/diaria})."

#. type: item
#: orgguide.texi:1733
#, no-wrap
msgid "t @r{/} T"
msgstr ""

#. type: table
#: orgguide.texi:1735
msgid "A list of all TODO items (@pxref{Global TODO list})."
msgstr "Una lista de todos los items TODO (@pxref{Lista global TODO})."

#. type: item
#: orgguide.texi:1735
#, no-wrap
msgid "m @r{/} M"
msgstr ""

#. type: table
#: orgguide.texi:1738
msgid ""
"A list of headlines matching a TAGS expression (@pxref{Matching tags and "
"properties})."
msgstr ""
"Una lista de titulares coincidentes con la expresi'on TAGS (@pxref"
"{Coincidiendo marcas y propiedades})."

#. type: item
#: orgguide.texi:1738
#, no-wrap
msgid "L"
msgstr ""

#. type: table
#: orgguide.texi:1740
msgid "The timeline view for the current buffer (@pxref{Timeline})."
msgstr ""
"La vista de la l@'{@dotless{i}}nea de tiempo para el buffer actual\n"
"@pxref{L@'{@dotless{i}}nea de tiempo})."

#. type: item
#: orgguide.texi:1740 orgguide.texi:1940
#, no-wrap
msgid "s"
msgstr ""

#. type: table
#: orgguide.texi:1743
msgid ""
"A list of entries selected by a boolean expression of keywords and/or "
"regular expressions that must or must not occur in the entry."
msgstr ""

#. type: subsection
#: orgguide.texi:1757
#, fuzzy, no-wrap
msgid "The weekly/daily agenda"
msgstr "Agenda semanal/diaria"

#. type: Plain text
#: orgguide.texi:1761
msgid ""
"The purpose of the weekly/daily @emph{agenda} is to act like a page of a "
"paper agenda, showing all the tasks for the current week or day."
msgstr ""

#. type: item
#: orgguide.texi:1763
#, fuzzy, no-wrap
msgid "C-c a a"
msgstr "C-c a t"

#. type: table
#: orgguide.texi:1766
msgid ""
"Compile an agenda for the current week from a list of Org files.  The agenda "
"shows the entries for each day."
msgstr ""

#. type: Plain text
#: orgguide.texi:1771
msgid ""
"Emacs contains the calendar and diary by Edward M. Reingold.  Org-mode "
"understands the syntax of the diary and allows you to use diary sexp entries "
"directly in Org files:"
msgstr ""

#. type: smallexample
#: orgguide.texi:1779
#, no-wrap
msgid ""
"* Birthdays and similar stuff\n"
"#+CATEGORY: Holiday\n"
"%%(org-calendar-holiday)   ; special function for holiday names\n"
"#+CATEGORY: Ann\n"
"%%(diary-anniversary  5 14 1956)@footnote{Note that the order of the arguments (month, day, year) depends on the setting of @code{calendar-date-style}.} Arthur Dent is %d years old\n"
"%%(diary-anniversary 10  2 1869) Mahatma Gandhi would be %d years old\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:1784
msgid ""
"Org can interact with Emacs appointments notification facility.  To add all "
"the appointments of your agenda files, use the command @code{org-agenda-to-"
"appt}.  See the docstring for details."
msgstr ""

#. type: subsection
#: orgguide.texi:1786
#, fuzzy, no-wrap
msgid "The global TODO list"
msgstr "Lista global TODO"

#. type: Plain text
#: orgguide.texi:1792
msgid ""
"The global TODO list contains all unfinished TODO items formatted and "
"collected into a single place.  Remote editing of TODO items lets you can "
"change the state of a TODO entry with a single key press.  The commands "
"available in the TODO list are described in @ref{Agenda commands}."
msgstr "..............@ref{Comandos de la agenda}."

#. type: table
#: orgguide.texi:1797
msgid ""
"Show the global TODO list.  This collects the TODO items from all agenda "
"files (@pxref{Agenda Views}) into a single buffer."
msgstr ""
"Muestra la lista global TODO. Esta colecci@'on de items TODO de todos\n"
"los archivos de la agenda (@pxref{Vistas de la Agenda}) en un @'unico\n"
"buffer."

#. type: item
#: orgguide.texi:1797
#, fuzzy, no-wrap
msgid "C-c a T"
msgstr "C-c a t"

#. type: table
#: orgguide.texi:1799
msgid "Like the above, but allows selection of a specific TODO keyword."
msgstr ""

#. type: Plain text
#: orgguide.texi:1810
msgid ""
"If headlines in the agenda files are marked with @emph{tags} (@pxref{Tags}), "
"or have properties (@pxref{Properties}), you can select headlines based on "
"this metadata and collect them into an agenda buffer.  The match syntax "
"described here also applies when creating sparse trees with @kbd{C-c / m}.  "
"The commands available in the tags list are described in @ref{Agenda "
"commands}."
msgstr ""
"................................ (@pxref{Etiquetas}), .......\n"
"....... .... (@pxref{Propiedades}),\n"
"..,.... .. .... ...... ...... @ref{Comandos de la agenda}."

#. type: table
#: orgguide.texi:1818
#, fuzzy
msgid ""
"Produce a list of all headlines that match a given set of tags.  The command "
"prompts for a selection criterion, which is a boolean logic expression with "
"tags, like @samp{+work+urgent-withboss} or @samp{work|home} (@pxref{Tags}).  "
"If you often need a specific search, define a custom command for it (@pxref"
"{Agenda dispatcher})."
msgstr ""
".............. ................ .\n"
".............. ............. . (@pxref"
"{Etiquetas}). ....... .... .... .... .... \n"

#. type: table
#: orgguide.texi:1820
msgid "Like @kbd{C-c a m}, but only select headlines that are also TODO items."
msgstr ""

#. type: subsubheading
#: orgguide.texi:1822
#, no-wrap
msgid "Match syntax"
msgstr ""

#. type: Plain text
#: orgguide.texi:1832
msgid ""
"A search string can use Boolean operators @samp{&} for AND and @samp{|} for "
"OR.  @samp{&} binds more strongly than @samp{|}.  Parentheses are currently "
"not implemented.  Each element in the search is either a tag, a regular "
"expression matching tags, or an expression like @code{PROPERTY OPERATOR "
"VALUE} with a comparison operator, accessing a property value.  Each element "
"may be preceded by @samp{-}, to select against it, and @samp{+} is syntactic "
"sugar for positive selection.  The AND operator @samp{&} is optional when "
"@samp{+} or @samp{-} is present.  Here are some examples, using only tags."
msgstr ""

#. type: item
#: orgguide.texi:1834
#, no-wrap
msgid "+work-boss"
msgstr ""

#. type: table
#: orgguide.texi:1837
msgid ""
"Select headlines tagged @samp{:work:}, but discard those also tagged @samp{:"
"boss:}."
msgstr ""

#. type: item
#: orgguide.texi:1837
#, no-wrap
msgid "work|laptop"
msgstr ""

#. type: table
#: orgguide.texi:1839
msgid "Selects lines tagged @samp{:work:} or @samp{:laptop:}."
msgstr ""

#. type: item
#: orgguide.texi:1839
#, no-wrap
msgid "work|laptop+night"
msgstr ""

#. type: table
#: orgguide.texi:1842
msgid ""
"Like before, but require the @samp{:laptop:} lines to be tagged also @samp{:"
"night:}."
msgstr ""

#. type: Plain text
#: orgguide.texi:1846
msgid ""
"You may also test for properties at the same time as matching tags, see the "
"manual for more information."
msgstr ""

#. type: subsection
#: orgguide.texi:1848
#, no-wrap
msgid "Timeline for a single file"
msgstr "L@'{@dotless{i}}nea de tiempo para un simple archivo"

#. type: Plain text
#: orgguide.texi:1853
msgid ""
"The timeline summarizes all time-stamped items from a single Org mode file "
"in a @emph{time-sorted view}.  The main purpose of this command is to give "
"an overview over events in a project."
msgstr ""

#. type: item
#: orgguide.texi:1855
#, fuzzy, no-wrap
msgid "C-c a L"
msgstr "C-c a t"

#. type: table
#: orgguide.texi:1859
msgid ""
"Show a time-sorted view of the Org file, with all time-stamped items.  When "
"called with a @kbd{C-u} prefix, all unfinished TODO entries (scheduled or "
"not) are also listed under the current date."
msgstr ""

#. type: Plain text
#: orgguide.texi:1866
msgid ""
"This agenda view is a general text search facility for Org mode entries.  It "
"is particularly useful to find notes."
msgstr ""

#. type: item
#: orgguide.texi:1868
#, fuzzy, no-wrap
msgid "C-c a s"
msgstr "C-c a t"

#. type: table
#: orgguide.texi:1871
msgid ""
"This is a special search that lets you select entries by matching a "
"substring or specific words using a boolean logic."
msgstr ""

#. type: Plain text
#: orgguide.texi:1880
msgid ""
"For example, the search string @samp{computer equipment} will find entries "
"that contain @samp{computer equipment} as a substring.  Search view can also "
"search for specific keywords in the entry, using Boolean logic.  The search "
"string @samp{+computer +wifi -ethernet -@{8\\.11[bg]@}} will search for note "
"entries that contain the keywords @code{computer} and @code{wifi}, but not "
"the keyword @code{ethernet}, and which are also not matched by the regular "
"expression @code{8\\.11[bg]}, meaning to exclude both 8.11b and 8.11g."
msgstr ""

#. type: Plain text
#: orgguide.texi:1883
msgid ""
"Note that in addition to the agenda files, this command will also search the "
"files listed in @code{org-agenda-text-search-extra-files}."
msgstr ""

#. type: section
#: orgguide.texi:1885
#, no-wrap
msgid "Commands in the agenda buffer"
msgstr ""

#. type: Plain text
#: orgguide.texi:1892
msgid ""
"Entries in the agenda buffer are linked back to the Org file or diary file "
"where they originate.  Commands are provided to show and jump to the "
"original entry location, and to edit the Org files ``remotely'' from the "
"agenda buffer.  This is just a selection of the many commands, explore the "
"@code{Agenda} menu and the manual for a complete list."
msgstr ""

#. type: table
#: orgguide.texi:1895
#, fuzzy
msgid "@tsubheading{Motion}"
msgstr "@tsubheading{Edici@'on de filas y columnas}"

#. type: item
#: orgguide.texi:1895
#, no-wrap
msgid "n"
msgstr ""

#. type: table
#: orgguide.texi:1897
msgid "Next line (same as @key{up} and @kbd{C-p})."
msgstr ""

#. type: item
#: orgguide.texi:1897
#, no-wrap
msgid "p"
msgstr ""

#. type: table
#: orgguide.texi:1900
msgid ""
"Previous line (same as @key{down} and @kbd{C-n}).  @tsubheading{View/Go to "
"Org file}"
msgstr ""

#. type: item
#: orgguide.texi:1900
#, no-wrap
msgid "mouse-3"
msgstr ""

#. type: key{#1}
#: orgguide.texi:1901
#, no-wrap
msgid "SPC"
msgstr ""

#. type: table
#: orgguide.texi:1906
msgid ""
"Display the original location of the item in another window.  With prefix "
"arg, make sure that the entire entry is made visible in the outline, not "
"only the heading."
msgstr ""

#. type: table
#: orgguide.texi:1910
msgid ""
"Go to the original location of the item in another window.  Under Emacs 22, "
"@kbd{mouse-1} will also work for this."
msgstr ""

#. type: table
#: orgguide.texi:1913
msgid "Go to the original location of the item and delete other windows."
msgstr ""

#. type: table
#: orgguide.texi:1915
#, fuzzy
msgid "@tsubheading{Change display}"
msgstr "@tsubheading{Edici@'on de filas y columnas}"

#. type: item
#: orgguide.texi:1915
#, no-wrap
msgid "o"
msgstr ""

#. type: table
#: orgguide.texi:1918
msgid "Delete other windows."
msgstr ""

#. type: item
#: orgguide.texi:1918
#, no-wrap
msgid "d @r{/} w"
msgstr ""

#. type: table
#: orgguide.texi:1921
msgid "Switch to day/week view."
msgstr ""

#. type: item
#: orgguide.texi:1921
#, no-wrap
msgid "f @r{and} b"
msgstr ""

#. type: table
#: orgguide.texi:1926
msgid ""
"Go forward/backward in time to display the following @code{org-agenda-"
"current-span} days.  For example, if the display covers a week, switch to "
"the following/previous week."
msgstr ""

#. type: item
#: orgguide.texi:1926
#, no-wrap
msgid "."
msgstr ""

#. type: table
#: orgguide.texi:1929
msgid "Go to today."
msgstr ""

#. type: item
#: orgguide.texi:1929
#, no-wrap
msgid "j"
msgstr ""

#. type: table
#: orgguide.texi:1932
msgid "Prompt for a date and go there."
msgstr ""

#. type: item
#: orgguide.texi:1932
#, no-wrap
msgid "v l @ @r{or short} @ l"
msgstr ""

#. type: table
#: orgguide.texi:1938
msgid ""
"Toggle Logbook mode.  In Logbook mode, entries that were marked DONE while "
"logging was on (variable @code{org-log-done}) are shown in the agenda, as "
"are entries that have been clocked on that day.  When called with a @kbd{C-"
"u} prefix, show all possible logbook entries, including state changes."
msgstr ""

#. type: item
#: orgguide.texi:1938
#, no-wrap
msgid "r @r{or} g"
msgstr ""

#. type: table
#: orgguide.texi:1940
msgid "Recreate the agenda buffer, to reflect the changes."
msgstr ""

#. type: table
#: orgguide.texi:1943
msgid ""
"Save all Org buffers in the current Emacs session, and also the locations of "
"IDs."
msgstr ""

#. type: table
#: orgguide.texi:1945
msgid "@tsubheading{Secondary filtering and query editing}"
msgstr ""

#. type: item
#: orgguide.texi:1946
#, no-wrap
msgid "/"
msgstr ""

#. type: table
#: orgguide.texi:1949
msgid ""
"Filter the current agenda view with respect to a tag.  You are prompted for "
"a letter to select a tag.  Press @samp{-} first to select against the tag."
msgstr ""

#. type: item
#: orgguide.texi:1950
#, no-wrap
msgid "\\"
msgstr ""

#. type: table
#: orgguide.texi:1952
msgid "Narrow the current agenda filter by an additional condition."
msgstr ""

#. type: table
#: orgguide.texi:1954
msgid "@tsubheading{Remote editing (see the manual for many more commands)}"
msgstr ""

#. type: item
#: orgguide.texi:1955
#, no-wrap
msgid "0-9"
msgstr ""

#. type: table
#: orgguide.texi:1958
msgid "Digit argument."
msgstr ""

#. type: item
#: orgguide.texi:1958
#, no-wrap
msgid "t"
msgstr ""

#. type: table
#: orgguide.texi:1962
msgid "Change the TODO state of the item, in the agenda and in the org file."
msgstr ""

#. type: item
#: orgguide.texi:1962
#, no-wrap
msgid "C-k"
msgstr ""

#. type: table
#: orgguide.texi:1966
msgid ""
"Delete the current agenda item along with the entire subtree belonging to it "
"in the original Org file."
msgstr ""

#. type: table
#: orgguide.texi:1969
msgid "Refile the entry at point."
msgstr ""

#. type: item
#: orgguide.texi:1969
#, no-wrap
msgid "C-c C-x C-a @ @r{or short} @ a"
msgstr ""

#. type: table
#: orgguide.texi:1973
msgid ""
"Archive the subtree corresponding to the entry at point using the default "
"archiving command set in @code{org-archive-default-command}."
msgstr ""

#. type: item
#: orgguide.texi:1973
#, no-wrap
msgid "C-c C-x C-s @ @r{or short} @ $"
msgstr ""

#. type: table
#: orgguide.texi:1976
msgid "Archive the subtree corresponding to the current headline."
msgstr ""

#. type: table
#: orgguide.texi:1979
msgid "Schedule this item, with prefix arg remove the scheduling timestamp"
msgstr ""

#. type: table
#: orgguide.texi:1982
msgid "Set a deadline for this item, with prefix arg remove the deadline."
msgstr ""

#. type: item
#: orgguide.texi:1982
#, fuzzy, no-wrap
msgid "S-@key{right} @r{and} S-@key{left}"
msgstr "S-@key{derecha}@r{/}@key{izquierda}"

#. type: table
#: orgguide.texi:1985
msgid "Change the timestamp associated with the current line by one day."
msgstr ""

#. type: item
#: orgguide.texi:1985
#, no-wrap
msgid "I"
msgstr ""

#. type: table
#: orgguide.texi:1988
#, fuzzy
msgid "Start the clock on the current item."
msgstr "Enlaces a otros lugares en el fichero actual"

#. type: item
#: orgguide.texi:1988
#, no-wrap
msgid "O / X"
msgstr ""

#. type: table
#: orgguide.texi:1990
msgid "Stop/cancel the previously started clock."
msgstr ""

#. type: item
#: orgguide.texi:1991
#, no-wrap
msgid "J"
msgstr ""

#. type: table
#: orgguide.texi:1993
msgid "Jump to the running clock in another window."
msgstr ""

#. type: Plain text
#: orgguide.texi:2007
msgid ""
"The main application of custom searches is the definition of keyboard "
"shortcuts for frequently used searches, either creating an agenda buffer, or "
"a sparse tree (the latter covering of course only the current buffer).  "
"Custom commands are configured in the variable @code{org-agenda-custom-"
"commands}.  You can customize this variable, for example by pressing @kbd{C-"
"c a C}.  You can also directly set it with Emacs Lisp in @file{.emacs}.  The "
"following example contains all valid search types:"
msgstr ""

#. type: group
#: orgguide.texi:2014
#, no-wrap
msgid ""
"(setq org-agenda-custom-commands\n"
"      '((\"w\" todo \"WAITING\")\n"
"        (\"u\" tags \"+boss-urgent\")\n"
"        (\"v\" tags-todo \"+boss-urgent\")))\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2023
msgid ""
"The initial string in each entry defines the keys you have to press after "
"the dispatcher command @kbd{C-c a} in order to access the command.  Usually "
"this will be just a single character.  The second parameter is the search "
"type, followed by the string or regular expression to be used for the "
"matching.  The example above will therefore define:"
msgstr ""

#. type: item
#: orgguide.texi:2025
#, fuzzy, no-wrap
msgid "C-c a w"
msgstr "C-c a t"

#. type: table
#: orgguide.texi:2028
msgid ""
"as a global search for TODO entries with @samp{WAITING} as the TODO keyword"
msgstr ""

#. type: item
#: orgguide.texi:2028
#, fuzzy, no-wrap
msgid "C-c a u"
msgstr "C-c a t"

#. type: table
#: orgguide.texi:2031
msgid ""
"as a global tags search for headlines marked @samp{:boss:} but not @samp{:"
"urgent:}"
msgstr ""

#. type: item
#: orgguide.texi:2031
#, fuzzy, no-wrap
msgid "C-c a v"
msgstr "C-c a t"

#. type: table
#: orgguide.texi:2034
msgid ""
"as the same search as @kbd{C-c a u}, but limiting the search to headlines "
"that are also TODO items"
msgstr ""

#. type: Plain text
#: orgguide.texi:2043
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Agenda-Views.html#Agenda-Views, "
"Chapter 10 of the manual}@* @uref{http://orgmode.org/worg/org-tutorials/org-"
"custom-agenda-commands.php, Mat Lundin's tutorial about custom agenda "
"commands}@* @uref{http://www.newartisans.com/2007/08/using-org-mode-as-a-day-"
"planner.html, John Wiegley's setup}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:2052
msgid ""
"When exporting Org-mode documents, the exporter tries to reflect the "
"structure of the document as accurately as possible in the backend.  Since "
"export targets like HTML, @LaTeX{}, or DocBook allow much richer formatting, "
"Org mode has rules on how to prepare text for rich export.  This section "
"summarizes the markup rules used in an Org-mode buffer."
msgstr ""

#. type: Plain text
#: orgguide.texi:2078
msgid "The title of the exported document is taken from the special line"
msgstr ""

#. type: smallexample
#: orgguide.texi:2081
#, no-wrap
msgid "#+TITLE: This is the title of the document\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2093
msgid ""
"The outline structure of the document as described in @ref{Document "
"Structure}, forms the basis for defining sections of the exported document.  "
"However, since the outline structure is also used for (for example) lists of "
"tasks, only the first three outline levels will be used as headings.  Deeper "
"levels will become itemized lists.  You can change the location of this "
"switch globally by setting the variable @code{org-export-headline-levels}, "
"or on a per-file basis with a line"
msgstr ""
" ................ ........... @ref{Estructura del documento}, ....... ..."

#. type: smallexample
#: orgguide.texi:2096
#, no-wrap
msgid "#+OPTIONS: H:4\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2103
msgid ""
"The table of contents is normally inserted directly before the first "
"headline of the file."
msgstr ""

#. type: smallexample
#: orgguide.texi:2107
#, no-wrap
msgid ""
"#+OPTIONS: toc:2          (only to two levels in TOC)\n"
"#+OPTIONS: toc:nil        (no TOC at all)\n"
msgstr ""

#. type: subheading
#: orgguide.texi:2110
#, no-wrap
msgid "Paragraphs, line breaks, and quoting"
msgstr ""

#. type: Plain text
#: orgguide.texi:2114
msgid ""
"Paragraphs are separated by at least one empty line.  If you need to enforce "
"a line break within a paragraph, use @samp{\\\\} at the end of a line."
msgstr ""

#. type: Plain text
#: orgguide.texi:2117
msgid ""
"To keep the line breaks in a region, but otherwise use normal formatting, "
"you can use this construct, which can also be used to format poetry."
msgstr ""

#. type: smallexample
#: orgguide.texi:2123
#, no-wrap
msgid ""
"#+BEGIN_VERSE\n"
" Great clouds overhead\n"
" Tiny black birds rise and fall\n"
" Snow covers Emacs\n"
"\n"
msgstr ""

#. type: smallexample
#: orgguide.texi:2126
#, no-wrap
msgid ""
"     -- AlexSchroeder\n"
"#+END_VERSE\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2131
msgid ""
"When quoting a passage from another document, it is customary to format this "
"as a paragraph that is indented on both the left and the right margin.  You "
"can include quotations in Org-mode documents like this:"
msgstr ""

#. type: smallexample
#: orgguide.texi:2137
#, no-wrap
msgid ""
"#+BEGIN_QUOTE\n"
"Everything should be made as simple as possible,\n"
"but not any simpler -- Albert Einstein\n"
"#+END_QUOTE\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2140
msgid "If you would like to center some text, do it like this:"
msgstr ""

#. type: smallexample
#: orgguide.texi:2145
#, no-wrap
msgid ""
"#+BEGIN_CENTER\n"
"Everything should be made as simple as possible, \\\\\n"
"but not any simpler\n"
"#+END_CENTER\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2155
msgid ""
"You can make words @b{*bold*}, @i{/italic/}, _underlined_, @code{=code=} and "
"@code{~verbatim~}, and, if you must, @samp{+strike-through+}.  Text in the "
"code and verbatim string is not processed for Org-mode specific syntax, it "
"is exported verbatim.  To insert a horizontal rules, use a line consisting "
"of only dashes, and at least 5 of them."
msgstr ""

#. type: Plain text
#: orgguide.texi:2164
msgid ""
"Lines starting with zero or more whitespace characters followed by @samp{#} "
"are treated as comments and will never be exported.  Also entire subtrees "
"starting with the word @samp{COMMENT} will never be exported.  Finally, "
"regions surrounded by @samp{#+BEGIN_COMMENT} ... @samp{#+END_COMMENT} will "
"not be exported."
msgstr ""

#. type: item
#: orgguide.texi:2166
#, fuzzy, no-wrap
msgid "C-c ;"
msgstr "C-c /"

#. type: table
#: orgguide.texi:2168
msgid "Toggle the COMMENT keyword at the beginning of an entry."
msgstr ""

#. type: section
#: orgguide.texi:2171
#, fuzzy, no-wrap
msgid "Images and Tables"
msgstr "Fechas y horas"

#. type: Plain text
#: orgguide.texi:2177
msgid ""
"For Org mode tables, the lines before the first horizontal separator line "
"will become table header lines.  You can use the following lines somewhere "
"before the table to assign a caption and a label for cross references, and "
"in the text you can refer to the object with @code{\\ref@{tab:basic-data@}}:"
msgstr ""

#. type: smallexample
#: orgguide.texi:2183
#, no-wrap
msgid ""
"#+CAPTION: This is the caption for the next table (or link)\n"
"#+LABEL:   tbl:basic-data\n"
"   | ... | ...|\n"
"   |-----|----|\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2191
msgid ""
"Some backends (HTML, @LaTeX{}, and DocBook) allow you to directly include "
"images into the exported document.  Org does this, if a link to an image "
"files does not have a description part, for example @code{[[./img/a.jpg]]}.  "
"If you wish to define a caption for the image and maybe a label for internal "
"cross references, you sure that the link is on a line by itself precede it "
"with:"
msgstr ""

#. type: smallexample
#: orgguide.texi:2196
#, no-wrap
msgid ""
"#+CAPTION: This is the caption for the next figure link (or table)\n"
"#+LABEL:   fig:SED-HR4049\n"
"[[./img/a.jpg]]\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2201
msgid ""
"You may also define additional attributes for the figure.  As this is "
"backend-specific, see the sections about the individual backends for more "
"information."
msgstr ""

#. type: Plain text
#: orgguide.texi:2209
msgid ""
"You can include literal examples that should not be subjected to markup.  "
"Such examples will be typeset in monospace, so this is well suited for "
"source code and similar examples."
msgstr ""

#. type: smallexample
#: orgguide.texi:2214
#, no-wrap
msgid ""
"#+BEGIN_EXAMPLE\n"
"Some example from a text file.\n"
"#+END_EXAMPLE\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2219
msgid ""
"For simplicity when using small examples, you can also start the example "
"lines with a colon followed by a space.  There may also be additional "
"whitespace before the colon:"
msgstr ""

#. type: smallexample
#: orgguide.texi:2223
#, no-wrap
msgid ""
"Here is an example\n"
"   : Some example from a text file.\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2228
msgid ""
"For source code from a programming language, or any other text that can be "
"marked up by font-lock in Emacs, you can ask for it to look like the "
"fontified Emacs buffer"
msgstr ""

#. type: smallexample
#: orgguide.texi:2235
#, no-wrap
msgid ""
"#+BEGIN_SRC emacs-lisp\n"
"(defun org-xor (a b)\n"
"   \"Exclusive or.\"\n"
"   (if a (not b) b))\n"
"#+END_SRC\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2239
msgid ""
"To edit the example in a special buffer supporting this language, use @kbd{C-"
"c '} to both enter and leave the editing buffer."
msgstr ""

#. type: Plain text
#: orgguide.texi:2245
msgid ""
"During export, you can include the content of another file.  For example, to "
"include your @file{.emacs} file, you could use:"
msgstr ""

#. type: smallexample
#: orgguide.texi:2248
#, no-wrap
msgid "#+INCLUDE: \"~/.emacs\" src emacs-lisp\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2255
msgid ""
"The optional second and third parameter are the markup (e.g.@: @samp{quote}, "
"@samp{example}, or @samp{src}), and, if the markup is @samp{src}, the "
"language for formatting the contents.  The markup is optional, if it is not "
"given, the text will be assumed to be in Org mode format and will be "
"processed normally. @kbd{C-c '} will visit the included file."
msgstr ""

#. type: Plain text
#: orgguide.texi:2263
msgid ""
"For scientific notes which need to be able to contain mathematical symbols "
"and the occasional formula, Org-mode supports embedding @LaTeX{} code into "
"its files.  You can directly use TeX-like macros for special symbols, enter "
"formulas and entire @LaTeX{} environments."
msgstr ""

#. type: smallexample
#: orgguide.texi:2269
#, no-wrap
msgid ""
"Angles are written as Greek letters \\alpha, \\beta and \\gamma.  The mass if\n"
"the sun is M_sun = 1.989 x 10^30 kg.  The radius of the sun is R_@{sun@} =\n"
"6.96 x 10^8 m.  If $a^2=b$ and $b=2$, then the solution must be either\n"
"$a=+\\sqrt@{2@}$ or $a=-\\sqrt@{2@}$.\n"
"\n"
msgstr ""

#. type: smallexample
#: orgguide.texi:2273
#, no-wrap
msgid ""
"\\begin@{equation@}\n"
"x=\\sqrt@{b@}\n"
"\\end@{equation@}\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2277
msgid ""
"@uref{http://orgmode.org/manual/LaTeX-fragments.html#LaTeX-fragments,special "
"setup}, @LaTeX{} snippets will be included as images when exporting to HTML."
msgstr ""

#. type: Plain text
#: orgguide.texi:2280
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Markup.html#Markup, Chapter 11 of "
"the manual}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:2289
msgid ""
"Org-mode documents can be exported into a variety of other formats: ASCII "
"export for inclusion into emails, HTML to publish on the web, @LaTeX{}/PDF "
"for beautiful printed documents and DocBook to enter the world of many other "
"formats using DocBook tools.  There is also export to iCalendar format so "
"that planning information can be incorporated into desktop calendars."
msgstr ""

#. type: Plain text
#: orgguide.texi:2307
msgid ""
"The exporter recognizes special lines in the buffer which provide additional "
"information.  These lines may be put anywhere in the file.  The whole set of "
"lines can be inserted into the buffer with @kbd{C-c C-e t}."
msgstr ""

#. type: item
#: orgguide.texi:2309
#, fuzzy, no-wrap
msgid "C-c C-e t"
msgstr "C-c C-t"

#. type: table
#: orgguide.texi:2311
msgid "Insert template with export options, see example below."
msgstr ""

#. type: smallexample
#: orgguide.texi:2327
#, no-wrap
msgid ""
"#+TITLE:       the title to be shown (default is the buffer name)\n"
"#+AUTHOR:      the author (default taken from @code{user-full-name})\n"
"#+DATE:        a date, fixed, of a format string for @code{format-time-string}\n"
"#+EMAIL:       his/her email address (default from @code{user-mail-address})\n"
"#+DESCRIPTION: the page description, e.g.@: for the XHTML meta tag\n"
"#+KEYWORDS:    the page keywords, e.g.@: for the XHTML meta tag\n"
"#+LANGUAGE:    language for HTML, e.g.@: @samp{en} (@code{org-export-default-language})\n"
"#+TEXT:        Some descriptive text to be inserted at the beginning.\n"
"#+TEXT:        Several lines may be given.\n"
"#+OPTIONS:     H:2 num:t toc:t \\n:nil @@:t ::t |:t ^:t f:t TeX:t ...\n"
"#+LINK_UP:     the ``up'' link of an exported page\n"
"#+LINK_HOME:   the ``home'' link of an exported page\n"
"#+LATEX_HEADER: extra line(s) for the @LaTeX{} header, like \\usepackage@{xyz@}\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2337
msgid ""
"All export commands can be reached using the export dispatcher, which is a "
"prefix key that prompts for an additional key specifying the command.  "
"Normally the entire file is exported, but if there is an active region that "
"contains one outline tree, the first heading is used as document title and "
"the subtrees are exported."
msgstr ""

#. type: item
#: orgguide.texi:2339
#, fuzzy, no-wrap
msgid "C-c C-e"
msgstr "C-c C-n"

#. type: table
#: orgguide.texi:2341
msgid "Dispatcher for export and publishing commands."
msgstr ""

#. type: Plain text
#: orgguide.texi:2349
msgid ""
"ASCII export produces a simple and very readable version of an Org-mode "
"file, containing only plain ASCII.  Latin-1 and UTF-8 export augment the "
"file with special characters and symbols available in these encodings."
msgstr ""

#. type: item
#: orgguide.texi:2351
#, fuzzy, no-wrap
msgid "C-c C-e a"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:2353
msgid "Export as ASCII file."
msgstr ""

#. type: item
#: orgguide.texi:2353
#, no-wrap
msgid "C-c C-e n @ @ @r{and} @ @ C-c C-e N"
msgstr ""

#. type: table
#: orgguide.texi:2355
msgid "Like the above commands, but use Latin-1 encoding."
msgstr ""

#. type: item
#: orgguide.texi:2355
#, no-wrap
msgid "C-c C-e u @ @ @r{and} @ @ C-c C-e U"
msgstr ""

#. type: table
#: orgguide.texi:2357
msgid "Like the above commands, but use UTF-8 encoding."
msgstr ""

#. type: item
#: orgguide.texi:2363
#, fuzzy, no-wrap
msgid "C-c C-e h"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:2365
msgid "Export as HTML file @file{myfile.html}."
msgstr ""

#. type: item
#: orgguide.texi:2365
#, fuzzy, no-wrap
msgid "C-c C-e b"
msgstr "C-c C-b"

#. type: table
#: orgguide.texi:2367
msgid "Export as HTML file and immediately open it with a browser."
msgstr ""

#. type: Plain text
#: orgguide.texi:2371
msgid ""
"To insert HTML that should be copied verbatim to the exported file use either"
msgstr ""

#. type: smallexample
#: orgguide.texi:2374
#, no-wrap
msgid "#+HTML: Literal HTML code for export\n"
msgstr ""

#. type: smallexample
#: orgguide.texi:2380
#, no-wrap
msgid ""
"#+BEGIN_HTML\n"
"All lines between these markers are exported literally\n"
"#+END_HTML\n"
msgstr ""

#. type: item
#: orgguide.texi:2386
#, fuzzy, no-wrap
msgid "C-c C-e l"
msgstr "C-c C-l"

#. type: table
#: orgguide.texi:2388
msgid "Export as @LaTeX{} file @file{myfile.tex}."
msgstr ""

#. type: item
#: orgguide.texi:2388
#, fuzzy, no-wrap
msgid "C-c C-e p"
msgstr "C-c C-x p"

#. type: table
#: orgguide.texi:2390
msgid "Export as @LaTeX{} and then process to PDF."
msgstr "Exportando a @LaTeX{} y procesando a PDF"

#. type: item
#: orgguide.texi:2390
#, fuzzy, no-wrap
msgid "C-c C-e d"
msgstr "C-c C-c d"

#. type: table
#: orgguide.texi:2392
#, fuzzy
msgid ""
"Export as @LaTeX{} and then process to PDF, then open the resulting PDF file."
msgstr "Exportando a @LaTeX{} y procesando a PDF"

#. type: Plain text
#: orgguide.texi:2397
msgid ""
"By default, the @LaTeX{} output uses the class @code{article}.  You can "
"change this by adding an option like @code{#+LaTeX_CLASS: myclass} in your "
"file.  The class must be listed in @code{org-export-latex-classes}."
msgstr ""

#. type: Plain text
#: orgguide.texi:2402
msgid ""
"Embedded @LaTeX{} as described in @ref{Embedded @LaTeX{}}, will be correctly "
"inserted into the @LaTeX{} file.  Similarly to the HTML exporter, you can "
"use @code{#+LaTeX:} and @code{#+BEGIN_LaTeX ... #+END_LaTeX} construct to "
"add verbatim @LaTeX{} code."
msgstr "........ @ref{@LaTeX{} embebido}, ....."

#. type: item
#: orgguide.texi:2407
#, fuzzy, no-wrap
msgid "C-c C-e D"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:2409
#, fuzzy
msgid "Export as DocBook file."
msgstr "Exportando a DocBook"

#. type: Plain text
#: orgguide.texi:2414
#, fuzzy
msgid ""
"Similarly to the HTML exporter, you can use @code{#+DOCBOOK:} and @code{#"
"+BEGIN_DOCBOOK ... #+END_DOCBOOK} construct to add verbatim @LaTeX{} code."
msgstr ""
"De forma similar al exportador HTML, puede emplear los constructores\n"
"@code{#+DocBook:} y @code{#+BEGIN_DocBook ... #+END_DocBook} para\n"
"a@~nadir c@'odigo @LaTeX{}."

#. type: item
#: orgguide.texi:2419
#, fuzzy, no-wrap
msgid "C-c C-e i"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:2421
msgid "Create iCalendar entries for the current file in a @file{.ics} file."
msgstr ""

#. type: item
#: orgguide.texi:2421
#, fuzzy, no-wrap
msgid "C-c C-e c"
msgstr "C-c C-c"

#. type: table
#: orgguide.texi:2425
msgid ""
"Create a single large iCalendar file from all files in @code{org-agenda-"
"files} and write it to the file given by @code{org-combined-agenda-icalendar-"
"file}."
msgstr ""

#. type: Plain text
#: orgguide.texi:2435
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Exporting.html#Exporting, Chapter "
"12 of the manual}@* @uref{http://orgmode.org/worg/org-tutorials/images-and-"
"xhtml-export.php, Sebastian Rose's image handling tutorial}@* @uref{http://"
"orgmode.org/worg/org-tutorials/org-latex-export.php, Thomas Dye's LaTeX "
"export tutorial} @uref{http://orgmode.org/worg/org-tutorials/org-beamer/"
"tutorial.php, Eric Fraga's BEAMER presentation tutorial}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:2444
msgid ""
"Org includes a publishing management system that allows you to configure "
"automatic HTML conversion of @emph{projects} composed of interlinked org "
"files.  You can also configure Org to automatically upload your exported "
"HTML pages and related attachments, such as images and source code files, to "
"a web server.  For detailed instructions about setup, see the manual."
msgstr ""

#. type: Plain text
#: orgguide.texi:2446
msgid "Here is an example:"
msgstr ""

#. type: smalllisp
#: orgguide.texi:2457
#, no-wrap
msgid ""
"(setq org-publish-project-alist\n"
"      '((\"org\"\n"
"         :base-directory \"~/org/\"\n"
"         :publishing-directory \"~/public_html\"\n"
"         :section-numbers nil\n"
"         :table-of-contents nil\n"
"         :style \"<link rel=\\\"stylesheet\\\"\n"
"                href=\\\"../other/mystyle.css\\\"\n"
"                type=\\\"text/css\\\"/>\")))\n"
msgstr ""

#. type: item
#: orgguide.texi:2460
#, fuzzy, no-wrap
msgid "C-c C-e C"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:2462
msgid "Prompt for a specific project and publish all files that belong to it."
msgstr ""

#. type: item
#: orgguide.texi:2462
#, fuzzy, no-wrap
msgid "C-c C-e P"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:2464
#, fuzzy
msgid "Publish the project containing the current file."
msgstr "Enlaces a otros lugares en el fichero actual"

#. type: item
#: orgguide.texi:2464
#, fuzzy, no-wrap
msgid "C-c C-e F"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:2466
#, fuzzy
msgid "Publish only the current file."
msgstr "Elimina la columna actual."

#. type: item
#: orgguide.texi:2466
#, fuzzy, no-wrap
msgid "C-c C-e E"
msgstr "C-c C-x f"

#. type: table
#: orgguide.texi:2468
msgid "Publish every project."
msgstr ""

#. type: Plain text
#: orgguide.texi:2474
msgid ""
"Org uses timestamps to track when a file has changed.  The above functions "
"normally only publish changed files.  You can override this and force "
"publishing of all files by giving a prefix argument to any of the commands "
"above."
msgstr ""

#. type: Plain text
#: orgguide.texi:2482
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Publishing.html#Publishing, "
"Chapter 13 of the manual}@* @uref{http://orgmode.org/worg/org-tutorials/org-"
"publish-html-tutorial.php, Sebastian Rose's publishing tutorial}@* @uref"
"{http://orgmode.org/worg/org-tutorials/org-jekyll.php, Ian Barton's Jekyll/"
"blogging setup}}"
msgstr ""

#. type: chapter
#: orgguide.texi:2484
#, no-wrap
msgid "Working with source code"
msgstr "Trabajando con c@'odigo fuente"

#. type: Plain text
#: orgguide.texi:2489
msgid ""
"Org-mode provides a number of features for working with source code, "
"including editing of code blocks in their native major-mode, evaluation of "
"code blocks, tangling of code blocks, and exporting code blocks and their "
"results in several formats."
msgstr ""

#. type: subheading
#: orgguide.texi:2490
#, no-wrap
msgid "Structure of Code Blocks"
msgstr ""

#. type: Plain text
#: orgguide.texi:2492
msgid "The structure of code blocks is as follows:"
msgstr ""

#. type: example
#: orgguide.texi:2498
#, no-wrap
msgid ""
"#+NAME: <name>\n"
"#+BEGIN_SRC <language> <switches> <header arguments>\n"
"  <body>\n"
"#+END_SRC\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2507
msgid ""
"Where @code{<name>} is a string used to name the code block, @code"
"{<language>} specifies the language of the code block (e.g.@: @code{emacs-"
"lisp}, @code{shell}, @code{R}, @code{python}, etc...), @code{<switches>} can "
"be used to control export of the code block, @code{<header arguments>} can "
"be used to control many aspects of code block behavior as demonstrated "
"below, and @code{<body>} contains the actual source code."
msgstr ""

#. type: subheading
#: orgguide.texi:2508
#, no-wrap
msgid "Editing source code"
msgstr "Editando c@'odigo fuente"

#. type: Plain text
#: orgguide.texi:2513
msgid ""
"Use @kbd{C-c '} to edit the current code block.  This brings up a language "
"major-mode edit buffer containing the body of the code block.  Saving this "
"buffer will write the new contents back to the Org buffer.  Use @kbd{C-c '} "
"again to exit the edit buffer."
msgstr ""

#. type: subheading
#: orgguide.texi:2514
#, no-wrap
msgid "Evaluating code blocks"
msgstr ""

#. type: Plain text
#: orgguide.texi:2520
msgid ""
"Use @kbd{C-c C-c} to evaluate the current code block and insert its results "
"in the Org-mode buffer.  By default, evaluation is only turned on for @code"
"{emacs-lisp} code blocks, however support exists for evaluating blocks in "
"many languages.  For a complete list of supported languages see the manual.  "
"The following shows a code block and its results."
msgstr ""

#. type: example
#: orgguide.texi:2525
#, no-wrap
msgid ""
"#+BEGIN_SRC emacs-lisp\n"
"  (+ 1 2 3 4)\n"
"#+END_SRC\n"
"\n"
msgstr ""

#. type: example
#: orgguide.texi:2528
#, no-wrap
msgid ""
"#+RESULTS:\n"
": 10\n"
msgstr ""

#. type: subheading
#: orgguide.texi:2530
#, no-wrap
msgid "Extracting source code"
msgstr "Extrayendo c@'odigo fuente"

#. type: Plain text
#: orgguide.texi:2538
msgid ""
"Use @kbd{C-c C-v t} to create pure source code files by extracting code from "
"source blocks in the current buffer.  This is referred to as ``tangling''---"
"a term adopted from the literate programming community.  During ``tangling'' "
"of code blocks their bodies are expanded using @code{org-babel-expand-src-"
"block} which can expand both variable and ``noweb'' style references.  In "
"order to tangle a code block it must have a @code{:tangle} header argument, "
"see the manual for details."
msgstr ""

#. type: subheading
#: orgguide.texi:2539
#, no-wrap
msgid "Library of Babel"
msgstr ""

#. type: Plain text
#: orgguide.texi:2544
msgid ""
"Use @kbd{C-c C-v l} to load the code blocks from an Org-mode files into the "
"``Library of Babel'', these blocks can then be evaluated from any Org-mode "
"buffer.  A collection of generally useful code blocks is distributed with "
"Org-mode in @code{contrib/library-of-babel.org}."
msgstr ""

#. type: subheading
#: orgguide.texi:2545
#, no-wrap
msgid "Header Arguments"
msgstr ""

#. type: Plain text
#: orgguide.texi:2550
msgid ""
"Many aspects of the evaluation and export of code blocks are controlled "
"through header arguments.  These can be specified globally, at the file "
"level, at the outline subtree level, and at the individual code block "
"level.  The following describes some of the header arguments."
msgstr ""

#. type: item
#: orgguide.texi:2551
#, no-wrap
msgid ":var"
msgstr ""

#. type: table
#: orgguide.texi:2555
msgid ""
"The @code{:var} header argument is used to pass arguments to code blocks.  "
"The values passed to arguments can be literal values, values from org-mode "
"tables and literal example blocks, or the results of other named code blocks."
msgstr ""

#. type: item
#: orgguide.texi:2555
#, no-wrap
msgid ":results"
msgstr ""

#. type: table
#: orgguide.texi:2566
msgid ""
"The @code{:results} header argument controls the @emph{collection}, @emph"
"{type}, and @emph{handling} of code block results.  Values of @code{output} "
"or @code{value} (the default) specify how results are collected from a code "
"block's evaluation.  Values of @code{vector}, @code{scalar} @code{file} @code"
"{raw} @code{html} @code{latex} and @code{code} specify the type of the "
"results of the code block which dictates how they will be incorporated into "
"the Org-mode buffer.  Values of @code{silent}, @code{replace}, @code"
"{prepend}, and @code{append} specify handling of code block results, "
"specifically if and how the results should be inserted into the Org-mode "
"buffer."
msgstr ""

#. type: item
#: orgguide.texi:2566
#, no-wrap
msgid ":session"
msgstr ""

#. type: table
#: orgguide.texi:2571
msgid ""
"A header argument of @code{:session} will cause the code block to be "
"evaluated in a persistent interactive inferior process in Emacs.  This "
"allows for persisting state between code block evaluations, and for manual "
"inspection of the results of evaluation."
msgstr ""

#. type: item
#: orgguide.texi:2571
#, fuzzy, no-wrap
msgid ":exports"
msgstr "HTML export"

#. type: table
#: orgguide.texi:2575
msgid ""
"Any combination of the @emph{code} or the @emph{results} of a block can be "
"retained on export, this is specified by setting the @code{:results} header "
"argument to @code{code} @code{results} @code{none} or @code{both}."
msgstr ""

#. type: item
#: orgguide.texi:2575
#, no-wrap
msgid ":tangle"
msgstr ""

#. type: table
#: orgguide.texi:2579
msgid ""
"A header argument of @code{:tangle yes} will cause a code block's contents "
"to be tangled to a file named after the filename of the Org-mode buffer.  An "
"alternate file name can be specified with @code{:tangle filename}."
msgstr ""

#. type: item
#: orgguide.texi:2579
#, no-wrap
msgid ":cache"
msgstr ""

#. type: table
#: orgguide.texi:2583
msgid ""
"A header argument of @code{:cache yes} will cause associate a hash of the "
"expanded code block with the results, ensuring that code blocks are only re-"
"run when their inputs have changed."
msgstr ""

#. type: item
#: orgguide.texi:2583
#, no-wrap
msgid ":noweb"
msgstr ""

#. type: table
#: orgguide.texi:2586
msgid ""
"A header argument of @code{:noweb yes} will expand ``noweb'' style "
"references on evaluation and tangling."
msgstr ""

#. type: item
#: orgguide.texi:2586
#, no-wrap
msgid ":file"
msgstr ""

#. type: table
#: orgguide.texi:2591
msgid ""
"Code blocks which output results to files (e.g.@: graphs, diagrams and "
"figures)  can accept a @code{:file filename} header argument in which case "
"the results are saved to the named file, and a link to the file is inserted "
"into the Org-mode buffer."
msgstr ""

#. type: Plain text
#: orgguide.texi:2598
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Literal-examples.html#Literal-"
"examples, Chapter 11.3 of the manual}@* @uref{http://orgmode.org/worg/org-"
"contrib/babel/index.php, The Babel site on Worg}}"
msgstr ""

#. type: Plain text
#: orgguide.texi:2617
msgid ""
"Org supports in-buffer completion with @kbd{M-@key{TAB}}.  This type of "
"completion does not make use of the minibuffer.  You simply type a few "
"letters into the buffer and use the key to complete text right there.  For "
"example, this command will complete @TeX{} symbols after @samp{\\}, TODO "
"keywords at the beginning of a headline, and tags after @samp{:} in a "
"headline."
msgstr ""

#. type: section
#: orgguide.texi:2619
#, no-wrap
msgid "A cleaner outline view"
msgstr ""

#. type: Plain text
#: orgguide.texi:2626
msgid ""
"Some people find it noisy and distracting that the Org headlines start with "
"a potentially large number of stars, and that text below the headlines is "
"not indented.  While this is no problem when writing a @emph{book-like} "
"document where the outline headings are really section headings, in a more "
"@emph{list-oriented} outline, indented structure is a lot cleaner:"
msgstr ""

#. type: group
#: orgguide.texi:2636
#, no-wrap
msgid ""
"* Top level headline             |    * Top level headline\n"
"** Second level                  |      * Second level\n"
"*** 3rd level                    |        * 3rd level\n"
"some text                        |          some text\n"
"*** 3rd level                    |        * 3rd level\n"
"more text                        |          more text\n"
"* Another top level headline     |    * Another top level headline\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2646
msgid ""
"If you are using at least Emacs 23.1.50.3 and version 6.29 of Org, this kind "
"of view can be achieved dynamically at display time using @code{org-indent-"
"mode}, which will prepend intangible space to each line.  You can turn on "
"@code{org-indent-mode} for all files by customizing the variable @code{org-"
"startup-indented}, or you can turn it on for individual files using"
msgstr ""

#. type: smallexample
#: orgguide.texi:2649
#, no-wrap
msgid "#+STARTUP: indent\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2657
msgid ""
"If you want a similar effect in earlier version of Emacs and/or Org, or if "
"you want the indentation to be hard space characters so that the plain text "
"file looks as similar as possible to the Emacs display, Org supports you by "
"helping to indent (with @key{TAB}) text below each headline, by hiding "
"leading stars, and by only using levels 1, 3, etc to get two characters "
"indentation for each level.  To get this support in a file, use"
msgstr ""

#. type: smallexample
#: orgguide.texi:2660
#, no-wrap
msgid "#+STARTUP: hidestars odd\n"
msgstr ""

#. type: Plain text
#: orgguide.texi:2669
msgid ""
"@i{MobileOrg} is the name of the mobile companion app for Org mode, "
"currently available for iOS and for Android.  @i{MobileOrg} offers offline "
"viewing and capture support for an Org mode system rooted on a ``real'' "
"computer.  It does also allow you to record changes to existing entries."
msgstr ""

#. type: Plain text
#: orgguide.texi:2676
msgid ""
"The @uref{http://mobileorg.ncogni.to/, iOS implementation} for the @i{iPhone/"
"iPod Touch/iPad} series of devices, was developed by Richard Moreland. "
"Android users should check out @uref{http://wiki.github.com/matburt/"
"mobileorg-android/, MobileOrg Android} by Matt Jones.  The two "
"implementations are not identical but offer similar features."
msgstr ""

#. type: Plain text
#: orgguide.texi:2683
msgid ""
"@seealso{ @uref{http://orgmode.org/manual/Miscellaneous.html#Miscellaneous, "
"Chapter 15 of the manual}@* @uref{http://orgmode.org/manual/MobileOrg."
"html#MobileOrg, Appendix B of the manual}@* @uref{http://orgmode.org/orgcard."
"pdf,Key reference card}}"
msgstr ""

#~ msgid ""
#~ "\\input texinfo @c %**start of header @setfilename ../../info/orgguide "
#~ "@settitle The compact Org-mode Guide"
#~ msgstr ""
#~ "\\input texinfo @c %**start of header @setfilename ../../info/orgguide\n"
#~ "@settitle La Guia compacta de Org-mode"

#~ msgid "@set VERSION 7.8.03 @set DATE January 2012"
#~ msgstr "@set VERSION 7.8.03 @set DATE January 2012"

#~ msgid ""
#~ "@c Use proper quote and backtick for code sections in PDF output @c Cf. "
#~ "Texinfo manual 14.2 @set txicodequoteundirected @set txicodequotebacktick"
#~ msgstr ""
#~ "@c Use proper quote and backtick for code sections in PDF output @c Cf. "
#~ "Texinfo manual 14.2 @set txicodequoteundirected @set txicodequotebacktick"

#~ msgid ""
#~ "@c Version and Contact Info @set MAINTAINERSITE @uref{http://orgmode.org,"
#~ "maintainers webpage} @set AUTHOR Carsten Dominik @set MAINTAINER Carsten "
#~ "Dominik @set MAINTAINEREMAIL @email{carsten at orgmode dot org} @set "
#~ "MAINTAINERCONTACT @uref{mailto:carsten at orgmode dot org,contact the "
#~ "maintainer} @c %**end of header @finalout"
#~ msgstr ""
#~ "@c Version and Contact Info @set MAINTAINERSITE @uref{http://orgmode.org,"
#~ "maintainers webpage} @set AUTHOR Carsten Dominik @set MAINTAINER Carsten "
#~ "Dominik @set MAINTAINEREMAIL @email{carsten at orgmode dot org} @set "
#~ "MAINTAINERCONTACT @uref{mailto:carsten at orgmode dot org,contact the "
#~ "maintainer} @c %**end of header @finalout"

#~ msgid ""
#~ "@c Macro definitions @iftex @c @hyphenation{time-stamp time-stamps time-"
#~ "stamp-ing time-stamp-ed} @end iftex"
#~ msgstr ""
#~ "@c Macro definitions @iftex @c @hyphenation{time-stamp time-stamps time-"
#~ "stamp-ing time-stamp-ed} @end iftex"

#~ msgid ""
#~ "@c Subheadings inside a table.  @macro tsubheading{text} @ifinfo "
#~ "@subsubheading \\text\\ @end ifinfo @ifnotinfo @item @b{\\text\\} @end "
#~ "ifnotinfo @end macro"
#~ msgstr ""
#~ "@c Subheadings inside a table.  @macro tsubheading{text} @ifinfo "
#~ "@subsubheading \\text\\ @end ifinfo @ifnotinfo @item @b{\\text\\} @end "
#~ "ifnotinfo @end macro"

#~ msgid ""
#~ "@macro seealso{text} @noindent @b{Further reading}@*@noindent \\text\\ "
#~ "@end macro @copying"
#~ msgstr ""
#~ "@macro seealso{text} @noindent @b{Further reading}@*@noindent \\text\\ "
#~ "@end macro @copying"

#~ msgid ""
#~ "@dircategory Emacs @direntry * Org Mode Guide: (orgguide).  Abbreviated "
#~ "Org-mode Manual @end direntry"
#~ msgstr ""
#~ "@dircategory Emacs @direntry * Guia de Org: (orgguide). Manual\n"
#~ "Abreviado de Org-mode @end direntry"

#~ msgid "@subtitle Release @value{VERSION} @author by Carsten Dominik"
#~ msgstr "@subtitle Entrega @value{VERSION} @author por Carsten Dominik"

#~ msgid ""
#~ "@c The following two commands start the copyright page.  @page @vskip 0pt "
#~ "plus 1filll @insertcopying @end titlepage"
#~ msgstr ""
#~ "@c The following two commands start the copyright page.  @page @vskip 0pt "
#~ "plus 1filll @insertcopying @end titlepage"

#~ msgid "@c Output the table of contents at the beginning.  @shortcontents"
#~ msgstr "@c Output the table of contents at the beginning.  @shortcontents"

#~ msgid "@ifnottex @node Top, Introduction, (dir), (dir)  @top Org Mode Guide"
#~ msgstr ""
#~ "@ifnottex @node Top, Introducci@'on, (dir), (dir)  @top Gu@'{@dotless{i}}"
#~ "a de Org Mode"

#~ msgid "@insertcopying @end ifnottex"
#~ msgstr "@insertcopying @end ifnottex"

#, fuzzy
#~ msgid ""
#~ "@menu\n"
#~ "* Introduction::\t\tGetting started\n"
#~ "* Document Structure::\t\tA tree works like your brain\n"
#~ "* Tables::\t\t\tPure magic for quick formatting\n"
#~ "* Hyperlinks::\t\t\tNotes in context\n"
#~ "* TODO Items::\t\t\tEvery tree branch can be a TODO item\n"
#~ "* Tags::\t\t\tTagging headlines and matching sets of tags\n"
#~ "* Properties::\t\t\tProperties\n"
#~ "* Dates and Times::\t\tMaking items useful for planning\n"
#~ "* Capture - Refile - Archive::\tThe ins and outs for projects\n"
#~ "* Agenda Views::\t\tCollecting information into views\n"
#~ "* Markup::\t\t\tPrepare text for rich export\n"
#~ "* Exporting::\t\t\tSharing and publishing of notes\n"
#~ "* Publishing::\t\t\tCreate a web site of linked Org files\n"
#~ "* Working With Source Code::\tSource code snippets embedded in Org\n"
#~ "* Miscellaneous::\t\tAll the rest which did not fit elsewhere\n"
#~ msgstr ""
#~ "@menu\n"
#~ "* Introducci@'on::\t\t  Empezando\n"
#~ "* Estructura de los Documentos::  Un @'arbol funciona como tu cerebro\n"
#~ "* Tablas::\t\t\t  Magia pura para un formateo r@'apido\n"
#~ "* Hyperenlaces::\t\t  Notas en contexto\n"
#~ "* Items TODO::\t  Cada rama del @'arbol puede ser un item TODO\n"
#~ "* Etiquetas::\t\t\t  Etiquetando cabeceras y asignando\n"
#~ "conjuntos de etiquetas\n"
#~ "* Propiedades::\t\t\t  Propiedades\n"
#~ "* Fechas y Horas::\t\t  Haciendo items\n"
#~ "@'utiles para planificar\n"
#~ "* Capturar - Rellenar - Archivar:: Las entradas y salidas de los proyectos\n"
#~ "* Vistas de Agenda::\t\tColeccionando informaci@'on en vistas\n"
#~ "* Marcado::\t\t\tPreparar texto para exportar de manera\n"
#~ "enriquecida\n"
#~ "* Exportando::\t\t\tCompartiendo y publicando notas\n"
#~ "* Publicando::\t\t\tCrear un sitio web de ficheros Org enlazados\n"
#~ "* Trabajando con C@'odigo Fuente:: Fuentes de trozos de c@'odigo\n"
#~ "embebidos en Org\n"
#~ "* Miscel@'anea::\t\tEl resto de cosas que no se ajustan de\n"
#~ "otro modo\n"

#, fuzzy
#~| msgid "Tracking TODO state changes"
#~ msgid "Tracking TODO state changes::\t When did the status change?"
#~ msgstr "Seguimiento de los cambios de estados TODO"

#, fuzzy
#~| msgid "Capture"
#~ msgid "Capture::\t\t\t"
#~ msgstr "Capturar"

#, fuzzy
#~| msgid ""
#~| "Then add the following line to @file{.emacs}.  It is needed so that "
#~| "Emacs can autoload functions that are located in files not immediately "
#~| "loaded when Org-mode starts."
#~ msgid ""
#~ "Then add the following line to @file{.emacs}.  It is needed so that Emacs "
#~ "can autoload functions that are located in files not immediately loaded "
#~ "when Org-mode starts.  @smalllisp (require 'org-install)  @end smalllisp"
#~ msgstr ""
#~ "Entonces a@~nada la siguiente l@'{@dotless{i}}neas al archivo\n"
#~ "@file{.emacs}. Esto es necesario para que Emacs pueda cargar las\n"
#~ "funciones que est@'an localizadas en los archivos no inmediatamente\n"
#~ "cargados cuando el Org-mode se inicia."

#, fuzzy
#~| msgid "Literal examples"
#~ msgid "@smallexample"
#~ msgstr "Ejemplos literales"

#, fuzzy
#~| msgid "Literal examples"
#~ msgid "@end smallexample"
#~ msgstr "Ejemplos literales"

#, fuzzy
#~| msgid "#+TODO: TODO(t) WAIT(w@@/!) | DONE(d!) CANCELED(c@@)\n"
#~ msgid "#+TODO: TODO(t) | DONE(d)\n"
#~ msgstr "#+TODO: TODO(t) WAIT(w@@/!) | DONE(d!) CANCELED(c@@)\n"

#, fuzzy
#~| msgid "#+TAGS: @@work(w)  @@home(h)  @@tennisclub(t)  laptop(l)  pc(p)\n"
#~ msgid "#+TAGS: @@work @@home @@tennisclub\n"
#~ msgstr "#+TAGS: @@trabajo(t)  @@casa(c)  @@futbol(f)  servidor(s)  pc(p)\n"

#, fuzzy
#~| msgid ""
#~| "#+TAGS: @@work @@home @@tennisclub\n"
#~| "#+TAGS: laptop car pc sailboat\n"
#~ msgid "#+TAGS: laptop car pc sailboat\n"
#~ msgstr ""
#~ "#+TAGS: @@trabajo @@casa @@tenis\n"
#~ "#+TAGS: portátil coche pc velero\n"

#, fuzzy
#~| msgid ""
#~| "Show the global TODO list.  Collects the TODO items from all agenda "
#~| "files (@pxref{Agenda Views}) into a single buffer.  @xref{Global TODO "
#~| "list}, for more information."
#~ msgid ""
#~ "@table @kbd @item C-c a t Show the global TODO list.  This collects the "
#~ "TODO items from all agenda files (@pxref{Agenda Views}) into a single "
#~ "buffer.  @item C-c a T Like the above, but allows selection of a specific "
#~ "TODO keyword.  @end table"
#~ msgstr ""
#~ "Muestra la lista global de TODOs. Recolecta los @'{@dotless{i}}tems\n"
#~ "desde todos los ficheros de agenda (@pxref{Vistas de la Agenda}) en un\n"
#~ "solo buffer. @xref{Lista global TODO}, para m@'as informaci@'on."

#~ msgid "Refiling notes"
#~ msgstr "Moviendo notas"

#~ msgid "(require 'org-install)\n"
#~ msgstr "(require 'org-install)\n"

[-- Attachment #4: orgguide.es.texi --]
[-- Type: application/x-texinfo, Size: 107541 bytes --]

^ permalink raw reply	[relevance 1%]

* Fwd: Export to Texinfo
       [not found]               ` <CAHRqSkQTzE-OYmTFs+BRjrER=jgS3=2BE5Yi4A6v8ipaZ1kWQA@mail.gmail.com>
@ 2012-08-02 22:24  1%             ` Jonathan Leech-Pepin
  0 siblings, 0 replies; 59+ results
From: Jonathan Leech-Pepin @ 2012-08-02 22:24 UTC (permalink / raw)
  To: Org Mode Mailing List

[-- Attachment #1: Type: text/plain, Size: 2482 bytes --]

Forwarding to list, forgot to when replying


---------- Forwarded message ----------
From: Jonathan Leech-Pepin <jonathan.leechpepin@gmail.com>
Date: Thu, Aug 2, 2012 at 4:54 PM
Subject: Re: Export to Texinfo
To: Bastien <bzg@gnu.org>


Hi Bastien

On Thu, Aug 2, 2012 at 11:34 AM, Bastien <bzg@gnu.org> wrote:
> Hi Jonathan,
>
> Jonathan Leech-Pepin <jonathan.leechpepin@gmail.com> writes:
>
>> I've done some further work on the org-e-texinfo exporter and have
>> gotten it to a point where it should be usable with only a few
>> shortcomings.
>
> thanks *a lot* for this!  This is long-time wish from many org-ers,
> no doubt you will have many testers.
>
> Do you want to continue to develop while adding the library to
> contrib/lisp/?
>

Yes, that would be great.

> One problem with the version you sent:
>
> (org-export-first-sibling-p headline)
> (org-export-last-sibling-p headline)
>
> should be
>
> (org-export-first-sibling-p headline info)
> (org-export-last-sibling-p headline info)
>
> With this change I can export files correctly.

I'd caught that just after attaching the files the last time (I'd been
working with a slightly out of date copy so that change to
org-export-first-sibling-p hadn't affected me).  I'd updated it in my
working copy but hadn't added the changes in my next email to the
list.

The attached version fixes that and supports @ftable and @vtable
through #+attr_texinfo before descriptive lists.  (It can also be
found at :
https://github.com/jleechpe/org-mode/blob/texinfo/contrib/lisp/org-e-texinfo.el
)

>
> Another thingy: headlines from level 4 are converted to lists,
> right?  I'm fine with this, as long as the list is not collapsed
> with a previous one.  See the .org and .texi files attached.
>

It's able to export up to level 4 headlines (chapter, section,
subsection, subsubsection), however the default is H:3 so the last is
omitted.  Nested lists do work with only a small issue I can see at
the moment, if there are no blank lines between the items in org there
are none in the info file either, however there are 2 blank lines at
the end of the nested list (end of nested list+end of parent item).

When I export the attached .org file the only difference I get from
your .texi is the AUTHOR and the chapter/sections are numbered rather
than unnumbered (and the level 4 headline is an enumerate rather than
an itemize).

> Thanks again for this great contribution!
>

You're welcome

>
> --
>  Bastien
>

Regards,

--
Jon

[-- Attachment #2: org-e-texinfo.el --]
[-- Type: application/octet-stream, Size: 62862 bytes --]

;;; org-e-texinfo.el --- Texinfo Back-End For Org Export Engine

;; Author: Jonathan Leech-Pepin <jonathan.leechpepin at gmail dot com>
;; Keywords: outlines, hypermedia, calendar, wp

;; This program is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.

;; This program is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;; GNU General Public License for more details.

;; You should have received a copy of the GNU General Public License
;; along with this program.  If not, see <http://www.gnu.org/licenses/>.

;;; Commentary:
;;
;; This library implements a Texinfo back-end for Org generic
;; exporter.
;;
;; To test it, run
;;
;;   M-: (org-export-to-buffer 'e-texinfo "*Test e-texinfo*") RET
;;
;; in an org-mode buffer then switch to the buffer to see the Texinfo
;; export.  See contrib/lisp/org-export.el for more details on how
;; this exporter works.
;;
;; It introduces eight new buffer keywords: "TEXINFO_CLASS",
;; "TEXINFO_FILENAME", "TEXINFO_HEADER", "TEXINFO_DIR_CATEGORY",
;; "TEXINFO_DIR_TITLE", "TEXINFO_DIR_DESC" "SUBTITLE" and "SUBAUTHOR".
;;
;; To include inline code snippets (for example for generating @kbd{}
;; and @key{} commands), the following export-snippet keys are
;; accepted:
;; 
;;     info
;;     e-info
;;     e-texinfo
;;
;; You can add them for export snippets via any of the below:
;;
;;    (add-to-list 'org-export-snippet-translation-alist
;;                 '("e-info" . "e-texinfo"))
;;    (add-to-list 'org-export-snippet-translation-alist
;;                 '("e-texinfo" . "e-texinfo"))
;;    (add-to-list 'org-export-snippet-translation-alist
;;                 '("info" . "e-texinfo"))
;; 


;;; Code:

(eval-when-compile (require 'cl))
(require 'org-export)

(defvar orgtbl-exp-regexp)

\f
;;; Define Back-End

(defvar org-e-texinfo-translate-alist
  '((babel-call . org-e-texinfo-babel-call)
    (bold . org-e-texinfo-bold)
    (center-block . org-e-texinfo-center-block)
    (clock . org-e-texinfo-clock)
    (code . org-e-texinfo-code)
    (comment . org-e-texinfo-comment)
    (comment-block . org-e-texinfo-comment-block)
    (drawer . org-e-texinfo-drawer)
    (dynamic-block . org-e-texinfo-dynamic-block)
    (entity . org-e-texinfo-entity)
    (example-block . org-e-texinfo-example-block)
    (export-block . org-e-texinfo-export-block)
    (export-snippet . org-e-texinfo-export-snippet)
    (fixed-width . org-e-texinfo-fixed-width)
    (footnote-definition . org-e-texinfo-footnote-definition)
    (footnote-reference . org-e-texinfo-footnote-reference)
    (headline . org-e-texinfo-headline)
    (horizontal-rule . org-e-texinfo-horizontal-rule)
    (inline-babel-call . org-e-texinfo-inline-babel-call)
    (inline-src-block . org-e-texinfo-inline-src-block)
    (inlinetask . org-e-texinfo-inlinetask)
    (italic . org-e-texinfo-italic)
    (item . org-e-texinfo-item)
    (keyword . org-e-texinfo-keyword)
    (latex-environment . org-e-texinfo-latex-environment)
    (latex-fragment . org-e-texinfo-latex-fragment)
    (line-break . org-e-texinfo-line-break)
    (link . org-e-texinfo-link)
    (macro . org-e-texinfo-macro)
    (paragraph . org-e-texinfo-paragraph)
    (plain-list . org-e-texinfo-plain-list)
    (plain-text . org-e-texinfo-plain-text)
    (planning . org-e-texinfo-planning)
    (property-drawer . org-e-texinfo-property-drawer)
    (quote-block . org-e-texinfo-quote-block)
    (quote-section . org-e-texinfo-quote-section)
    (radio-target . org-e-texinfo-radio-target)
    (section . org-e-texinfo-section)
    (special-block . org-e-texinfo-special-block)
    (src-block . org-e-texinfo-src-block)
    (statistics-cookie . org-e-texinfo-statistics-cookie)
    (strike-through . org-e-texinfo-strike-through)
    (subscript . org-e-texinfo-subscript)
    (superscript . org-e-texinfo-superscript)
    (table . org-e-texinfo-table)
    (table-cell . org-e-texinfo-table-cell)
    (table-row . org-e-texinfo-table-row)
    (target . org-e-texinfo-target)
    (template . org-e-texinfo-template)
    (timestamp . org-e-texinfo-timestamp)
    (underline . org-e-texinfo-underline)
    (verbatim . org-e-texinfo-verbatim)
    (verse-block . org-e-texinfo-verse-block))
  "Alist between element or object types and translators.")

(defconst org-e-texinfo-options-alist
  '((:texinfo-filename "TEXINFO_FILENAME" nil org-e-texinfo-filename t)
    (:texinfo-class "TEXINFO_CLASS" nil org-e-texinfo-default-class t)
    (:texinfo-header "TEXINFO_HEADER" nil nil newline)
    (:subtitle "SUBTITLE" nil nil newline)
    (:subauthor "SUBAUTHOR" nil nil newline)
    (:texinfo-dircat "TEXINFO_DIR_CATEGORY" nil nil t)
    (:texinfo-dirtitle "TEXINFO_DIR_TITLE" nil nil t)
    (:texinfo-dirdesc "TEXINFO_DIR_DESC" nil nil t))
  "Alist between Texinfo export properties and ways to set them.
See `org-export-options-alist' for more information on the
structure of the values.

SUBAUTHOR and SUBTITLE are for the inclusion of additional author
and title information beyond the initial variable.")

(defconst org-e-texinfo-filters-alist
  '((:filter-headline . org-e-texinfo-filter-section-blank-lines)
    (:filter-section . org-e-texinfo-filter-section-blank-lines))
  "Alist between filters keywords and back-end specific filters.
  See `org-export-filters-alist' for more information")


\f
;;; Internal Variables

;; Add TEXINFO to the list of available of available export blocks.
(add-to-list 'org-element-block-name-alist
	     '("TEXINFO" . org-element-export-block-parser))
\f
;;; User Configurable Variables

(defgroup org-export-e-texinfo nil
  "Options for exporting Org mode files to Texinfo."
  :tag "Org Export Texinfo"
  :group 'org-export)


;;;; Preamble

(defcustom org-e-texinfo-filename nil
  "Default filename for texinfo output."
  :group 'org-export-e-texinfo
  :type '(string :tag "Export Filename"))

(defcustom org-e-texinfo-default-class "info"
  "The default Texinfo class."
  :group 'org-export-e-texinfo
  :type '(string :tag "Texinfo class"))

(defcustom org-e-texinfo-classes
  '(("info"
     "\\input texinfo    @c -*- texinfo -*-"
     ("@chapter %s" . "@unnumbered %s")
     ("@section %s" . "@unnumberedsec %s")
     ("@subsection %s" . "@unnumberedsubsec %s")
     ("@subsubsection %s" . "@unnumberedsubsubsec %s")))
  "Alist of Texinfo classes and associated header and structure.
If #+Texinfo_CLASS is set in the buffer, use its value and the
associated information.  Here is the structure of each cell:

  \(class-name
    header-string
    \(numbered-section . unnumbered-section\)
    ...\)

The sectioning structure
------------------------

The sectioning structure of the class is given by the elements
following the header string.  For each sectioning level, a number
of strings is specified.  A %s formatter is mandatory in each
section string and will be replaced by the title of the section.

Instead of a list of sectioning commands, you can also specify
a function name.  That function will be called with two
parameters, the \(reduced) level of the headline, and a predicate
non-nil when the headline should be numbered.  It must return
a format string in which the section title will be added."
  :group 'org-export-e-texinfo
  :type '(repeat
	  (list (string :tag "Texinfo class")
		(string :tag "Texinfo header")
		(repeat :tag "Levels" :inline t
			(choice
			 (cons :tag "Heading"
			       (string :tag "  numbered")
			       (string :tag "unnumbered"))
			 (function :tag "Hook computing sectioning"))))))


;;;; Headline

(defcustom org-e-texinfo-format-headline-function nil
  "Function to format headline text.

This function will be called with 5 arguments:
TODO      the todo keyword (string or nil).
TODO-TYPE the type of todo (symbol: `todo', `done', nil)
PRIORITY  the priority of the headline (integer or nil)
TEXT      the main headline text (string).
TAGS      the tags as a list of strings (list of strings or nil).

The function result will be used in the section format string.

As an example, one could set the variable to the following, in
order to reproduce the default set-up:

\(defun org-e-texinfo-format-headline (todo todo-type priority text tags)
  \"Default format function for an headline.\"
  \(concat (when todo
            \(format \"\\\\textbf{\\\\textsc{\\\\textsf{%s}}} \" todo))
	  \(when priority
            \(format \"\\\\framebox{\\\\#%c} \" priority))
	  text
	  \(when tags
            \(format \"\\\\hfill{}\\\\textsc{%s}\"
              \(mapconcat 'identity tags \":\"))))"
  :group 'org-export-e-texinfo
  :type 'function)


;;;; Footnotes
;;
;; Footnotes are inserted directly

;;;; Timestamps

(defcustom org-e-texinfo-active-timestamp-format "@emph{%s}"
  "A printf format string to be applied to active timestamps."
  :group 'org-export-e-texinfo
  :type 'string)

(defcustom org-e-texinfo-inactive-timestamp-format "@emph{%s}"
  "A printf format string to be applied to inactive timestamps."
  :group 'org-export-e-texinfo
  :type 'string)

(defcustom org-e-texinfo-diary-timestamp-format "@emph{%s}"
  "A printf format string to be applied to diary timestamps."
  :group 'org-export-e-texinfo
  :type 'string)

;;;; Links

(defcustom org-e-texinfo-link-with-unknown-path-format "@indicateurl{%s}"
  "Format string for links with unknown path type."
  :group 'org-export-e-texinfo
  :type 'string)


;;;; Tables

(defcustom org-e-texinfo-tables-verbatim nil
  "When non-nil, tables are exported verbatim."
  :group 'org-export-e-texinfo
  :type 'boolean)

(defcustom org-e-texinfo-table-scientific-notation "%s\\,(%s)"
  "Format string to display numbers in scientific notation.
The format should have \"%s\" twice, for mantissa and exponent
\(i.e. \"%s\\\\times10^{%s}\").

When nil, no transformation is made."
  :group 'org-export-e-texinfo
  :type '(choice
	  (string :tag "Format string")
	  (const :tag "No formatting")))

(defcustom org-e-texinfo-def-table-markup "@samp"
  "Default setting for @table environments.")

;;;; Text markup

(defcustom org-e-texinfo-text-markup-alist '((bold . "@strong{%s}")
					   (code . code)
					   (italic . "@emph{%s}")
					   (verbatim . verb)
					   (comment . "@c %s"))
  "Alist of Texinfo expressions to convert text markup.

The key must be a symbol among `bold', `italic' and `comment'.
The value is a formatting string to wrap fontified text with.

Value can also be set to the following symbols: `verb' and
`code'.  For the former, Org will use \"@verb\" to
create a format string and select a delimiter character that
isn't in the string.  For the latter, Org will use \"@code\"
to typeset and try to protect special characters.

If no association can be found for a given markup, text will be
returned as-is."
  :group 'org-export-e-texinfo
  :type 'alist
  :options '(bold code italic verbatim comment))


;;;; Drawers

(defcustom org-e-texinfo-format-drawer-function nil
  "Function called to format a drawer in Texinfo code.

The function must accept two parameters:
  NAME      the drawer name, like \"LOGBOOK\"
  CONTENTS  the contents of the drawer.

The function should return the string to be exported.

For example, the variable could be set to the following function
in order to mimic default behaviour:

\(defun org-e-texinfo-format-drawer-default \(name contents\)
  \"Format a drawer element for Texinfo export.\"
  contents\)"
  :group 'org-export-e-texinfo
  :type 'function)


;;;; Inlinetasks

(defcustom org-e-texinfo-format-inlinetask-function nil
  "Function called to format an inlinetask in Texinfo code.

The function must accept six parameters:
  TODO      the todo keyword, as a string
  TODO-TYPE the todo type, a symbol among `todo', `done' and nil.
  PRIORITY  the inlinetask priority, as a string
  NAME      the inlinetask name, as a string.
  TAGS      the inlinetask tags, as a list of strings.
  CONTENTS  the contents of the inlinetask, as a string.

The function should return the string to be exported.

For example, the variable could be set to the following function
in order to mimic default behaviour:

\(defun org-e-texinfo-format-inlinetask \(todo type priority name tags contents\)
\"Format an inline task element for Texinfo export.\"
  \(let ((full-title
	 \(concat
	  \(when todo
            \(format \"@strong{%s} \" todo))
	  \(when priority (format \"#%c \" priority))
	  title
	  \(when tags
            \(format \":%s:\"
                    \(mapconcat 'identity tags \":\")))))
    \(format (concat \"@center %s\n\n\"
		    \"%s\"
                    \"\n\"))
	    full-title contents))"
  :group 'org-export-e-texinfo
  :type 'function)


;;;; Src blocks
;;
;; Src Blocks are example blocks, except for LISP

;;;; Plain text

(defcustom org-e-texinfo-quotes
  '(("quotes"
     ("\\(\\s-\\|[[(]\\|^\\)\"" . "``")
     ("\\(\\S-\\)\"" . "''")
     ("\\(\\s-\\|(\\|^\\)'" . "`")))
  "Alist for quotes to use when converting english double-quotes.

The CAR of each item in this alist is the language code.
The CDR of each item in this alist is a list of three CONS:
- the first CONS defines the opening quote;
- the second CONS defines the closing quote;
- the last CONS defines single quotes.

For each item in a CONS, the first string is a regexp
for allowed characters before/after the quote, the second
string defines the replacement string for this quote."
  :group 'org-export-e-texinfo
  :type '(list
	  (cons :tag "Opening quote"
		(string :tag "Regexp for char before")
		(string :tag "Replacement quote     "))
	  (cons :tag "Closing quote"
		(string :tag "Regexp for char after ")
		(string :tag "Replacement quote     "))
	  (cons :tag "Single quote"
		(string :tag "Regexp for char before")
		(string :tag "Replacement quote     "))))


;;;; Compilation

(defcustom org-e-texinfo-info-process
  '("makeinfo %f")
  "Commands to process a texinfo file to an INFO file.
This is list of strings, each of them will be given to the shell
as a command.  %f in the command will be replaced by the full
file name, %b by the file base name \(i.e without extension) and
%o by the base directory of the file."
  :group 'org-export-texinfo
  :type '(repeat :tag "Shell command sequence"
		 (string :tag "Shell command")))

\f
;;; Internal Functions

(defun org-e-texinfo-filter-section-blank-lines (headline back-end info)
  "Filter controlling number of blank lines after a section."
  (if (not (eq back-end 'e-texinfo)) headline
    (let ((blanks (make-string 2 ?\n)))
      (replace-regexp-in-string "\n\\(?:\n[ \t]*\\)*\\'" blanks headline))))

(defun org-e-texinfo--find-copying (info)
  "Retrieve the headline identified by the property :copying:.

INFO is the plist containing the export options and tree.  It is
used to find and extract the single desired headline.  This
cannot be treated as a standard headline since it must be
inserted in a specific location."
  (let (copying)
    (org-element-map (plist-get info :parse-tree) 'headline
		     (lambda (copy)
		       (when (org-element-property :copying copy)
			 (push copy copying))) info 't)
    ;; Retrieve the single entry
    (car copying)))

(defun org-e-texinfo--find-verb-separator (s)
  "Return a character not used in string S.
This is used to choose a separator for constructs like \\verb."
  (let ((ll "~,./?;':\"|!@#%^&-_=+abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ<>()[]{}"))
    (loop for c across ll
	  when (not (string-match (regexp-quote (char-to-string c)) s))
	  return (char-to-string c))))

(defun org-e-texinfo--make-option-string (options)
  "Return a comma separated string of keywords and values.
OPTIONS is an alist where the key is the options keyword as
a string, and the value a list containing the keyword value, or
nil."
  (mapconcat (lambda (pair)
	       (concat (first pair)
		       (when (> (length (second pair)) 0)
			 (concat "=" (second pair)))))
	     options
	     ","))

(defun org-e-texinfo--quotation-marks (text info)
  "Export quotation marks using ` and ' as the markers.
TEXT is a string containing quotation marks to be replaced.  INFO
is a plist used as a communication channel."
  (mapc (lambda(l)
	  (let ((start 0))
	    (while (setq start (string-match (car l) text start))
	      (let ((new-quote (concat (match-string 1 text) (cdr l))))
		(setq text (replace-match new-quote  t t text))))))
	(cdr org-e-texinfo-quotes))
  text)

(defun org-e-texinfo--text-markup (text markup)
  "Format TEXT depending on MARKUP text markup.
See `org-e-texinfo-text-markup-alist' for details."
  (let ((fmt (cdr (assq markup org-e-texinfo-text-markup-alist))))
    (cond
     ;; No format string: Return raw text.
     ((not fmt) text)
     ((eq 'verb fmt)
      (let ((separator (org-e-texinfo--find-verb-separator text)))
	(concat "@verb{" separator text separator "}")))
     ((eq 'code fmt)
      (let ((start 0)
	    (rtn "")
	    char)
	(while (string-match "[@{}]" text)
	  (setq char (match-string 0 text))
	  (if (> (match-beginning 0) 0)
	      (setq rtn (concat rtn (substring text 0 (match-beginning 0)))))
	  (setq text (substring text (1+ (match-beginning 0))))
	  (setq char (concat "@" char)
		rtn (concat rtn char)))
	(setq text (concat rtn text)
	      fmt "@code{%s}")
	(format fmt text)))
     ;; Else use format string.
     (t (format fmt text)))))

;;;; Menu creation

(defun org-e-texinfo--build-menu (tree level info &optional detailed)
  "Create the @menu/@end menu information from TREE at headline
level LEVEL.

TREE contains the parse-tree to work with, either of the entire
document or of a specific parent headline.  LEVEL indicates what
level of headlines to look at when generating the menu.  INFO is
a plist containing contextual information.

Detailed determines whether to build a single level of menu, or
recurse into all children as well."
  (let ((menu (org-e-texinfo--generate-menu-list tree level info))
	output text-menu)
    (cond
     (detailed
      ;; Looping is done within the menu generation.
      (setq text-menu (org-e-texinfo--generate-detailed menu level info)))
     (t
      (setq text-menu (org-e-texinfo--generate-menu-items menu info))))
    (when text-menu
      (setq output (org-e-texinfo--format-menu text-menu))
      (mapconcat 'identity output "\n"))))

(defun org-e-texinfo--generate-detailed (menu level info)
  "Generate a detailed listing of all subheadings within MENU starting at LEVEL.

MENU is the parse-tree to work with.  LEVEL is the starting level
for the menu headlines and from which recursion occurs.  INFO is
a plist containing contextual information."
  (let ((max-depth (plist-get info :headline-levels)))
    (when (> max-depth level)
      (loop for headline in menu append
	    (let* ((title (org-e-texinfo--menu-headlines headline info))
		   ;; Create list of menu entries for the next level
		   (sublist (org-e-texinfo--generate-menu-list
			     headline (1+ level) info))
		   ;; Generate the menu items for that level.  If
		   ;; there are none omit that heading completely,
		   ;; otherwise join the title to it's related entries.
		   (submenu (if (org-e-texinfo--generate-menu-items sublist info)
				(append (list title)
					(org-e-texinfo--generate-menu-items sublist info))
			      'nil))
		   ;; Start the process over the next level down.
		   (recursion (org-e-texinfo--generate-detailed sublist (1+ level) info)))
	      (setq recursion (append submenu recursion))
	      recursion)))))

(defun org-e-texinfo--generate-menu-list (tree level info)
  "Generate the list of headlines that are within a given level
of the tree for further formatting.

TREE is the parse-tree containing the headlines.  LEVEL is the
headline level to generate a list of.  INFO is a plist holding
contextual information."
  (let (seq)
    (org-element-map
     tree 'headline
     (lambda (head)
       (when (org-element-property :level head)
	 (if (and (eq level (org-element-property :level head))
		  ;; Do not take note of footnotes or copying headlines
		  (not (org-element-property :copying head))
		  (not (org-element-property :footnote-section-p head)))
	     (push head seq)))))
    ;; Return the list of headlines (reverse to have in actual order)
    (reverse seq)))

(defun org-e-texinfo--generate-menu-items (items info)
  "Generate a list of headline information from the listing ITEMS.

ITEMS is a list of the headlines to be converted into entries.
INFO is a plist containing contextual information.

Returns a list containing the following information from each
headline: length, title, description.  This is used to format the
menu using `org-e-texinfo--format-menu'."
  (loop for headline in items collect
	(let* ((title (org-export-data
		       (org-element-property :title headline) info))
	       (descr (org-export-data
		       (org-element-property :description headline) info))
	       (len (length title))
	       (output (list len title descr)))
	  output)))

(defun org-e-texinfo--menu-headlines (headline info)
  "Retrieve the title from HEADLINE.

INFO is a plist holding contextual information.

Return the headline as a list of (length title description) with
length of -1 and nil description.  This is used in
`org-e-texinfo--format-menu' to identify headlines as opposed to
entries."
  (let ((title (org-export-data
		(org-element-property :title headline) info)))
    (list -1 title 'nil)))

(defun org-e-texinfo--format-menu (text-menu)
  "Format the TEXT-MENU items to be properly printed in the menu.

Each entry in the menu should be provided as (length title
description).

Headlines in the detailed menu are given length -1 to ensure they
are never confused with other entries.  They also have no
description.

Other menu items are output as:
    Title::     description

With the spacing between :: and description based on the length
of the longest menu entry."

  (let* ((lengths (mapcar 'car text-menu))
         (max-length (apply 'max lengths))
	 output)
    (setq output
          (mapcar (lambda (name)
                    (let* ((title (nth 1 name))
                           (desc (nth 2 name))
                           (length (nth 0 name)))
                      (if (> length -1)
                          (concat "* " title ":: "
                                  (make-string
				   (- (+ 3 max-length) length)
                                               ?\s)
                                  (if desc
                                      (concat desc)))
                        (concat "\n" title "\n"))))
		  text-menu))
    output))



;;; Template

(defun org-e-texinfo-template (contents info)
  "Return complete document string after Texinfo conversion.
CONTENTS is the transcoded contents string.  INFO is a plist
holding export options."
  (let* ((title (org-export-data (plist-get info :title) info))
	 (info-filename (or (plist-get info :texinfo-filename)
			    (file-name-nondirectory
			     (org-export-output-file-name ".info"))))
	 (author (org-export-data (plist-get info :author) info))
	 (texinfo-header (plist-get info :texinfo-header))
	 (subtitle (plist-get info :subtitle))
	 (subauthor (plist-get info :subauthor))
	 (class (plist-get info :texinfo-class))
	 (header (nth 1 (assoc class org-e-texinfo-classes)))
	 (copying (org-e-texinfo--find-copying info))
	 (dircat (plist-get info :texinfo-dircat))
	 (dirtitle (plist-get info :texinfo-dirtitle))
	 (dirdesc (plist-get info :texinfo-dirdesc))
	 ;; Spacing to align description (column 32 - 3 for `* ' and
	 ;; `.' in text.
	 (dirspacing (- 29 (length dirtitle))))
    (concat
     ;; Header
     header "\n"
     "@c %**start of header\n"
     ;; Filename and Title
     "@setfilename " info-filename "\n"
     "@settitle " title "\n"
     "\n\n"
     "@c Version and Contact Info\n"
     "@set AUTHOR " author "\n"

     ;; Additional Header Options set by `#+TEXINFO_HEADER
     (if texinfo-header
	 (concat "\n"
		 texinfo-header
		 "\n"))
     
     "@c %**end of header\n"
     "@finalout\n"
     "\n\n"

     ;; Copying
     "@copying\n"
     ;; Only export the content of the headline, do not need the
     ;; initial headline.
     (org-export-data (nth 2 copying) info)
     "@end copying\n"
     "\n\n"

     ;; Info directory information
     ;; Only supply if both title and category are provided
     (if (and dircat dirtitle)
	 (concat "@dircategory " dircat "\n"
		 "@direntry\n"
		 "* " dirtitle "."
		 (make-string dirspacing ?\s)
		 dirdesc "\n"
		 "@end direntry\n"))
     "\n\n"

     ;; Title
     "@titlepage\n"
     "@title " title "\n\n"
     (if subtitle
	 (concat "@subtitle " subtitle "\n"))
     "@author " author "\n"
     (if subauthor
	 (concat subauthor "\n"))
     "\n"
     "@c The following two commands start the copyright page.\n"
     "@page\n"
     "@vskip 0pt plus 1filll\n"
     "@insertcopying\n"
     "@end titlepage\n\n"
     "@c Output the table of contents at the beginning.\n"
     "@contents\n\n"

     ;; Configure Top Node when not for Tex
     "@ifnottex\n"
     "@node Top\n"
     "@top " title " Manual\n"
     "@insertcopying\n"
     "@end ifnottex\n\n"
     
     ;; Menu
     "@menu\n"
     (org-e-texinfo-make-menu info 'main)
     "\n\n"
     ;; Detailed Menu
     "@detailmenu\n"
     " --- The Detailed Node Listing ---\n"
     (org-e-texinfo-make-menu info 'detailed)
     "\n\n"
     "@end detailmenu\n"
     "@end menu\n"
     "\n\n"
     
     ;; Document's body.
     contents
     "\n"
     ;; Creator.
     (let ((creator-info (plist-get info :with-creator)))
       (cond
	((not creator-info) "")
	((eq creator-info 'comment)
	 (format "@c %s\n" (plist-get info :creator)))
	(t (concat (plist-get info :creator) "\n"))))
     ;; Document end.
     "\n@bye")))


\f
;;; Transcode Functions

;;;; Babel Call
;;
;; Babel Calls are ignored.


;;;; Bold

(defun org-e-texinfo-bold (bold contents info)
  "Transcode BOLD from Org to Texinfo.
CONTENTS is the text with bold markup.  INFO is a plist holding
contextual information."
  (org-e-texinfo--text-markup contents 'bold))


;;;; Center Block
;;
;; Center blocks are ignored


;;;; Clock

(defun org-e-texinfo-clock (clock contents info)
  "Transcode a CLOCK element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  (concat
   "@noindent"
   (format "@strong{%s} " org-clock-string)
   (format org-e-texinfo-inactive-timestamp-format
	   (concat (org-translate-time (org-element-property :value clock))
		   (let ((time (org-element-property :time clock)))
		     (and time (format " (%s)" time)))))
   "@*"))


;;;; Code

(defun org-e-texinfo-code (code contents info)
  "Transcode a CODE object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist used as a communication
channel."
  (org-e-texinfo--text-markup (org-element-property :value code) 'code))

;;;; Comment

(defun org-e-texinfo-comment (comment contents info)
  "Transcode a COMMENT object from Org to Texinfo.
CONTENTS is the text in the comment.  INFO is a plist holding
contextual information."
  (org-e-texinfo--text-markup (org-element-property :value comment) 'comment))

;;;; Comment Block

(defun org-e-texinfo-comment-block (comment-block contents info)
  "Transcode a COMMENT-BLOCK object from Org to Texinfo.
CONTENTS is the text within the block.  INFO is a plist holding
contextual information."
  (format "@ignore\n%s@end ignore" (org-element-property :value comment-block)))

;;;; Drawer

(defun org-e-texinfo-drawer (drawer contents info)
  "Transcode a DRAWER element from Org to Texinfo.
CONTENTS holds the contents of the block.  INFO is a plist
holding contextual information."
  (let* ((name (org-element-property :drawer-name drawer))
	 (output (if (functionp org-e-texinfo-format-drawer-function)
		     (funcall org-e-texinfo-format-drawer-function
			      name contents)
		   ;; If there's no user defined function: simply
		   ;; display contents of the drawer.
		   contents)))
    output))


;;;; Dynamic Block

(defun org-e-texinfo-dynamic-block (dynamic-block contents info)
  "Transcode a DYNAMIC-BLOCK element from Org to Texinfo.
CONTENTS holds the contents of the block.  INFO is a plist
holding contextual information.  See `org-export-data'."
  contents)


;;;; Entity

(defun org-e-texinfo-entity (entity contents info)
  "Transcode an ENTITY object from Org to Texinfo.
CONTENTS are the definition itself.  INFO is a plist holding
contextual information."
  (let ((ent (org-element-property :latex entity)))
    (if (org-element-property :latex-math-p entity) (format "@math{%s}" ent) ent)))


;;;; Example Block

(defun org-e-texinfo-example-block (example-block contents info)
  "Transcode an EXAMPLE-BLOCK element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  (format "@verbatim\n%s@end verbatim"
	  (org-export-format-code-default example-block info)))


;;;; Export Block

(defun org-e-texinfo-export-block (export-block contents info)
  "Transcode a EXPORT-BLOCK element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (when (string= (org-element-property :type export-block) "TEXINFO")
    (org-remove-indentation (org-element-property :value export-block))))


;;;; Export Snippet

(defun org-e-texinfo-export-snippet (export-snippet contents info)
  "Transcode a EXPORT-SNIPPET object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (when (eq (org-export-snippet-backend export-snippet) 'e-texinfo)
    (org-element-property :value export-snippet)))


;;;; Fixed Width

(defun org-e-texinfo-fixed-width (fixed-width contents info)
  "Transcode a FIXED-WIDTH element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (format "@example\n%s\n@end example"
	  (org-remove-indentation
	   (org-element-property :value fixed-width))))


;;;; Footnote Definition
;;
;; Footnote Definitions are ignored.


;;;; Footnote Reference
;;

(defun org-e-texinfo-footnote-reference (footnote contents info)
  "Create a footnote reference for FOOTNOTE.

FOOTNOTE is the footnote to define.  CONTENTS is nil.  INFO is a
plist holding contextual information."
  (let ((def (org-export-get-footnote-definition footnote info)))
    (format "@footnote{%s}"
	    (org-trim (org-export-data def info)))))

;;;; Headline

(defun org-e-texinfo-headline (headline contents info)
  "Transcode an HEADLINE element from Org to Texinfo.
CONTENTS holds the contents of the headline.  INFO is a plist
holding contextual information."
  (let* ((class (plist-get info :texinfo-class))
	 (level (org-export-get-relative-level headline info))
	 (numberedp (org-export-numbered-headline-p headline info))
	 (class-sectionning (assoc class org-e-texinfo-classes))
	 ;; Find the index type, if any
	 (index (org-element-property :index headline))
	 ;; Create node info, to insert it before section formatting.
	 (node (format "@node %s\n"
		       (org-export-data
			(org-element-property :title headline) info)))
	 ;; Menus must be generated with first child, otherwise they
	 ;; will not nest properly
	 (menu (let* ((first (org-export-first-sibling-p headline info))
		      (parent (org-export-get-parent-headline headline))
		      (title (org-export-data
			      (org-element-property :title parent) info))
		      heading listing
		      (tree (plist-get info :parse-tree)))
		 (if first
		     (org-element-map
		      (plist-get info :parse-tree) 'headline
		      (lambda (ref)
			(if (member title (org-element-property :title ref))
			    (push ref heading)))
		      info 't))
		 (setq listing (org-e-texinfo--build-menu
				(car heading) level info))
	 	 (if listing
	 	     (setq listing (format
				    "\n@menu\n%s\n@end menu\n\n" listing))
	 	   'nil)))
	 ;; Section formatting will set two placeholders: one for the
	 ;; title and the other for the contents.
	 (section-fmt
	  (let ((sec (if (and (symbolp (nth 2 class-sectionning))
			      (fboundp (nth 2 class-sectionning)))
			 (funcall (nth 2 class-sectionning) level numberedp)
		       (nth (1+ level) class-sectionning))))
	    (cond
	     ;; No section available for that LEVEL.
	     ((not sec) nil)
	     ;; Section format directly returned by a function.
	     ((stringp sec) sec)
	     ;; (numbered-section . unnumbered-section)
	     ((not (consp (cdr sec)))
	      ;; If an index, always unnumbered
	      (if index
		  (concat menu node (cdr sec) "\n%s")
		;; Otherwise number as needed.
		(concat menu node
			(funcall
			 (if numberedp #'car #'cdr) sec) "\n%s"))))))
	 (text (org-export-data
		(org-element-property :title headline) info))
	 (todo
	  (and (plist-get info :with-todo-keywords)
	       (let ((todo (org-element-property :todo-keyword headline)))
		 (and todo (org-export-data todo info)))))
	 (todo-type (and todo (org-element-property :todo-type headline)))
	 (tags (and (plist-get info :with-tags)
		    (org-export-get-tags headline info)))
	 (priority (and (plist-get info :with-priority)
			(org-element-property :priority headline)))
	 ;; Create the headline text along with a no-tag version.  The
	 ;; latter is required to remove tags from table of contents.
	 (full-text (if (functionp org-e-texinfo-format-headline-function)
			;; User-defined formatting function.
			(funcall org-e-texinfo-format-headline-function
				 todo todo-type priority text tags)
		      ;; Default formatting.
		      (concat
		       (when todo
			 (format "@strong{%s} " todo))
		       (when priority (format "@emph{#%s} " priority))
		       text
		       (when tags
			 (format ":%s:"
				 (mapconcat 'identity tags ":"))))))
	 (full-text-no-tag
	  (if (functionp org-e-texinfo-format-headline-function)
	      ;; User-defined formatting function.
	      (funcall org-e-texinfo-format-headline-function
		       todo todo-type priority text nil)
	    ;; Default formatting.
	    (concat
	     (when todo (format "@strong{%s} " todo))
	     (when priority (format "@emph{#%c} " priority))
	     text)))
	 (pre-blanks
	  (make-string (org-element-property :pre-blank headline) 10)))
    (cond
     ;; Case 1: This is a footnote section: ignore it.
     ((org-element-property :footnote-section-p headline) nil)
     ;; Case 2: This is the `copying' section: ignore it
     ;;         This is used elsewhere.
     ((org-element-property :copying headline) nil)
     ;; Case 3: An index.  If it matches one of the known indexes,
     ;;         print it as such following the contents, otherwise
     ;;         print the contents and leave the index up to the user.
     (index
      (format
       section-fmt full-text
       (concat pre-blanks contents "\n" 
	       (if (member index '("cp" "fn" "ky" "pg" "tp" "vr"))
		   (concat "@printindex " index)))))
     ;; Case 4: This is a deep sub-tree: export it as a list item.
     ;;         Also export as items headlines for which no section
     ;;         format has been found.
     ((or (not section-fmt) (org-export-low-level-p headline info))
      ;; Build the real contents of the sub-tree.
      (let ((low-level-body
	     (concat
	      ;; If the headline is the first sibling, start a list.
	      (when (org-export-first-sibling-p headline info)
		(format "@%s\n" (if numberedp 'enumerate 'itemize)))
	      ;; Itemize headline
	      "@item\n" full-text "\n" pre-blanks contents)))
	;; If headline is not the last sibling simply return
	;; LOW-LEVEL-BODY.  Otherwise, also close the list, before any
	;; blank line.
	(if (not (org-export-last-sibling-p headline info)) low-level-body
	  (replace-regexp-in-string
	   "[ \t\n]*\\'"
	   (format "\n@end %s" (if numberedp 'enumerate 'itemize))
	   low-level-body))))
     ;; Case 5: Standard headline.  Export it as a section.
     (t
      (cond
       ((not (and tags (eq (plist-get info :with-tags) 'not-in-toc)))
	;; Regular section.  Use specified format string.
	(format (replace-regexp-in-string "%]" "%%]" section-fmt) full-text
		(concat pre-blanks contents)))
       ((string-match "\\`@\\(.*?\\){" section-fmt)
	;; If tags should be removed from table of contents, insert
	;; title without tags as an alternative heading in sectioning
	;; command.
	(format (replace-match (concat (match-string 1 section-fmt) "[%s]")
			       nil nil section-fmt 1)
		;; Replace square brackets with parenthesis since
		;; square brackets are not supported in optional
		;; arguments.
		(replace-regexp-in-string
		 "\\[" "("
		 (replace-regexp-in-string
		  "\\]" ")"
		  full-text-no-tag))
		full-text
		(concat pre-blanks contents)))
       (t
	;; Impossible to add an alternative heading.  Fallback to
	;; regular sectioning format string.
	(format (replace-regexp-in-string "%]" "%%]" section-fmt) full-text
		(concat pre-blanks contents))))))))


;;;; Horizontal Rule
;;
;; Horizontal rules are ignored

;;;; Inline Babel Call
;;
;; Inline Babel Calls are ignored.


;;;; Inline Src Block

(defun org-e-texinfo-inline-src-block (inline-src-block contents info)
  "Transcode an INLINE-SRC-BLOCK element from Org to Texinfo.
CONTENTS holds the contents of the item.  INFO is a plist holding
contextual information."
  (let* ((code (org-element-property :value inline-src-block))
	 (separator (org-e-texinfo--find-verb-separator code)))
    (concat "@verb{" separator code separator "}")))


;;;; Inlinetask

(defun org-e-texinfo-inlinetask (inlinetask contents info)
  "Transcode an INLINETASK element from Org to Texinfo.
CONTENTS holds the contents of the block.  INFO is a plist
holding contextual information."
  (let ((title (org-export-data (org-element-property :title inlinetask) info))
	(todo (and (plist-get info :with-todo-keywords)
		   (let ((todo (org-element-property :todo-keyword inlinetask)))
		     (and todo (org-export-data todo info)))))
	(todo-type (org-element-property :todo-type inlinetask))
	(tags (and (plist-get info :with-tags)
		   (org-export-get-tags inlinetask info)))
	(priority (and (plist-get info :with-priority)
		       (org-element-property :priority inlinetask))))
    ;; If `org-e-texinfo-format-inlinetask-function' is provided, call it
    ;; with appropriate arguments.
    (if (functionp org-e-texinfo-format-inlinetask-function)
	(funcall org-e-texinfo-format-inlinetask-function
		 todo todo-type priority title tags contents)
      ;; Otherwise, use a default template.
      (let ((full-title
	     (concat
	      (when todo (format "@strong{%s} " todo))
	      (when priority (format "#%c " priority))
	      title
	      (when tags (format ":%s:"
				 (mapconcat 'identity tags ":"))))))
	(format (concat "@center %s\n\n"
			"%s"
			"\n")
		full-title contents)))))


;;;; Italic

(defun org-e-texinfo-italic (italic contents info)
  "Transcode ITALIC from Org to Texinfo.
CONTENTS is the text with italic markup.  INFO is a plist holding
contextual information."
  (org-e-texinfo--text-markup contents 'italic))

;;;; Item

(defun org-e-texinfo-item (item contents info)
  "Transcode an ITEM element from Org to Texinfo.
CONTENTS holds the contents of the item.  INFO is a plist holding
contextual information."
  (let* ((tag (org-element-property :tag item))
	 (desc (org-export-data tag info)))
   (concat "\n@item " (if tag desc) "\n"
	   (org-trim contents) "\n")))


;;;; Keyword

(defun org-e-texinfo-keyword (keyword contents info)
  "Transcode a KEYWORD element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (let ((key (org-element-property :key keyword))
	(value (org-element-property :value keyword)))
    (cond
     ((string= key "TEXINFO") value)
     ((string= key "CINDEX") (format "@cindex %s" value))
     ((string= key "FINDEX") (format "@findex %s" value))
     ((string= key "KINDEX") (format "@kindex %s" value))
     ((string= key "PINDEX") (format "@pindex %s" value))
     ((string= key "TINDEX") (format "@tindex %s" value))
     ((string= key "VINDEX") (format "@vindex %s" value))
     )))


;;;; Latex Environment
;;
;; Latex environments are ignored


;;;; Latex Fragment
;;
;; Latex fragments are ignored.


;;;; Line Break

(defun org-e-texinfo-line-break (line-break contents info)
  "Transcode a LINE-BREAK object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  "@*")


;;;; Link

(defun org-e-texinfo-link (link desc info)
  "Transcode a LINK object from Org to Texinfo.

DESC is the description part of the link, or the empty string.
INFO is a plist holding contextual information.  See
`org-export-data'."
  (let* ((type (org-element-property :type link))
	 (raw-path (org-element-property :path link))
	 ;; Ensure DESC really exists, or set it to nil.
	 (desc (and (not (string= desc "")) desc))
	 (path (cond
		((member type '("http" "https" "ftp"))
		 (concat type ":" raw-path))
		((string= type "file")
		 (when (string-match "\\(.+\\)::.+" raw-path)
		   (setq raw-path (match-string 1 raw-path)))
		 (if (file-name-absolute-p raw-path)
		     (concat "file://" (expand-file-name raw-path))
		   (concat "file://" raw-path)))
		(t raw-path)))
	 (email (if (string= type "mailto")
		    (let ((text (replace-regexp-in-string
				 "@" "@@" raw-path)))
		     (concat text (if desc (concat "," desc))))))
	 protocol)
    (cond
     ;; Links pointing to an headline: Find destination and build
     ;; appropriate referencing command.
     ((member type '("custom-id" "id"))
      (let ((destination (org-export-resolve-id-link link info)))
	(case (org-element-type destination)
	  ;; Id link points to an external file.
	  (plain-text
	   (if desc (format "@uref{file://%s,%s}" destination desc)
	     (format "@uref{file://%s}" destination)))
	  ;; LINK points to an headline.  Use the headline as the NODE target
	  (headline
	   (format "@ref{%s}"
		   (org-export-data
		    (org-element-property :title destination) info)))
	  (otherwise
	   (let ((path (org-export-solidify-link-text path)))
	     (if (not desc) (format "@ref{%s}" path)
	       (format "@ref{%s,,%s}" path desc)))))))
     ((member type '("fuzzy"))
      (let ((destination (org-export-resolve-fuzzy-link link info)))
	(case (org-element-type destination)
	  ;; Id link points to an external file.
	  (plain-text
	   (if desc (format "@uref{file://%s,%s}" destination desc)
	     (format "@uref{file://%s}" destination)))
	  ;; LINK points to an headline.  Use the headline as the NODE target
	  (headline
	   (format "@ref{%s}"
		   (org-export-data
		    (org-element-property :title destination) info)))
	  (otherwise
	   (let ((path (org-export-solidify-link-text path)))
	     (if (not desc) (format "@ref{%s}" path)
	       (format "@ref{%s,,%s}" path desc)))))))
     ;; Special case for email addresses
     (email
      (format "@email{%s}" email))
     ;; External link with a description part.
     ((and path desc) (format "@uref{%s,%s}" path desc))
     ;; External link without a description part.
     (path (format "@uref{%s}" path))
     ;; No path, only description.  Try to do something useful.
     (t (format org-e-texinfo-link-with-unknown-path-format desc)))))


;;;; Macro

(defun org-e-texinfo-macro (macro contents info)
  "Transcode a MACRO element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  ;; Use available tools.
  (org-export-expand-macro macro info))


;;;; Menu

(defun org-e-texinfo-make-menu (info level)
  "Create the menu for inclusion in the texifo document.

INFO is the parsed buffer that contains the headlines.  LEVEL
determines whether to make the main menu, or the detailed menu.

This is only used for generating the primary menu.  In-Node menus
are generated directly."
  (let* ((parse (plist-get info :parse-tree))
	 ;; Top determines level to build menu from, it finds the
	 ;; level of the first headline in the export.
	 (top (org-element-map
	       parse 'headline
	       (lambda (headline)
		 (org-element-property :level headline)) info 't)))
    (cond
     ;; Generate the main menu
     ((eq level 'main)
      (org-e-texinfo--build-menu parse top info))
     ;; Generate the detailed (recursive) menu
     ((eq level 'detailed)
      ;; Requires recursion
      ;;(org-e-texinfo--build-detailed-menu parse top info)
      (or (org-e-texinfo--build-menu parse top info 'detailed)
	  "detailed"))
     ;; Otherwise do nothing
     (t))))


;;;; Paragraph

(defun org-e-texinfo-paragraph (paragraph contents info)
  "Transcode a PARAGRAPH element from Org to Texinfo.
CONTENTS is the contents of the paragraph, as a string.  INFO is
the plist used as a communication channel."
  contents)


;;;; Plain List

(defun org-e-texinfo-plain-list (plain-list contents info)
  "Transcode a PLAIN-LIST element from Org to Texinfo.
CONTENTS is the contents of the list.  INFO is a plist holding
contextual information."
  (let* ((attr (org-export-read-attribute :attr_texinfo plain-list))
	 (indic (or (plist-get attr :indic)
		    org-e-texinfo-def-table-markup))
	 (type (org-element-property :type plain-list))
	 (table-type (or (plist-get attr :table-type)
			 "table"))
	 ;; Ensure valid texinfo table type.
	 (table-type (if (memq table-type '("table" "ftable" "vtable"))
			 table-type
		       "table"))
	 (list-type (cond
		     ((eq type 'ordered) "enumerate")
		     ((eq type 'unordered) "itemize")
		     ((eq type 'descriptive) table-type))))
    (format "@%s%s\n@end %s"
	    (if (eq type 'descriptive)
		(concat list-type " " indic)
	     list-type)
	    contents
	    list-type)))


;;;; Plain Text

(defun org-e-texinfo-plain-text (text info)
  "Transcode a TEXT string from Org to Texinfo.
TEXT is the string to transcode.  INFO is a plist holding
contextual information."
  ;; Protect @ { and }.
  (while (string-match "\\([^\\]\\|^\\)\\([@{}]\\)" text)
    (setq text
	  (replace-match (format "\\%s" (match-string 2 text)) nil t text 2)))
  ;; LaTeX into @LaTeX{} and TeX into @TeX{}
  (let ((case-fold-search nil)
	(start 0))
    (while (string-match "\\(\\(?:La\\)?TeX\\)" text start)
      (setq text (replace-match
		  (format "@%s{}" (match-string 1 text)) nil t text)
	    start (match-end 0))))
  ;; Handle quotation marks
  (setq text (org-e-texinfo--quotation-marks text info))
  ;; Convert special strings.
  (when (plist-get info :with-special-strings)
    (while (string-match (regexp-quote "...") text)
      (setq text (replace-match "@dots{}" nil t text))))
  ;; Handle break preservation if required.
  (when (plist-get info :preserve-breaks)
    (setq text (replace-regexp-in-string "\\(\\\\\\\\\\)?[ \t]*\n" " @*\n"
					 text)))
  ;; Return value.
  text)


;;;; Planning

(defun org-e-texinfo-planning (planning contents info)
  "Transcode a PLANNING element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  (concat
   "@noindent"
   (mapconcat
    'identity
    (delq nil
	  (list
	   (let ((closed (org-element-property :closed planning)))
	     (when closed
	       (concat
		(format "@strong%s} " org-closed-string)
		(format org-e-texinfo-inactive-timestamp-format
			(org-translate-time closed)))))
	   (let ((deadline (org-element-property :deadline planning)))
	     (when deadline
	       (concat
		(format "@strong{%s} " org-deadline-string)
		(format org-e-texinfo-active-timestamp-format
			(org-translate-time deadline)))))
	   (let ((scheduled (org-element-property :scheduled planning)))
	     (when scheduled
	       (concat
		(format "@strong{%s} " org-scheduled-string)
		(format org-e-texinfo-active-timestamp-format
			(org-translate-time scheduled)))))))
    " ")
   "@*"))


;;;; Property Drawer

(defun org-e-texinfo-property-drawer (property-drawer contents info)
  "Transcode a PROPERTY-DRAWER element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  ;; The property drawer isn't exported but we want separating blank
  ;; lines nonetheless.
  "")


;;;; Quote Block

(defun org-e-texinfo-quote-block (quote-block contents info)
  "Transcode a QUOTE-BLOCK element from Org to Texinfo.
CONTENTS holds the contents of the block.  INFO is a plist
holding contextual information."
  
  (let* ((title (org-element-property :name quote-block))
	 (start-quote (concat "@quotation"

			      (if title
				 (format " %s" title)))))
    
    (format "%s\n%s@end quotation" start-quote contents)))


;;;; Quote Section

(defun org-e-texinfo-quote-section (quote-section contents info)
  "Transcode a QUOTE-SECTION element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (let ((value (org-remove-indentation
		(org-element-property :value quote-section))))
    (when value (format "@verbatim\n%s@end verbatim" value))))


;;;; Radio Target

(defun org-e-texinfo-radio-target (radio-target text info)
  "Transcode a RADIO-TARGET object from Org to Texinfo.
TEXT is the text of the target.  INFO is a plist holding
contextual information."
  (format "@anchor{%s}%s"
	  (org-export-solidify-link-text
	   (org-element-property :value radio-target))
	  text))


;;;; Section

(defun org-e-texinfo-section (section contents info)
  "Transcode a SECTION element from Org to Texinfo.
CONTENTS holds the contents of the section.  INFO is a plist
holding contextual information."
  contents)


;;;; Special Block
;;
;; Are ignored at the moment

;;;; Src Block

(defun org-e-texinfo-src-block (src-block contents info)
  "Transcode a SRC-BLOCK element from Org to Texinfo.
CONTENTS holds the contents of the item.  INFO is a plist holding
contextual information."
  (let* ((lang (org-element-property :language src-block))
	 (lisp-p (string-match-p "lisp" lang)))
    (cond
     ;; Case 1.  Lisp Block
     (lisp-p
      (format "@lisp\n%s\n@end lisp"
	      (org-export-format-code-default src-block info)))
     ;; Case 2.  Other blocks
     (t
      (format "@example\n%s\n@end example"
	      (org-export-format-code-default src-block info))))))


;;;; Statistics Cookie

(defun org-e-texinfo-statistics-cookie (statistics-cookie contents info)
  "Transcode a STATISTICS-COOKIE object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (org-element-property :value statistics-cookie))


;;;; Strike-Through
;;
;; Strikethrough is ignored


;;;; Subscript

(defun org-e-texinfo-subscript (subscript contents info)
  "Transcode a SUBSCRIPT object from Org to Texinfo.
CONTENTS is the contents of the object.  INFO is a plist holding
contextual information."
  (format "@math{_%s}" contents))


;;;; Superscript

(defun org-e-texinfo-superscript (superscript contents info)
  "Transcode a SUPERSCRIPT object from Org to Texinfo.
CONTENTS is the contents of the object.  INFO is a plist holding
contextual information."
  (format "@math{^%s}" contents))


;;;; Table
;;
;; `org-e-texinfo-table' is the entry point for table transcoding.  It
;; takes care of tables with a "verbatim" attribute.  Otherwise, it
;; delegates the job to either `org-e-texinfo-table--table.el-table' or
;; `org-e-texinfo-table--org-table' functions, depending of the type of
;; the table.
;;
;; `org-e-texinfo-table--align-string' is a subroutine used to build
;; alignment string for Org tables.

(defun org-e-texinfo-table (table contents info)
  "Transcode a TABLE element from Org to Texinfo.
CONTENTS is the contents of the table.  INFO is a plist holding
contextual information."
  (cond
   ;; Case 1: verbatim table.
   ((or org-e-texinfo-tables-verbatim
	(let ((attr (mapconcat 'identity
			       (org-element-property :attr_latex table)
			       " ")))
	  (and attr (string-match "\\<verbatim\\>" attr))))
    (format "@verbatim \n%s\n@end verbatim"
	    ;; Re-create table, without affiliated keywords.
	    (org-trim
	     (org-element-interpret-data
	      `(table nil ,@(org-element-contents table))))))
   ;; Case 2: table.el table.  Convert it using appropriate tools.
   ((eq (org-element-property :type table) 'table.el)
    (org-e-texinfo-table--table.el-table table contents info))
   ;; Case 3: Standard table.
   (t (org-e-texinfo-table--org-table table contents info))))

(defun org-e-texinfo-table-column-widths (table info)
  "Determine the largest table cell in each column to process alignment.

TABLE is the table element to transcode.  INFO is a plist used as
a communication channel."
  (let* ((rows (org-element-map table 'table-row 'identity info))
	 (collected (loop for row in rows collect
			  (org-element-map
			   row 'table-cell 'identity info)))
	 (number-cells (length (car collected)))
	 cells counts)
    (loop for row in collected do
	  (push (mapcar (lambda (ref)
		     (let* ((start (org-element-property :contents-begin ref))
			    (end (org-element-property :contents-end ref))
			    (length (- end start)))
		       length)) row) cells))
    (setq cells (remove-if #'null cells))
    (push (loop for count from 0 to (- number-cells 1) collect
		   (loop for item in cells collect
			 (nth count item))) counts)
    (mapconcat '(lambda (size)
		  (make-string size ?a)) (mapcar (lambda (ref)
				   (apply 'max `,@ref)) (car counts))
	       "} {")
  ))

(defun org-e-texinfo-table--org-table (table contents info)
  "Return appropriate Texinfo code for an Org table.

TABLE is the table type element to transcode.  CONTENTS is its
contents, as a string.  INFO is a plist used as a communication
channel.

This function assumes TABLE has `org' as its `:type' attribute."
  (let* ((attr (org-export-read-attribute :attr_texinfo table))
	 (col-width (plist-get attr :columns))
	 (columns (if col-width
		      (format "@columnfractions %s"
			      col-width)
		    (format "{%s}"
			    (org-e-texinfo-table-column-widths
			     table info)))))
    ;; Prepare the final format string for the table.
    (cond
     ;; Longtable.
     ;; Others.
     (t (concat
	 (format "@multitable %s\n%s@end multitable"
		 columns
		 contents))))))

(defun org-e-texinfo-table--table.el-table (table contents info)
  "Returns nothing.

Rather than return an invalid table, nothing is returned."
  'nil)


;;;; Table Cell

(defun org-e-texinfo-table-cell (table-cell contents info)
  "Transcode a TABLE-CELL element from Org to Texinfo.
CONTENTS is the cell contents.  INFO is a plist used as
a communication channel."
  (concat (if (and contents
		   org-e-texinfo-table-scientific-notation
		   (string-match orgtbl-exp-regexp contents))
	      ;; Use appropriate format string for scientific
	      ;; notation.
	      (format org-e-texinfo-table-scientific-notation
		      (match-string 1 contents)
		      (match-string 2 contents))
	    contents)
	  (when (org-export-get-next-element table-cell info) "\n@tab ")))


;;;; Table Row

(defun org-e-texinfo-table-row (table-row contents info)
  "Transcode a TABLE-ROW element from Org to Texinfo.
CONTENTS is the contents of the row.  INFO is a plist used as
a communication channel."
  ;; Rules are ignored since table separators are deduced from
  ;; borders of the current row.
  (when (eq (org-element-property :type table-row) 'standard) 
    (concat "@item " contents "\n")))


;;;; Target

(defun org-e-texinfo-target (target contents info)
  "Transcode a TARGET object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  (format "@anchor{%s}"
	  (org-export-solidify-link-text (org-element-property :value target))))


;;;; Timestamp

(defun org-e-texinfo-timestamp (timestamp contents info)
  "Transcode a TIMESTAMP object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  (let ((value (org-translate-time (org-element-property :value timestamp)))
	(type (org-element-property :type timestamp)))
    (cond ((memq type '(active active-range))
	   (format org-e-texinfo-active-timestamp-format value))
	  ((memq type '(inactive inactive-range))
	   (format org-e-texinfo-inactive-timestamp-format value))
	  (t (format org-e-texinfo-diary-timestamp-format value)))))


;;;; Underline
;;
;; Underline is ignored


;;;; Verbatim

(defun org-e-texinfo-verbatim (verbatim contents info)
  "Transcode a VERBATIM object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist used as a communication
channel."
  (org-e-texinfo--text-markup (org-element-property :value verbatim) 'verbatim))


;;;; Verse Block

(defun org-e-texinfo-verse-block (verse-block contents info)
  "Transcode a VERSE-BLOCK element from Org to Texinfo.
CONTENTS is verse block contents. INFO is a plist holding
contextual information."
  ;; In a verse environment, add a line break to each newline
  ;; character and change each white space at beginning of a line
  ;; into a space of 1 em.  Also change each blank line with
  ;; a vertical space of 1 em.
  (progn
    (setq contents (replace-regexp-in-string
		    "^ *\\\\\\\\$" "\\\\vspace*{1em}"
		    (replace-regexp-in-string
		     "\\(\\\\\\\\\\)?[ \t]*\n" " \\\\\\\\\n" contents)))
    (while (string-match "^[ \t]+" contents)
      (let ((new-str (format "\\hspace*{%dem}"
			     (length (match-string 0 contents)))))
	(setq contents (replace-match new-str nil t contents))))
    (format "\\begin{verse}\n%s\\end{verse}" contents)))


\f
;;; Interactive functions

(defun org-e-texinfo-export-to-texinfo
  (&optional subtreep visible-only body-only ext-plist pub-dir)
  "Export current buffer to a Texinfo file.

If narrowing is active in the current buffer, only export its
narrowed part.

If a region is active, export that region.

When optional argument SUBTREEP is non-nil, export the sub-tree
at point, extracting information from the headline properties
first.

When optional argument VISIBLE-ONLY is non-nil, don't export
contents of hidden elements.

When optional argument BODY-ONLY is non-nil, only write code
between \"\\begin{document}\" and \"\\end{document}\".

EXT-PLIST, when provided, is a property list with external
parameters overriding Org default settings, but still inferior to
file-local settings.

When optional argument PUB-DIR is set, use it as the publishing
directory.

Return output file's name."
  (interactive)
  (let ((outfile (org-export-output-file-name ".texi" subtreep pub-dir)))
    (org-export-to-file
     'e-texinfo outfile subtreep visible-only body-only ext-plist)))

(defun org-e-texinfo-export-to-info
  (&optional subtreep visible-only body-only ext-plist pub-dir)
  "Export current buffer to Texinfo then process through to INFO.

If narrowing is active in the current buffer, only export its
narrowed part.

If a region is active, export that region.

When optional argument SUBTREEP is non-nil, export the sub-tree
at point, extracting information from the headline properties
first.

When optional argument VISIBLE-ONLY is non-nil, don't export
contents of hidden elements.

When optional argument BODY-ONLY is non-nil, only write code
between \"\\begin{document}\" and \"\\end{document}\".

EXT-PLIST, when provided, is a property list with external
parameters overriding Org default settings, but still inferior to
file-local settings.

When optional argument PUB-DIR is set, use it as the publishing
directory.

Return INFO file's name."
  (interactive)
  (org-e-texinfo-compile
   (org-e-texinfo-export-to-texinfo
    subtreep visible-only body-only ext-plist pub-dir)))

(defun org-e-texinfo-compile (texifile)
  "Compile a texinfo file.

TEXIFILE is the name of the file being compiled.  Processing is
done through the command specified in `org-e-texinfo-info-process'.

Return INFO file name or an error if it couldn't be produced."
  (let* ((wconfig (current-window-configuration))
	 (texifile (file-truename texifile))
	 (base (file-name-sans-extension texifile))
	 errors)
    (message (format "Processing Texinfo file %s ..." texifile))
    (unwind-protect
	(progn
	  (cond
	   ;; A function is provided: Apply it.
	   ((functionp org-e-texinfo-info-process)
	    (funcall org-e-texinfo-info-process (shell-quote-argument texifile)))
	   ;; A list is provided: Replace %b, %f and %o with appropriate
	   ;; values in each command before applying it.  Output is
	   ;; redirected to "*Org INFO Texinfo Output*" buffer.
	   ((consp org-e-texinfo-info-process)
	    (let* ((out-dir (or (file-name-directory texifile) "./"))
		   (outbuf (get-buffer-create "*Org Info Texinfo Output*")))
	      (mapc
	       (lambda (command)
		 (shell-command
		  (replace-regexp-in-string
		   "%b" (shell-quote-argument base)
		   (replace-regexp-in-string
		    "%f" (shell-quote-argument texifile)
		    (replace-regexp-in-string
		     "%o" (shell-quote-argument out-dir) command t t) t t) t t)
		  outbuf))
	       org-e-texinfo-info-process)
	      ;; Collect standard errors from output buffer.
	      (setq errors (org-e-texinfo-collect-errors outbuf))))
	   (t (error "No valid command to process to Info")))
	  (let ((infofile (concat base ".info")))
	    ;; Check for process failure.  Provide collected errors if
	    ;; possible.
	    (if (not (file-exists-p infofile))
		(error (concat (format "INFO file %s wasn't produced" infofile)
			       (when errors (concat ": " errors))))
	      ;; Else remove log files, when specified, and signal end of
	      ;; process to user, along with any error encountered.
	      (message (concat "Process completed"
			       (if (not errors) "."
				 (concat " with errors: " errors)))))
	    ;; Return output file name.
	    infofile))
      (set-window-configuration wconfig))))

(defun org-e-texinfo-collect-errors (buffer)
  "Collect some kind of errors from \"pdflatex\" command output.

BUFFER is the buffer containing output.

Return collected error types as a string, or nil if there was
none."
  (with-current-buffer buffer
    (save-excursion
      (goto-char (point-max))
      ;; Find final "makeinfo" run.
      (when (re-search-backward "^makeinfo (GNU texinfo)" nil t)
	(let ((case-fold-search t)
	      (errors ""))
	  (when (save-excursion
		  (re-search-forward "perhaps incorrect sectioning?" nil t))
	    (setq errors (concat errors " [incorrect sectionnng]")))
	  (when (save-excursion
		  (re-search-forward "missing close brace" nil t))
	    (setq errors (concat errors " [syntax error]")))
	  (when (save-excursion
		  (re-search-forward "Unknown command" nil t))
	    (setq errors (concat errors " [undefined @command]")))
	  (when (save-excursion
		  (re-search-forward "No matching @end" nil t))
	    (setq errors (concat errors " [block incomplete]")))
	  (when (save-excursion
		  (re-search-forward "requires a sectioning" nil t))
	    (setq errors (concat errors " [invalid section command]")))
	  (when (save-excursion
		  (re-search-forward "[unexpected]" nil t))
	    (setq errors (concat errors " [unexpected error]")))
	  (and (org-string-nw-p errors) (org-trim errors)))))))


(provide 'org-e-texinfo)
;;; org-e-texinfo.el ends here

^ permalink raw reply	[relevance 1%]

* Re: Export to Texinfo
  @ 2012-07-31 21:03  1%       ` Jonathan Leech-Pepin
    0 siblings, 1 reply; 59+ results
From: Jonathan Leech-Pepin @ 2012-07-31 21:03 UTC (permalink / raw)
  To: Org Mode Mailing List; +Cc: François Pinard, Nicolas Goaziou

[-- Attachment #1: Type: text/plain, Size: 4088 bytes --]

Hello,

I've done some further work on the org-e-texinfo exporter and have
gotten it to a point where it should be usable with only a few
shortcomings.

Features:
- The copying section is created from the first headline containing
  the property :copying:.  Headlines with this property will not be
  exported except in the @copying block.
- Indexes will be created using unnumbered headings from headlines
  containing an :index: property.  If the property has a value
  corresponding to a texinfo index ("cp" "fn" "ky" "pg" "tp" "vr") it
  will be generated using @printindex.  Otherwise only the text will
  be exported and index printing will only be done if explicitly
  indicated.
- The following export-snippets are recognized by the exporter:
  info, e-info and e-texinfo.
- Header arguments can be added using ~#+TEXINFO_HEADER~
- Info directory information is provided by:
  #+TEXINFO_DIR_CATEGORY (e.g: "Emacs")
  #+TEXINFO_DIR_TITLE (e.g: "Org Mode Guide: (orgguide)")
  #+TEXINFO_DIR_DESC (e.g: "Abbreviated Org-mode Manual")
- The info filename is determined by ~#+TEXINFO_FILENAME~, or by
  appending .info to the .org filename.
- Additional title and author information (beyond a single line) can
  be included using #+SUBTITLE and #+SUBAUTHOR respectively.
- The menu and detailed menu in the TOP node, as well as the in-node
  menus of child nodes are generated on export.  Descriptions of the
  nodes are defined in the :DESCRIPTION: property of the headlines.
- Tables are exported to @multitable.  Column widths are either
  defined by the widest cell in each column (a string of ~a~ is
  generated equal to that length), or by a string of fractions in
  #+attr_texinfo (e.g: ~#+attr_texinfo :columns "0.33 0.33 0.33"~)


I have left in an option for #+TEXINFO_CLASS even though only a single
one is defined by default.  Removing it would require reworking
certain portions of the code at the moment, leaving it in allows for
changes if an alternate structure is desired.

It still has issues with the following:
- Table.el tables will not be exported.
- Only a single type of two-column table can currently be created, ~@table~.
- Two-column tables are restricted to a single "indicating" command,
  defined by ~org-e-texinfo-def-table-markup~.  I'm not sure how to
  get around these limitations since they are created from description
  lists (which do not recognize #+attr lines).
- Links will export either as @ref{} or @uref{}.  Manually creating
  @pxref{} and @xref{} links is possible within export snippets.  I'm
  not certain where I would need to check to determine the context to
  select between the three choices.  @xref and @pxref are preferred in
  some cases, however @ref does provide the necessary features in Info
  output.


Also attached is a transcription of orgguide.texi to orgguide.org for
use with the e-texinfo exporter.  It is not exactly identical and
likely has a few places that could be better transcribed into org from
.texi, however it does demonstrate the resultant output when
exporting.

Prior to exporting the following must be evaluated:

  (add-to-list 'org-export-snippet-translation-alist
               '("info" . "e-texinfo"))
  (setq org-e-texinfo-def-table-markup "@kbd")

Regards,

Jon

On 20 July 2012 09:42, Nicolas Goaziou <n.goaziou@gmail.com> wrote:
> Jonathan Leech-Pepin <jonathan.leechpepin@gmail.com> writes:
>
>> Can I define the export-snippet using:
>>
>>     (add-to-list 'org-export-snippet-translation-alist
>>                  '("e-info" . "e-texinfo"))
>>
>> Or should that be left up to the discretion of the user?
>
> This is an user-oriented variable (customizable).
>
> Though, you have full control over which export snippets you accept. In
> the following example, you accept both @@info:...@@ and @@texinfo:...@@
> snippets:
>
>   (defun org-e-latex-export-snippet (export-snippet contents info)
>     "Blah..."
>     (when (memq (org-export-snippet-backend export-snippet) '(info texinfo))
>       (org-element-property :value export-snippet)))
>
> Just specify it in package's documentation.

[-- Attachment #2: org-e-texinfo.el --]
[-- Type: application/octet-stream, Size: 62533 bytes --]

;;; org-e-texinfo.el --- Texinfo Back-End For Org Export Engine

;; Author: Jonathan Leech-Pepin <jonathan.leechpepin at gmail dot com>
;; Keywords: outlines, hypermedia, calendar, wp

;; This program is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.

;; This program is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;; GNU General Public License for more details.

;; You should have received a copy of the GNU General Public License
;; along with this program.  If not, see <http://www.gnu.org/licenses/>.

;;; Commentary:
;;
;; This library implements a Texinfo back-end for Org generic
;; exporter.
;;
;; To test it, run
;;
;;   M-: (org-export-to-buffer 'e-texinfo "*Test e-texinfo*") RET
;;
;; in an org-mode buffer then switch to the buffer to see the Texinfo
;; export.  See contrib/lisp/org-export.el for more details on how
;; this exporter works.
;;
;; It introduces eight new buffer keywords: "TEXINFO_CLASS",
;; "TEXINFO_FILENAME", "TEXINFO_HEADER", "TEXINFO_DIR_CATEGORY",
;; "TEXINFO_DIR_TITLE", "TEXINFO_DIR_DESC" "SUBTITLE" and "SUBAUTHOR".
;;
;; To include inline code snippets (for example for generating @kbd{}
;; and @key{} commands), the following export-snippet keys are
;; accepted:
;; 
;;     info
;;     e-info
;;     e-texinfo
;;
;; You can add them for export snippets via any of the below:
;;
;;    (add-to-list 'org-export-snippet-translation-alist
;;                 '("e-info" . "e-texinfo"))
;;    (add-to-list 'org-export-snippet-translation-alist
;;                 '("e-texinfo" . "e-texinfo"))
;;    (add-to-list 'org-export-snippet-translation-alist
;;                 '("info" . "e-texinfo"))
;; 


;;; Code:

(eval-when-compile (require 'cl))
(require 'org-export)

(defvar orgtbl-exp-regexp)

\f
;;; Define Back-End

(defvar org-e-texinfo-translate-alist
  '((babel-call . org-e-texinfo-babel-call)
    (bold . org-e-texinfo-bold)
    (center-block . org-e-texinfo-center-block)
    (clock . org-e-texinfo-clock)
    (code . org-e-texinfo-code)
    (comment . org-e-texinfo-comment)
    (comment-block . org-e-texinfo-comment-block)
    (drawer . org-e-texinfo-drawer)
    (dynamic-block . org-e-texinfo-dynamic-block)
    (entity . org-e-texinfo-entity)
    (example-block . org-e-texinfo-example-block)
    (export-block . org-e-texinfo-export-block)
    (export-snippet . org-e-texinfo-export-snippet)
    (fixed-width . org-e-texinfo-fixed-width)
    (footnote-definition . org-e-texinfo-footnote-definition)
    (footnote-reference . org-e-texinfo-footnote-reference)
    (headline . org-e-texinfo-headline)
    (horizontal-rule . org-e-texinfo-horizontal-rule)
    (inline-babel-call . org-e-texinfo-inline-babel-call)
    (inline-src-block . org-e-texinfo-inline-src-block)
    (inlinetask . org-e-texinfo-inlinetask)
    (italic . org-e-texinfo-italic)
    (item . org-e-texinfo-item)
    (keyword . org-e-texinfo-keyword)
    (latex-environment . org-e-texinfo-latex-environment)
    (latex-fragment . org-e-texinfo-latex-fragment)
    (line-break . org-e-texinfo-line-break)
    (link . org-e-texinfo-link)
    (macro . org-e-texinfo-macro)
    (paragraph . org-e-texinfo-paragraph)
    (plain-list . org-e-texinfo-plain-list)
    (plain-text . org-e-texinfo-plain-text)
    (planning . org-e-texinfo-planning)
    (property-drawer . org-e-texinfo-property-drawer)
    (quote-block . org-e-texinfo-quote-block)
    (quote-section . org-e-texinfo-quote-section)
    (radio-target . org-e-texinfo-radio-target)
    (section . org-e-texinfo-section)
    (special-block . org-e-texinfo-special-block)
    (src-block . org-e-texinfo-src-block)
    (statistics-cookie . org-e-texinfo-statistics-cookie)
    (strike-through . org-e-texinfo-strike-through)
    (subscript . org-e-texinfo-subscript)
    (superscript . org-e-texinfo-superscript)
    (table . org-e-texinfo-table)
    (table-cell . org-e-texinfo-table-cell)
    (table-row . org-e-texinfo-table-row)
    (target . org-e-texinfo-target)
    (template . org-e-texinfo-template)
    (timestamp . org-e-texinfo-timestamp)
    (underline . org-e-texinfo-underline)
    (verbatim . org-e-texinfo-verbatim)
    (verse-block . org-e-texinfo-verse-block))
  "Alist between element or object types and translators.")

(defconst org-e-texinfo-options-alist
  '((:texinfo-filename "TEXINFO_FILENAME" nil org-e-texinfo-filename t)
    (:texinfo-class "TEXINFO_CLASS" nil org-e-texinfo-default-class t)
    (:texinfo-header "TEXINFO_HEADER" nil nil newline)
    (:subtitle "SUBTITLE" nil nil newline)
    (:subauthor "SUBAUTHOR" nil nil newline)
    (:texinfo-dircat "TEXINFO_DIR_CATEGORY" nil nil t)
    (:texinfo-dirtitle "TEXINFO_DIR_TITLE" nil nil t)
    (:texinfo-dirdesc "TEXINFO_DIR_DESC" nil nil t))
  "Alist between Texinfo export properties and ways to set them.
See `org-export-options-alist' for more information on the
structure of the values.

SUBAUTHOR and SUBTITLE are for the inclusion of additional author
and title information beyond the initial variable.")

(defconst org-e-texinfo-filters-alist
  '((:filter-headline . org-e-texinfo-filter-section-blank-lines)
    (:filter-section . org-e-texinfo-filter-section-blank-lines))
  "Alist between filters keywords and back-end specific filters.
  See `org-export-filters-alist' for more information")


\f
;;; Internal Variables

;; Add TEXINFO to the list of available of available export blocks.
(add-to-list 'org-element-block-name-alist
	     '("TEXINFO" . org-element-export-block-parser))
\f
;;; User Configurable Variables

(defgroup org-export-e-texinfo nil
  "Options for exporting Org mode files to Texinfo."
  :tag "Org Export Texinfo"
  :group 'org-export)


;;;; Preamble

(defcustom org-e-texinfo-filename nil
  "Default filename for texinfo output."
  :group 'org-export-e-texinfo
  :type '(string :tag "Export Filename"))

(defcustom org-e-texinfo-default-class "info"
  "The default Texinfo class."
  :group 'org-export-e-texinfo
  :type '(string :tag "Texinfo class"))

(defcustom org-e-texinfo-classes
  '(("info"
     "\\input texinfo    @c -*- texinfo -*-"
     ("@chapter %s" . "@unnumbered %s")
     ("@section %s" . "@unnumberedsec %s")
     ("@subsection %s" . "@unnumberedsubsec %s")
     ("@subsubsection %s" . "@unnumberedsubsubsec %s")))
  "Alist of Texinfo classes and associated header and structure.
If #+Texinfo_CLASS is set in the buffer, use its value and the
associated information.  Here is the structure of each cell:

  \(class-name
    header-string
    \(numbered-section . unnumbered-section\)
    ...\)

The sectioning structure
------------------------

The sectioning structure of the class is given by the elements
following the header string.  For each sectioning level, a number
of strings is specified.  A %s formatter is mandatory in each
section string and will be replaced by the title of the section.

Instead of a list of sectioning commands, you can also specify
a function name.  That function will be called with two
parameters, the \(reduced) level of the headline, and a predicate
non-nil when the headline should be numbered.  It must return
a format string in which the section title will be added."
  :group 'org-export-e-texinfo
  :type '(repeat
	  (list (string :tag "Texinfo class")
		(string :tag "Texinfo header")
		(repeat :tag "Levels" :inline t
			(choice
			 (cons :tag "Heading"
			       (string :tag "  numbered")
			       (string :tag "unnumbered"))
			 (function :tag "Hook computing sectioning"))))))


;;;; Headline

(defcustom org-e-texinfo-format-headline-function nil
  "Function to format headline text.

This function will be called with 5 arguments:
TODO      the todo keyword (string or nil).
TODO-TYPE the type of todo (symbol: `todo', `done', nil)
PRIORITY  the priority of the headline (integer or nil)
TEXT      the main headline text (string).
TAGS      the tags as a list of strings (list of strings or nil).

The function result will be used in the section format string.

As an example, one could set the variable to the following, in
order to reproduce the default set-up:

\(defun org-e-texinfo-format-headline (todo todo-type priority text tags)
  \"Default format function for an headline.\"
  \(concat (when todo
            \(format \"\\\\textbf{\\\\textsc{\\\\textsf{%s}}} \" todo))
	  \(when priority
            \(format \"\\\\framebox{\\\\#%c} \" priority))
	  text
	  \(when tags
            \(format \"\\\\hfill{}\\\\textsc{%s}\"
              \(mapconcat 'identity tags \":\"))))"
  :group 'org-export-e-texinfo
  :type 'function)


;;;; Footnotes
;;
;; Footnotes are inserted directly

;;;; Timestamps

(defcustom org-e-texinfo-active-timestamp-format "@emph{%s}"
  "A printf format string to be applied to active timestamps."
  :group 'org-export-e-texinfo
  :type 'string)

(defcustom org-e-texinfo-inactive-timestamp-format "@emph{%s}"
  "A printf format string to be applied to inactive timestamps."
  :group 'org-export-e-texinfo
  :type 'string)

(defcustom org-e-texinfo-diary-timestamp-format "@emph{%s}"
  "A printf format string to be applied to diary timestamps."
  :group 'org-export-e-texinfo
  :type 'string)

;;;; Links

(defcustom org-e-texinfo-link-with-unknown-path-format "@indicateurl{%s}"
  "Format string for links with unknown path type."
  :group 'org-export-e-texinfo
  :type 'string)


;;;; Tables

(defcustom org-e-texinfo-tables-verbatim nil
  "When non-nil, tables are exported verbatim."
  :group 'org-export-e-texinfo
  :type 'boolean)

(defcustom org-e-texinfo-table-scientific-notation "%s\\,(%s)"
  "Format string to display numbers in scientific notation.
The format should have \"%s\" twice, for mantissa and exponent
\(i.e. \"%s\\\\times10^{%s}\").

When nil, no transformation is made."
  :group 'org-export-e-texinfo
  :type '(choice
	  (string :tag "Format string")
	  (const :tag "No formatting")))

(defcustom org-e-texinfo-def-table-markup "@samp"
  "Default setting for @table environments.")

;;;; Text markup

(defcustom org-e-texinfo-text-markup-alist '((bold . "@strong{%s}")
					   (code . code)
					   (italic . "@emph{%s}")
					   (verbatim . verb)
					   (comment . "@c %s"))
  "Alist of Texinfo expressions to convert text markup.

The key must be a symbol among `bold', `italic' and `comment'.
The value is a formatting string to wrap fontified text with.

Value can also be set to the following symbols: `verb' and
`code'.  For the former, Org will use \"@verb\" to
create a format string and select a delimiter character that
isn't in the string.  For the latter, Org will use \"@code\"
to typeset and try to protect special characters.

If no association can be found for a given markup, text will be
returned as-is."
  :group 'org-export-e-texinfo
  :type 'alist
  :options '(bold code italic verbatim comment))


;;;; Drawers

(defcustom org-e-texinfo-format-drawer-function nil
  "Function called to format a drawer in Texinfo code.

The function must accept two parameters:
  NAME      the drawer name, like \"LOGBOOK\"
  CONTENTS  the contents of the drawer.

The function should return the string to be exported.

For example, the variable could be set to the following function
in order to mimic default behaviour:

\(defun org-e-texinfo-format-drawer-default \(name contents\)
  \"Format a drawer element for Texinfo export.\"
  contents\)"
  :group 'org-export-e-texinfo
  :type 'function)


;;;; Inlinetasks

(defcustom org-e-texinfo-format-inlinetask-function nil
  "Function called to format an inlinetask in Texinfo code.

The function must accept six parameters:
  TODO      the todo keyword, as a string
  TODO-TYPE the todo type, a symbol among `todo', `done' and nil.
  PRIORITY  the inlinetask priority, as a string
  NAME      the inlinetask name, as a string.
  TAGS      the inlinetask tags, as a list of strings.
  CONTENTS  the contents of the inlinetask, as a string.

The function should return the string to be exported.

For example, the variable could be set to the following function
in order to mimic default behaviour:

\(defun org-e-texinfo-format-inlinetask \(todo type priority name tags contents\)
\"Format an inline task element for Texinfo export.\"
  \(let ((full-title
	 \(concat
	  \(when todo
            \(format \"@strong{%s} \" todo))
	  \(when priority (format \"#%c \" priority))
	  title
	  \(when tags
            \(format \":%s:\"
                    \(mapconcat 'identity tags \":\")))))
    \(format (concat \"@center %s\n\n\"
		    \"%s\"
                    \"\n\"))
	    full-title contents))"
  :group 'org-export-e-texinfo
  :type 'function)


;;;; Src blocks
;;
;; Src Blocks are example blocks, except for LISP

;;;; Plain text

(defcustom org-e-texinfo-quotes
  '(("quotes"
     ("\\(\\s-\\|[[(]\\|^\\)\"" . "``")
     ("\\(\\S-\\)\"" . "''")
     ("\\(\\s-\\|(\\|^\\)'" . "`")))
  "Alist for quotes to use when converting english double-quotes.

The CAR of each item in this alist is the language code.
The CDR of each item in this alist is a list of three CONS:
- the first CONS defines the opening quote;
- the second CONS defines the closing quote;
- the last CONS defines single quotes.

For each item in a CONS, the first string is a regexp
for allowed characters before/after the quote, the second
string defines the replacement string for this quote."
  :group 'org-export-e-texinfo
  :type '(list
	  (cons :tag "Opening quote"
		(string :tag "Regexp for char before")
		(string :tag "Replacement quote     "))
	  (cons :tag "Closing quote"
		(string :tag "Regexp for char after ")
		(string :tag "Replacement quote     "))
	  (cons :tag "Single quote"
		(string :tag "Regexp for char before")
		(string :tag "Replacement quote     "))))


;;;; Compilation

(defcustom org-e-texinfo-info-process
  '("makeinfo %f")
  "Commands to process a texinfo file to an INFO file.
This is list of strings, each of them will be given to the shell
as a command.  %f in the command will be replaced by the full
file name, %b by the file base name \(i.e without extension) and
%o by the base directory of the file."
  :group 'org-export-texinfo
  :type '(repeat :tag "Shell command sequence"
		 (string :tag "Shell command")))

\f
;;; Internal Functions

(defun org-e-texinfo-filter-section-blank-lines (headline back-end info)
  "Filter controlling number of blank lines after a section."
  (if (not (eq back-end 'e-texinfo)) headline
    (let ((blanks (make-string 2 ?\n)))
      (replace-regexp-in-string "\n\\(?:\n[ \t]*\\)*\\'" blanks headline))))

(defun org-e-texinfo--find-copying (info)
  "Retrieve the headline identified by the property :copying:.

INFO is the plist containing the export options and tree.  It is
used to find and extract the single desired headline.  This
cannot be treated as a standard headline since it must be
inserted in a specific location."
  (let (copying)
    (org-element-map (plist-get info :parse-tree) 'headline
		     (lambda (copy)
		       (when (org-element-property :copying copy)
			 (push copy copying))) info 't)
    ;; Retrieve the single entry
    (car copying)))

(defun org-e-texinfo--find-verb-separator (s)
  "Return a character not used in string S.
This is used to choose a separator for constructs like \\verb."
  (let ((ll "~,./?;':\"|!@#%^&-_=+abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ<>()[]{}"))
    (loop for c across ll
	  when (not (string-match (regexp-quote (char-to-string c)) s))
	  return (char-to-string c))))

(defun org-e-texinfo--make-option-string (options)
  "Return a comma separated string of keywords and values.
OPTIONS is an alist where the key is the options keyword as
a string, and the value a list containing the keyword value, or
nil."
  (mapconcat (lambda (pair)
	       (concat (first pair)
		       (when (> (length (second pair)) 0)
			 (concat "=" (second pair)))))
	     options
	     ","))

(defun org-e-texinfo--quotation-marks (text info)
  "Export quotation marks using ` and ' as the markers.
TEXT is a string containing quotation marks to be replaced.  INFO
is a plist used as a communication channel."
  (mapc (lambda(l)
	  (let ((start 0))
	    (while (setq start (string-match (car l) text start))
	      (let ((new-quote (concat (match-string 1 text) (cdr l))))
		(setq text (replace-match new-quote  t t text))))))
	(cdr org-e-texinfo-quotes))
  text)

(defun org-e-texinfo--text-markup (text markup)
  "Format TEXT depending on MARKUP text markup.
See `org-e-texinfo-text-markup-alist' for details."
  (let ((fmt (cdr (assq markup org-e-texinfo-text-markup-alist))))
    (cond
     ;; No format string: Return raw text.
     ((not fmt) text)
     ((eq 'verb fmt)
      (let ((separator (org-e-texinfo--find-verb-separator text)))
	(concat "@verb{" separator text separator "}")))
     ((eq 'code fmt)
      (let ((start 0)
	    (rtn "")
	    char)
	(while (string-match "[@{}]" text)
	  (setq char (match-string 0 text))
	  (if (> (match-beginning 0) 0)
	      (setq rtn (concat rtn (substring text 0 (match-beginning 0)))))
	  (setq text (substring text (1+ (match-beginning 0))))
	  (setq char (concat "@" char)
		rtn (concat rtn char)))
	(setq text (concat rtn text)
	      fmt "@code{%s}")
	(format fmt text)))
     ;; Else use format string.
     (t (format fmt text)))))

;;;; Menu creation

(defun org-e-texinfo--build-menu (tree level info &optional detailed)
  "Create the @menu/@end menu information from TREE at headline
level LEVEL.

TREE contains the parse-tree to work with, either of the entire
document or of a specific parent headline.  LEVEL indicates what
level of headlines to look at when generating the menu.  INFO is
a plist containing contextual information.

Detailed determines whether to build a single level of menu, or
recurse into all children as well."
  (let ((menu (org-e-texinfo--generate-menu-list tree level info))
	output text-menu)
    (cond
     (detailed
      ;; Looping is done within the menu generation.
      (setq text-menu (org-e-texinfo--generate-detailed menu level info)))
     (t
      (setq text-menu (org-e-texinfo--generate-menu-items menu info))))
    (when text-menu
      (setq output (org-e-texinfo--format-menu text-menu))
      (mapconcat 'identity output "\n"))))

(defun org-e-texinfo--generate-detailed (menu level info)
  "Generate a detailed listing of all subheadings within MENU starting at LEVEL.

MENU is the parse-tree to work with.  LEVEL is the starting level
for the menu headlines and from which recursion occurs.  INFO is
a plist containing contextual information."
  (let ((max-depth (plist-get info :headline-levels)))
    (when (> max-depth level)
      (loop for headline in menu append
	    (let* ((title (org-e-texinfo--menu-headlines headline info))
		   ;; Create list of menu entries for the next level
		   (sublist (org-e-texinfo--generate-menu-list
			     headline (1+ level) info))
		   ;; Generate the menu items for that level.  If
		   ;; there are none omit that heading completely,
		   ;; otherwise join the title to it's related entries.
		   (submenu (if (org-e-texinfo--generate-menu-items sublist info)
				(append (list title)
					(org-e-texinfo--generate-menu-items sublist info))
			      'nil))
		   ;; Start the process over the next level down.
		   (recursion (org-e-texinfo--generate-detailed sublist (1+ level) info)))
	      (setq recursion (append submenu recursion))
	      recursion)))))

(defun org-e-texinfo--generate-menu-list (tree level info)
  "Generate the list of headlines that are within a given level
of the tree for further formatting.

TREE is the parse-tree containing the headlines.  LEVEL is the
headline level to generate a list of.  INFO is a plist holding
contextual information."
  (let (seq)
    (org-element-map
     tree 'headline
     (lambda (head)
       (when (org-element-property :level head)
	 (if (and (eq level (org-element-property :level head))
		  ;; Do not take note of footnotes or copying headlines
		  (not (org-element-property :copying head))
		  (not (org-element-property :footnote-section-p head)))
	     (push head seq)))))
    ;; Return the list of headlines (reverse to have in actual order)
    (reverse seq)))

(defun org-e-texinfo--generate-menu-items (items info)
  "Generate a list of headline information from the listing ITEMS.

ITEMS is a list of the headlines to be converted into entries.
INFO is a plist containing contextual information.

Returns a list containing the following information from each
headline: length, title, description.  This is used to format the
menu using `org-e-texinfo--format-menu'."
  (loop for headline in items collect
	(let* ((title (org-export-data
		       (org-element-property :title headline) info))
	       (descr (org-export-data
		       (org-element-property :description headline) info))
	       (len (length title))
	       (output (list len title descr)))
	  output)))

(defun org-e-texinfo--menu-headlines (headline info)
  "Retrieve the title from HEADLINE.

INFO is a plist holding contextual information.

Return the headline as a list of (length title description) with
length of -1 and nil description.  This is used in
`org-e-texinfo--format-menu' to identify headlines as opposed to
entries."
  (let ((title (org-export-data
		(org-element-property :title headline) info)))
    (list -1 title 'nil)))

(defun org-e-texinfo--format-menu (text-menu)
  "Format the TEXT-MENU items to be properly printed in the menu.

Each entry in the menu should be provided as (length title
description).

Headlines in the detailed menu are given length -1 to ensure they
are never confused with other entries.  They also have no
description.

Other menu items are output as:
    Title::     description

With the spacing between :: and description based on the length
of the longest menu entry."

  (let* ((lengths (mapcar 'car text-menu))
         (max-length (apply 'max lengths))
	 output)
    (setq output
          (mapcar (lambda (name)
                    (let* ((title (nth 1 name))
                           (desc (nth 2 name))
                           (length (nth 0 name)))
                      (if (> length -1)
                          (concat "* " title ":: "
                                  (make-string
				   (- (+ 3 max-length) length)
                                               ?\s)
                                  (if desc
                                      (concat desc)))
                        (concat "\n" title "\n"))))
		  text-menu))
    output))



;;; Template

(defun org-e-texinfo-template (contents info)
  "Return complete document string after Texinfo conversion.
CONTENTS is the transcoded contents string.  INFO is a plist
holding export options."
  (let* ((title (org-export-data (plist-get info :title) info))
	 (info-filename (or (plist-get info :texinfo-filename)
			    (file-name-nondirectory
			     (org-export-output-file-name ".info"))))
	 (author (org-export-data (plist-get info :author) info))
	 (texinfo-header (plist-get info :texinfo-header))
	 (subtitle (plist-get info :subtitle))
	 (subauthor (plist-get info :subauthor))
	 (class (plist-get info :texinfo-class))
	 (header (nth 1 (assoc class org-e-texinfo-classes)))
	 (copying (org-e-texinfo--find-copying info))
	 (dircat (plist-get info :texinfo-dircat))
	 (dirtitle (plist-get info :texinfo-dirtitle))
	 (dirdesc (plist-get info :texinfo-dirdesc))
	 ;; Spacing to align description (column 32 - 3 for `* ' and
	 ;; `.' in text.
	 (dirspacing (- 29 (length dirtitle))))
    (concat
     ;; Header
     header "\n"
     "@c %**start of header\n"
     ;; Filename and Title
     "@setfilename " info-filename "\n"
     "@settitle " title "\n"
     "\n\n"
     "@c Version and Contact Info\n"
     "@set AUTHOR " author "\n"

     ;; Additional Header Options set by `#+TEXINFO_HEADER
     (if texinfo-header
	 (concat "\n"
		 texinfo-header
		 "\n"))
     
     "@c %**end of header\n"
     "@finalout\n"
     "\n\n"

     ;; Copying
     "@copying\n"
     ;; Only export the content of the headline, do not need the
     ;; initial headline.
     (org-export-data (nth 2 copying) info)
     "@end copying\n"
     "\n\n"

     ;; Info directory information
     ;; Only supply if both title and category are provided
     (if (and dircat dirtitle)
	 (concat "@dircategory " dircat "\n"
		 "@direntry\n"
		 "* " dirtitle "."
		 (make-string dirspacing ?\s)
		 dirdesc "\n"
		 "@end direntry\n"))
     "\n\n"

     ;; Title
     "@titlepage\n"
     "@title " title "\n\n"
     (if subtitle
	 (concat "@subtitle " subtitle "\n"))
     "@author " author "\n"
     (if subauthor
	 (concat subauthor "\n"))
     "\n"
     "@c The following two commands start the copyright page.\n"
     "@page\n"
     "@vskip 0pt plus 1filll\n"
     "@insertcopying\n"
     "@end titlepage\n\n"
     "@c Output the table of contents at the beginning.\n"
     "@contents\n\n"

     ;; Configure Top Node when not for Tex
     "@ifnottex\n"
     "@node Top\n"
     "@top " title " Manual\n"
     "@insertcopying\n"
     "@end ifnottex\n\n"
     
     ;; Menu
     "@menu\n"
     (org-e-texinfo-make-menu info 'main)
     "\n\n"
     ;; Detailed Menu
     "@detailmenu\n"
     " --- The Detailed Node Listing ---\n"
     (org-e-texinfo-make-menu info 'detailed)
     "\n\n"
     "@end detailmenu\n"
     "@end menu\n"
     "\n\n"
     
     ;; Document's body.
     contents
     "\n"
     ;; Creator.
     (let ((creator-info (plist-get info :with-creator)))
       (cond
	((not creator-info) "")
	((eq creator-info 'comment)
	 (format "@c %s\n" (plist-get info :creator)))
	(t (concat (plist-get info :creator) "\n"))))
     ;; Document end.
     "\n@bye")))


\f
;;; Transcode Functions

;;;; Babel Call
;;
;; Babel Calls are ignored.


;;;; Bold

(defun org-e-texinfo-bold (bold contents info)
  "Transcode BOLD from Org to Texinfo.
CONTENTS is the text with bold markup.  INFO is a plist holding
contextual information."
  (org-e-texinfo--text-markup contents 'bold))


;;;; Center Block
;;
;; Center blocks are ignored


;;;; Clock

(defun org-e-texinfo-clock (clock contents info)
  "Transcode a CLOCK element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  (concat
   "@noindent"
   (format "@strong{%s} " org-clock-string)
   (format org-e-texinfo-inactive-timestamp-format
	   (concat (org-translate-time (org-element-property :value clock))
		   (let ((time (org-element-property :time clock)))
		     (and time (format " (%s)" time)))))
   "@*"))


;;;; Code

(defun org-e-texinfo-code (code contents info)
  "Transcode a CODE object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist used as a communication
channel."
  (org-e-texinfo--text-markup (org-element-property :value code) 'code))

;;;; Comment

(defun org-e-texinfo-comment (comment contents info)
  "Transcode a COMMENT object from Org to Texinfo.
CONTENTS is the text in the comment.  INFO is a plist holding
contextual information."
  (org-e-texinfo--text-markup (org-element-property :value comment) 'comment))

;;;; Comment Block

(defun org-e-texinfo-comment-block (comment-block contents info)
  "Transcode a COMMENT-BLOCK object from Org to Texinfo.
CONTENTS is the text within the block.  INFO is a plist holding
contextual information."
  (format "@ignore\n%s@end ignore" (org-element-property :value comment-block)))

;;;; Drawer

(defun org-e-texinfo-drawer (drawer contents info)
  "Transcode a DRAWER element from Org to Texinfo.
CONTENTS holds the contents of the block.  INFO is a plist
holding contextual information."
  (let* ((name (org-element-property :drawer-name drawer))
	 (output (if (functionp org-e-texinfo-format-drawer-function)
		     (funcall org-e-texinfo-format-drawer-function
			      name contents)
		   ;; If there's no user defined function: simply
		   ;; display contents of the drawer.
		   contents)))
    output))


;;;; Dynamic Block

(defun org-e-texinfo-dynamic-block (dynamic-block contents info)
  "Transcode a DYNAMIC-BLOCK element from Org to Texinfo.
CONTENTS holds the contents of the block.  INFO is a plist
holding contextual information.  See `org-export-data'."
  contents)


;;;; Entity

(defun org-e-texinfo-entity (entity contents info)
  "Transcode an ENTITY object from Org to Texinfo.
CONTENTS are the definition itself.  INFO is a plist holding
contextual information."
  (let ((ent (org-element-property :latex entity)))
    (if (org-element-property :latex-math-p entity) (format "@math{%s}" ent) ent)))


;;;; Example Block

(defun org-e-texinfo-example-block (example-block contents info)
  "Transcode an EXAMPLE-BLOCK element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  (format "@verbatim\n%s@end verbatim"
	  (org-export-format-code-default example-block info)))


;;;; Export Block

(defun org-e-texinfo-export-block (export-block contents info)
  "Transcode a EXPORT-BLOCK element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (when (string= (org-element-property :type export-block) "TEXINFO")
    (org-remove-indentation (org-element-property :value export-block))))


;;;; Export Snippet

(defun org-e-texinfo-export-snippet (export-snippet contents info)
  "Transcode a EXPORT-SNIPPET object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (when (eq (org-export-snippet-backend export-snippet) 'e-texinfo)
    (org-element-property :value export-snippet)))


;;;; Fixed Width

(defun org-e-texinfo-fixed-width (fixed-width contents info)
  "Transcode a FIXED-WIDTH element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (format "@example\n%s\n@end example"
	  (org-remove-indentation
	   (org-element-property :value fixed-width))))


;;;; Footnote Definition
;;
;; Footnote Definitions are ignored.


;;;; Footnote Reference
;;

(defun org-e-texinfo-footnote-reference (footnote contents info)
  "Create a footnote reference for FOOTNOTE.

FOOTNOTE is the footnote to define.  CONTENTS is nil.  INFO is a
plist holding contextual information."
  (let ((def (org-export-get-footnote-definition footnote info)))
    (format "@footnote{%s}"
	    (org-trim (org-export-data def info)))))

;;;; Headline

(defun org-e-texinfo-headline (headline contents info)
  "Transcode an HEADLINE element from Org to Texinfo.
CONTENTS holds the contents of the headline.  INFO is a plist
holding contextual information."
  (let* ((class (plist-get info :texinfo-class))
	 (level (org-export-get-relative-level headline info))
	 (numberedp (org-export-numbered-headline-p headline info))
	 (class-sectionning (assoc class org-e-texinfo-classes))
	 ;; Find the index type, if any
	 (index (org-element-property :index headline))
	 ;; Create node info, to insert it before section formatting.
	 (node (format "@node %s\n"
		       (org-export-data
			(org-element-property :title headline) info)))
	 ;; Menus must be generated with first child, otherwise they
	 ;; will not nest properly
	 (menu (let* ((first (org-export-first-sibling-p headline info))
		      (parent (org-export-get-parent-headline headline))
		      (title (org-export-data
			      (org-element-property :title parent) info))
		      heading listing
		      (tree (plist-get info :parse-tree)))
		 (if first
		     (org-element-map
		      (plist-get info :parse-tree) 'headline
		      (lambda (ref)
			(if (member title (org-element-property :title ref))
			    (push ref heading)))
		      info 't))
		 (setq listing (org-e-texinfo--build-menu
				(car heading) level info))
	 	 (if listing
	 	     (setq listing (format
				    "\n@menu\n%s\n@end menu\n\n" listing))
	 	   'nil)))
	 ;; Section formatting will set two placeholders: one for the
	 ;; title and the other for the contents.
	 (section-fmt
	  (let ((sec (if (and (symbolp (nth 2 class-sectionning))
			      (fboundp (nth 2 class-sectionning)))
			 (funcall (nth 2 class-sectionning) level numberedp)
		       (nth (1+ level) class-sectionning))))
	    (cond
	     ;; No section available for that LEVEL.
	     ((not sec) nil)
	     ;; Section format directly returned by a function.
	     ((stringp sec) sec)
	     ;; (numbered-section . unnumbered-section)
	     ((not (consp (cdr sec)))
	      ;; If an index, always unnumbered
	      (if index
		  (concat menu node (cdr sec) "\n%s")
		;; Otherwise number as needed.
		(concat menu node
			(funcall
			 (if numberedp #'car #'cdr) sec) "\n%s"))))))
	 (text (org-export-data
		(org-element-property :title headline) info))
	 (todo
	  (and (plist-get info :with-todo-keywords)
	       (let ((todo (org-element-property :todo-keyword headline)))
		 (and todo (org-export-data todo info)))))
	 (todo-type (and todo (org-element-property :todo-type headline)))
	 (tags (and (plist-get info :with-tags)
		    (org-export-get-tags headline info)))
	 (priority (and (plist-get info :with-priority)
			(org-element-property :priority headline)))
	 ;; Create the headline text along with a no-tag version.  The
	 ;; latter is required to remove tags from table of contents.
	 (full-text (if (functionp org-e-texinfo-format-headline-function)
			;; User-defined formatting function.
			(funcall org-e-texinfo-format-headline-function
				 todo todo-type priority text tags)
		      ;; Default formatting.
		      (concat
		       (when todo
			 (format "@strong{%s} " todo))
		       (when priority (format "@emph{#%s} " priority))
		       text
		       (when tags
			 (format ":%s:"
				 (mapconcat 'identity tags ":"))))))
	 (full-text-no-tag
	  (if (functionp org-e-texinfo-format-headline-function)
	      ;; User-defined formatting function.
	      (funcall org-e-texinfo-format-headline-function
		       todo todo-type priority text nil)
	    ;; Default formatting.
	    (concat
	     (when todo (format "@strong{%s} " todo))
	     (when priority (format "@emph{#%c} " priority))
	     text)))
	 (pre-blanks
	  (make-string (org-element-property :pre-blank headline) 10)))
    (cond
     ;; Case 1: This is a footnote section: ignore it.
     ((org-element-property :footnote-section-p headline) nil)
     ;; Case 2: This is the `copying' section: ignore it
     ;;         This is used elsewhere.
     ((org-element-property :copying headline) nil)
     ;; Case 3: An index.  If it matches one of the known indexes,
     ;;         print it as such following the contents, otherwise
     ;;         print the contents and leave the index up to the user.
     (index
      (format
       section-fmt full-text
       (concat pre-blanks contents "\n" 
	       (if (member index '("cp" "fn" "ky" "pg" "tp" "vr"))
		   (concat "@printindex " index)))))
     ;; Case 4: This is a deep sub-tree: export it as a list item.
     ;;         Also export as items headlines for which no section
     ;;         format has been found.
     ((or (not section-fmt) (org-export-low-level-p headline info))
      ;; Build the real contents of the sub-tree.
      (let ((low-level-body
	     (concat
	      ;; If the headline is the first sibling, start a list.
	      (when (org-export-first-sibling-p headline)
		(format "@%s\n" (if numberedp 'enumerate 'itemize)))
	      ;; Itemize headline
	      "@item\n" full-text "\n" pre-blanks contents)))
	;; If headline is not the last sibling simply return
	;; LOW-LEVEL-BODY.  Otherwise, also close the list, before any
	;; blank line.
	(if (not (org-export-last-sibling-p headline)) low-level-body
	  (replace-regexp-in-string
	   "[ \t\n]*\\'"
	   (format "\n@end %s" (if numberedp 'enumerate 'itemize))
	   low-level-body))))
     ;; Case 5: Standard headline.  Export it as a section.
     (t
      (cond
       ((not (and tags (eq (plist-get info :with-tags) 'not-in-toc)))
	;; Regular section.  Use specified format string.
	(format (replace-regexp-in-string "%]" "%%]" section-fmt) full-text
		(concat pre-blanks contents)))
       ((string-match "\\`@\\(.*?\\){" section-fmt)
	;; If tags should be removed from table of contents, insert
	;; title without tags as an alternative heading in sectioning
	;; command.
	(format (replace-match (concat (match-string 1 section-fmt) "[%s]")
			       nil nil section-fmt 1)
		;; Replace square brackets with parenthesis since
		;; square brackets are not supported in optional
		;; arguments.
		(replace-regexp-in-string
		 "\\[" "("
		 (replace-regexp-in-string
		  "\\]" ")"
		  full-text-no-tag))
		full-text
		(concat pre-blanks contents)))
       (t
	;; Impossible to add an alternative heading.  Fallback to
	;; regular sectioning format string.
	(format (replace-regexp-in-string "%]" "%%]" section-fmt) full-text
		(concat pre-blanks contents))))))))


;;;; Horizontal Rule
;;
;; Horizontal rules are ignored

;;;; Inline Babel Call
;;
;; Inline Babel Calls are ignored.


;;;; Inline Src Block

(defun org-e-texinfo-inline-src-block (inline-src-block contents info)
  "Transcode an INLINE-SRC-BLOCK element from Org to Texinfo.
CONTENTS holds the contents of the item.  INFO is a plist holding
contextual information."
  (let* ((code (org-element-property :value inline-src-block))
	 (separator (org-e-texinfo--find-verb-separator code)))
    (concat "@verb{" separator code separator "}")))


;;;; Inlinetask

(defun org-e-texinfo-inlinetask (inlinetask contents info)
  "Transcode an INLINETASK element from Org to Texinfo.
CONTENTS holds the contents of the block.  INFO is a plist
holding contextual information."
  (let ((title (org-export-data (org-element-property :title inlinetask) info))
	(todo (and (plist-get info :with-todo-keywords)
		   (let ((todo (org-element-property :todo-keyword inlinetask)))
		     (and todo (org-export-data todo info)))))
	(todo-type (org-element-property :todo-type inlinetask))
	(tags (and (plist-get info :with-tags)
		   (org-export-get-tags inlinetask info)))
	(priority (and (plist-get info :with-priority)
		       (org-element-property :priority inlinetask))))
    ;; If `org-e-texinfo-format-inlinetask-function' is provided, call it
    ;; with appropriate arguments.
    (if (functionp org-e-texinfo-format-inlinetask-function)
	(funcall org-e-texinfo-format-inlinetask-function
		 todo todo-type priority title tags contents)
      ;; Otherwise, use a default template.
      (let ((full-title
	     (concat
	      (when todo (format "@strong{%s} " todo))
	      (when priority (format "#%c " priority))
	      title
	      (when tags (format ":%s:"
				 (mapconcat 'identity tags ":"))))))
	(format (concat "@center %s\n\n"
			"%s"
			"\n")
		full-title contents)))))


;;;; Italic

(defun org-e-texinfo-italic (italic contents info)
  "Transcode ITALIC from Org to Texinfo.
CONTENTS is the text with italic markup.  INFO is a plist holding
contextual information."
  (org-e-texinfo--text-markup contents 'italic))

;;;; Item

(defun org-e-texinfo-item (item contents info)
  "Transcode an ITEM element from Org to Texinfo.
CONTENTS holds the contents of the item.  INFO is a plist holding
contextual information."
  (let* ((tag (org-element-property :tag item))
	 (desc (org-export-data tag info)))
   (concat "\n@item " (if tag desc) "\n"
	   (org-trim contents) "\n")))


;;;; Keyword

(defun org-e-texinfo-keyword (keyword contents info)
  "Transcode a KEYWORD element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (let ((key (org-element-property :key keyword))
	(value (org-element-property :value keyword)))
    (cond
     ((string= key "TEXINFO") value)
     ((string= key "CINDEX") (format "@cindex %s" value))
     ((string= key "FINDEX") (format "@findex %s" value))
     ((string= key "KINDEX") (format "@kindex %s" value))
     ((string= key "PINDEX") (format "@pindex %s" value))
     ((string= key "TINDEX") (format "@tindex %s" value))
     ((string= key "VINDEX") (format "@vindex %s" value))
     )))


;;;; Latex Environment
;;
;; Latex environments are ignored


;;;; Latex Fragment
;;
;; Latex fragments are ignored.


;;;; Line Break

(defun org-e-texinfo-line-break (line-break contents info)
  "Transcode a LINE-BREAK object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  "@*")


;;;; Link

(defun org-e-texinfo-link (link desc info)
  "Transcode a LINK object from Org to Texinfo.

DESC is the description part of the link, or the empty string.
INFO is a plist holding contextual information.  See
`org-export-data'."
  (let* ((type (org-element-property :type link))
	 (raw-path (org-element-property :path link))
	 ;; Ensure DESC really exists, or set it to nil.
	 (desc (and (not (string= desc "")) desc))
	 (path (cond
		((member type '("http" "https" "ftp"))
		 (concat type ":" raw-path))
		((string= type "file")
		 (when (string-match "\\(.+\\)::.+" raw-path)
		   (setq raw-path (match-string 1 raw-path)))
		 (if (file-name-absolute-p raw-path)
		     (concat "file://" (expand-file-name raw-path))
		   (concat "file://" raw-path)))
		(t raw-path)))
	 (email (if (string= type "mailto")
		    (let ((text (replace-regexp-in-string
				 "@" "@@" raw-path)))
		     (concat text (if desc (concat "," desc))))))
	 protocol)
    (cond
     ;; Links pointing to an headline: Find destination and build
     ;; appropriate referencing command.
     ((member type '("custom-id" "id"))
      (let ((destination (org-export-resolve-id-link link info)))
	(case (org-element-type destination)
	  ;; Id link points to an external file.
	  (plain-text
	   (if desc (format "@uref{file://%s,%s}" destination desc)
	     (format "@uref{file://%s}" destination)))
	  ;; LINK points to an headline.  Use the headline as the NODE target
	  (headline
	   (format "@ref{%s}"
		   (org-export-data
		    (org-element-property :title destination) info)))
	  (otherwise
	   (let ((path (org-export-solidify-link-text path)))
	     (if (not desc) (format "@ref{%s}" path)
	       (format "@ref{%s,,%s}" path desc)))))))
     ((member type '("fuzzy"))
      (let ((destination (org-export-resolve-fuzzy-link link info)))
	(case (org-element-type destination)
	  ;; Id link points to an external file.
	  (plain-text
	   (if desc (format "@uref{file://%s,%s}" destination desc)
	     (format "@uref{file://%s}" destination)))
	  ;; LINK points to an headline.  Use the headline as the NODE target
	  (headline
	   (format "@ref{%s}"
		   (org-export-data
		    (org-element-property :title destination) info)))
	  (otherwise
	   (let ((path (org-export-solidify-link-text path)))
	     (if (not desc) (format "@ref{%s}" path)
	       (format "@ref{%s,,%s}" path desc)))))))
     ;; Special case for email addresses
     (email
      (format "@email{%s}" email))
     ;; External link with a description part.
     ((and path desc) (format "@uref{%s,%s}" path desc))
     ;; External link without a description part.
     (path (format "@uref{%s}" path))
     ;; No path, only description.  Try to do something useful.
     (t (format org-e-texinfo-link-with-unknown-path-format desc)))))


;;;; Macro

(defun org-e-texinfo-macro (macro contents info)
  "Transcode a MACRO element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  ;; Use available tools.
  (org-export-expand-macro macro info))


;;;; Menu

(defun org-e-texinfo-make-menu (info level)
  "Create the menu for inclusion in the texifo document.

INFO is the parsed buffer that contains the headlines.  LEVEL
determines whether to make the main menu, or the detailed menu.

This is only used for generating the primary menu.  In-Node menus
are generated directly."
  (let* ((parse (plist-get info :parse-tree))
	 ;; Top determines level to build menu from, it finds the
	 ;; level of the first headline in the export.
	 (top (org-element-map
	       parse 'headline
	       (lambda (headline)
		 (org-element-property :level headline)) info 't)))
    (cond
     ;; Generate the main menu
     ((eq level 'main)
      (org-e-texinfo--build-menu parse top info))
     ;; Generate the detailed (recursive) menu
     ((eq level 'detailed)
      ;; Requires recursion
      ;;(org-e-texinfo--build-detailed-menu parse top info)
      (or (org-e-texinfo--build-menu parse top info 'detailed)
	  "detailed"))
     ;; Otherwise do nothing
     (t))))


;;;; Paragraph

(defun org-e-texinfo-paragraph (paragraph contents info)
  "Transcode a PARAGRAPH element from Org to Texinfo.
CONTENTS is the contents of the paragraph, as a string.  INFO is
the plist used as a communication channel."
  contents)


;;;; Plain List

(defun org-e-texinfo-plain-list (plain-list contents info)
  "Transcode a PLAIN-LIST element from Org to Texinfo.
CONTENTS is the contents of the list.  INFO is a plist holding
contextual information."
  (let* ((type (org-element-property :type plain-list))
	 (list-type (cond
		     ((eq type 'ordered) "enumerate")
		     ((eq type 'unordered) "itemize")
		     ((eq type 'descriptive) "table"))))
    (format "@%s%s\n@end %s"
	    (if (eq type 'descriptive)
		(concat list-type " " org-e-texinfo-def-table-markup)
	     list-type)
	    contents
	    list-type)))


;;;; Plain Text

(defun org-e-texinfo-plain-text (text info)
  "Transcode a TEXT string from Org to Texinfo.
TEXT is the string to transcode.  INFO is a plist holding
contextual information."
  ;; Protect @ { and }.
  (while (string-match "\\([^\\]\\|^\\)\\([@{}]\\)" text)
    (setq text
	  (replace-match (format "\\%s" (match-string 2 text)) nil t text 2)))
  ;; LaTeX into @LaTeX{} and TeX into @TeX{}
  (let ((case-fold-search nil)
	(start 0))
    (while (string-match "\\(\\(?:La\\)?TeX\\)" text start)
      (setq text (replace-match
		  (format "@%s{}" (match-string 1 text)) nil t text)
	    start (match-end 0))))
  ;; Handle quotation marks
  (setq text (org-e-texinfo--quotation-marks text info))
  ;; Convert special strings.
  (when (plist-get info :with-special-strings)
    (while (string-match (regexp-quote "...") text)
      (setq text (replace-match "@dots{}" nil t text))))
  ;; Handle break preservation if required.
  (when (plist-get info :preserve-breaks)
    (setq text (replace-regexp-in-string "\\(\\\\\\\\\\)?[ \t]*\n" " @*\n"
					 text)))
  ;; Return value.
  text)


;;;; Planning

(defun org-e-texinfo-planning (planning contents info)
  "Transcode a PLANNING element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  (concat
   "@noindent"
   (mapconcat
    'identity
    (delq nil
	  (list
	   (let ((closed (org-element-property :closed planning)))
	     (when closed
	       (concat
		(format "@strong%s} " org-closed-string)
		(format org-e-texinfo-inactive-timestamp-format
			(org-translate-time closed)))))
	   (let ((deadline (org-element-property :deadline planning)))
	     (when deadline
	       (concat
		(format "@strong{%s} " org-deadline-string)
		(format org-e-texinfo-active-timestamp-format
			(org-translate-time deadline)))))
	   (let ((scheduled (org-element-property :scheduled planning)))
	     (when scheduled
	       (concat
		(format "@strong{%s} " org-scheduled-string)
		(format org-e-texinfo-active-timestamp-format
			(org-translate-time scheduled)))))))
    " ")
   "@*"))


;;;; Property Drawer

(defun org-e-texinfo-property-drawer (property-drawer contents info)
  "Transcode a PROPERTY-DRAWER element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  ;; The property drawer isn't exported but we want separating blank
  ;; lines nonetheless.
  "")


;;;; Quote Block

(defun org-e-texinfo-quote-block (quote-block contents info)
  "Transcode a QUOTE-BLOCK element from Org to Texinfo.
CONTENTS holds the contents of the block.  INFO is a plist
holding contextual information."
  
  (let* ((title (org-element-property :name quote-block))
	 (start-quote (concat "@quotation"

			      (if title
				 (format " %s" title)))))
    
    (format "%s\n%s@end quotation" start-quote contents)))


;;;; Quote Section

(defun org-e-texinfo-quote-section (quote-section contents info)
  "Transcode a QUOTE-SECTION element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (let ((value (org-remove-indentation
		(org-element-property :value quote-section))))
    (when value (format "@verbatim\n%s@end verbatim" value))))


;;;; Radio Target

(defun org-e-texinfo-radio-target (radio-target text info)
  "Transcode a RADIO-TARGET object from Org to Texinfo.
TEXT is the text of the target.  INFO is a plist holding
contextual information."
  (format "@anchor{%s}%s"
	  (org-export-solidify-link-text
	   (org-element-property :value radio-target))
	  text))


;;;; Section

(defun org-e-texinfo-section (section contents info)
  "Transcode a SECTION element from Org to Texinfo.
CONTENTS holds the contents of the section.  INFO is a plist
holding contextual information."
  contents)


;;;; Special Block
;;
;; Are ignored at the moment

;;;; Src Block

(defun org-e-texinfo-src-block (src-block contents info)
  "Transcode a SRC-BLOCK element from Org to Texinfo.
CONTENTS holds the contents of the item.  INFO is a plist holding
contextual information."
  (let* ((lang (org-element-property :language src-block))
	 (lisp-p (string-match-p "lisp" lang)))
    (cond
     ;; Case 1.  Lisp Block
     (lisp-p
      (format "@lisp\n%s\n@end lisp"
	      (org-export-format-code-default src-block info)))
     ;; Case 2.  Other blocks
     (t
      (format "@example\n%s\n@end example"
	      (org-export-format-code-default src-block info))))))


;;;; Statistics Cookie

(defun org-e-texinfo-statistics-cookie (statistics-cookie contents info)
  "Transcode a STATISTICS-COOKIE object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (org-element-property :value statistics-cookie))


;;;; Strike-Through
;;
;; Strikethrough is ignored


;;;; Subscript

(defun org-e-texinfo-subscript (subscript contents info)
  "Transcode a SUBSCRIPT object from Org to Texinfo.
CONTENTS is the contents of the object.  INFO is a plist holding
contextual information."
  (format "@math{_%s}" contents))


;;;; Superscript

(defun org-e-texinfo-superscript (superscript contents info)
  "Transcode a SUPERSCRIPT object from Org to Texinfo.
CONTENTS is the contents of the object.  INFO is a plist holding
contextual information."
  (format "@math{^%s}" contents))


;;;; Table
;;
;; `org-e-texinfo-table' is the entry point for table transcoding.  It
;; takes care of tables with a "verbatim" attribute.  Otherwise, it
;; delegates the job to either `org-e-texinfo-table--table.el-table' or
;; `org-e-texinfo-table--org-table' functions, depending of the type of
;; the table.
;;
;; `org-e-texinfo-table--align-string' is a subroutine used to build
;; alignment string for Org tables.

(defun org-e-texinfo-table (table contents info)
  "Transcode a TABLE element from Org to Texinfo.
CONTENTS is the contents of the table.  INFO is a plist holding
contextual information."
  (cond
   ;; Case 1: verbatim table.
   ((or org-e-texinfo-tables-verbatim
	(let ((attr (mapconcat 'identity
			       (org-element-property :attr_latex table)
			       " ")))
	  (and attr (string-match "\\<verbatim\\>" attr))))
    (format "@verbatim \n%s\n@end verbatim"
	    ;; Re-create table, without affiliated keywords.
	    (org-trim
	     (org-element-interpret-data
	      `(table nil ,@(org-element-contents table))))))
   ;; Case 2: table.el table.  Convert it using appropriate tools.
   ((eq (org-element-property :type table) 'table.el)
    (org-e-texinfo-table--table.el-table table contents info))
   ;; Case 3: Standard table.
   (t (org-e-texinfo-table--org-table table contents info))))

(defun org-e-texinfo-table-column-widths (table info)
  "Determine the largest table cell in each column to process alignment.

TABLE is the table element to transcode.  INFO is a plist used as
a communication channel."
  (let* ((rows (org-element-map table 'table-row 'identity info))
	 (collected (loop for row in rows collect
			  (org-element-map
			   row 'table-cell 'identity info)))
	 (number-cells (length (car collected)))
	 cells counts)
    (loop for row in collected do
	  (push (mapcar (lambda (ref)
		     (let* ((start (org-element-property :contents-begin ref))
			    (end (org-element-property :contents-end ref))
			    (length (- end start)))
		       length)) row) cells))
    (setq cells (remove-if #'null cells))
    (push (loop for count from 0 to (- number-cells 1) collect
		   (loop for item in cells collect
			 (nth count item))) counts)
    (mapconcat '(lambda (size)
		  (make-string size ?a)) (mapcar (lambda (ref)
				   (apply 'max `,@ref)) (car counts))
	       "} {")
  ))

(defun org-e-texinfo-table--org-table (table contents info)
  "Return appropriate Texinfo code for an Org table.

TABLE is the table type element to transcode.  CONTENTS is its
contents, as a string.  INFO is a plist used as a communication
channel.

This function assumes TABLE has `org' as its `:type' attribute."
  (let* ((attr (org-export-read-attribute :attr_texinfo table))
	 (col-width (plist-get attr :columns))
	 (columns (if col-width
		      (format "@columnfractions %s"
			      col-width)
		    (format "{%s}"
			    (org-e-texinfo-table-column-widths
			     table info)))))
    ;; Prepare the final format string for the table.
    (cond
     ;; Longtable.
     ;; Others.
     (t (concat
	 (format "@multitable %s\n%s@end multitable"
		 columns
		 contents))))))

(defun org-e-texinfo-table--table.el-table (table contents info)
  "Returns nothing.

Rather than return an invalid table, nothing is returned."
  'nil)


;;;; Table Cell

(defun org-e-texinfo-table-cell (table-cell contents info)
  "Transcode a TABLE-CELL element from Org to Texinfo.
CONTENTS is the cell contents.  INFO is a plist used as
a communication channel."
  (concat (if (and contents
		   org-e-texinfo-table-scientific-notation
		   (string-match orgtbl-exp-regexp contents))
	      ;; Use appropriate format string for scientific
	      ;; notation.
	      (format org-e-texinfo-table-scientific-notation
		      (match-string 1 contents)
		      (match-string 2 contents))
	    contents)
	  (when (org-export-get-next-element table-cell) "\n@tab ")))


;;;; Table Row

(defun org-e-texinfo-table-row (table-row contents info)
  "Transcode a TABLE-ROW element from Org to Texinfo.
CONTENTS is the contents of the row.  INFO is a plist used as
a communication channel."
  ;; Rules are ignored since table separators are deduced from
  ;; borders of the current row.
  (when (eq (org-element-property :type table-row) 'standard) 
    (concat "@item " contents "\n")))


;;;; Target

(defun org-e-texinfo-target (target contents info)
  "Transcode a TARGET object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  (format "@anchor{%s}"
	  (org-export-solidify-link-text (org-element-property :value target))))


;;;; Timestamp

(defun org-e-texinfo-timestamp (timestamp contents info)
  "Transcode a TIMESTAMP object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  (let ((value (org-translate-time (org-element-property :value timestamp)))
	(type (org-element-property :type timestamp)))
    (cond ((memq type '(active active-range))
	   (format org-e-texinfo-active-timestamp-format value))
	  ((memq type '(inactive inactive-range))
	   (format org-e-texinfo-inactive-timestamp-format value))
	  (t (format org-e-texinfo-diary-timestamp-format value)))))


;;;; Underline
;;
;; Underline is ignored


;;;; Verbatim

(defun org-e-texinfo-verbatim (verbatim contents info)
  "Transcode a VERBATIM object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist used as a communication
channel."
  (org-e-texinfo--text-markup (org-element-property :value verbatim) 'verbatim))


;;;; Verse Block

(defun org-e-texinfo-verse-block (verse-block contents info)
  "Transcode a VERSE-BLOCK element from Org to Texinfo.
CONTENTS is verse block contents. INFO is a plist holding
contextual information."
  ;; In a verse environment, add a line break to each newline
  ;; character and change each white space at beginning of a line
  ;; into a space of 1 em.  Also change each blank line with
  ;; a vertical space of 1 em.
  (progn
    (setq contents (replace-regexp-in-string
		    "^ *\\\\\\\\$" "\\\\vspace*{1em}"
		    (replace-regexp-in-string
		     "\\(\\\\\\\\\\)?[ \t]*\n" " \\\\\\\\\n" contents)))
    (while (string-match "^[ \t]+" contents)
      (let ((new-str (format "\\hspace*{%dem}"
			     (length (match-string 0 contents)))))
	(setq contents (replace-match new-str nil t contents))))
    (format "\\begin{verse}\n%s\\end{verse}" contents)))


\f
;;; Interactive functions

(defun org-e-texinfo-export-to-texinfo
  (&optional subtreep visible-only body-only ext-plist pub-dir)
  "Export current buffer to a Texinfo file.

If narrowing is active in the current buffer, only export its
narrowed part.

If a region is active, export that region.

When optional argument SUBTREEP is non-nil, export the sub-tree
at point, extracting information from the headline properties
first.

When optional argument VISIBLE-ONLY is non-nil, don't export
contents of hidden elements.

When optional argument BODY-ONLY is non-nil, only write code
between \"\\begin{document}\" and \"\\end{document}\".

EXT-PLIST, when provided, is a property list with external
parameters overriding Org default settings, but still inferior to
file-local settings.

When optional argument PUB-DIR is set, use it as the publishing
directory.

Return output file's name."
  (interactive)
  (let ((outfile (org-export-output-file-name ".texi" subtreep pub-dir)))
    (org-export-to-file
     'e-texinfo outfile subtreep visible-only body-only ext-plist)))

(defun org-e-texinfo-export-to-info
  (&optional subtreep visible-only body-only ext-plist pub-dir)
  "Export current buffer to Texinfo then process through to INFO.

If narrowing is active in the current buffer, only export its
narrowed part.

If a region is active, export that region.

When optional argument SUBTREEP is non-nil, export the sub-tree
at point, extracting information from the headline properties
first.

When optional argument VISIBLE-ONLY is non-nil, don't export
contents of hidden elements.

When optional argument BODY-ONLY is non-nil, only write code
between \"\\begin{document}\" and \"\\end{document}\".

EXT-PLIST, when provided, is a property list with external
parameters overriding Org default settings, but still inferior to
file-local settings.

When optional argument PUB-DIR is set, use it as the publishing
directory.

Return INFO file's name."
  (interactive)
  (org-e-texinfo-compile
   (org-e-texinfo-export-to-texinfo
    subtreep visible-only body-only ext-plist pub-dir)))

(defun org-e-texinfo-compile (texifile)
  "Compile a texinfo file.

TEXIFILE is the name of the file being compiled.  Processing is
done through the command specified in `org-e-texinfo-info-process'.

Return INFO file name or an error if it couldn't be produced."
  (let* ((wconfig (current-window-configuration))
	 (texifile (file-truename texifile))
	 (base (file-name-sans-extension texifile))
	 errors)
    (message (format "Processing Texinfo file %s ..." texifile))
    (unwind-protect
	(progn
	  (cond
	   ;; A function is provided: Apply it.
	   ((functionp org-e-texinfo-info-process)
	    (funcall org-e-texinfo-info-process (shell-quote-argument texifile)))
	   ;; A list is provided: Replace %b, %f and %o with appropriate
	   ;; values in each command before applying it.  Output is
	   ;; redirected to "*Org INFO Texinfo Output*" buffer.
	   ((consp org-e-texinfo-info-process)
	    (let* ((out-dir (or (file-name-directory texifile) "./"))
		   (outbuf (get-buffer-create "*Org Info Texinfo Output*")))
	      (mapc
	       (lambda (command)
		 (shell-command
		  (replace-regexp-in-string
		   "%b" (shell-quote-argument base)
		   (replace-regexp-in-string
		    "%f" (shell-quote-argument texifile)
		    (replace-regexp-in-string
		     "%o" (shell-quote-argument out-dir) command t t) t t) t t)
		  outbuf))
	       org-e-texinfo-info-process)
	      ;; Collect standard errors from output buffer.
	      (setq errors (org-e-texinfo-collect-errors outbuf))))
	   (t (error "No valid command to process to Info")))
	  (let ((infofile (concat base ".info")))
	    ;; Check for process failure.  Provide collected errors if
	    ;; possible.
	    (if (not (file-exists-p infofile))
		(error (concat (format "INFO file %s wasn't produced" infofile)
			       (when errors (concat ": " errors))))
	      ;; Else remove log files, when specified, and signal end of
	      ;; process to user, along with any error encountered.
	      (message (concat "Process completed"
			       (if (not errors) "."
				 (concat " with errors: " errors)))))
	    ;; Return output file name.
	    infofile))
      (set-window-configuration wconfig))))

(defun org-e-texinfo-collect-errors (buffer)
  "Collect some kind of errors from \"pdflatex\" command output.

BUFFER is the buffer containing output.

Return collected error types as a string, or nil if there was
none."
  (with-current-buffer buffer
    (save-excursion
      (goto-char (point-max))
      ;; Find final "makeinfo" run.
      (when (re-search-backward "^makeinfo (GNU texinfo)" nil t)
	(let ((case-fold-search t)
	      (errors ""))
	  (when (save-excursion
		  (re-search-forward "perhaps incorrect sectioning?" nil t))
	    (setq errors (concat errors " [incorrect sectionnng]")))
	  (when (save-excursion
		  (re-search-forward "missing close brace" nil t))
	    (setq errors (concat errors " [syntax error]")))
	  (when (save-excursion
		  (re-search-forward "Unknown command" nil t))
	    (setq errors (concat errors " [undefined @command]")))
	  (when (save-excursion
		  (re-search-forward "No matching @end" nil t))
	    (setq errors (concat errors " [block incomplete]")))
	  (when (save-excursion
		  (re-search-forward "requires a sectioning" nil t))
	    (setq errors (concat errors " [invalid section command]")))
	  (when (save-excursion
		  (re-search-forward "[unexpected]" nil t))
	    (setq errors (concat errors " [unexpected error]")))
	  (and (org-string-nw-p errors) (org-trim errors)))))))


(provide 'org-e-texinfo)
;;; org-e-texinfo.el ends here

[-- Attachment #3: orgguide.org --]
[-- Type: application/octet-stream, Size: 93762 bytes --]

#+TITLE: The compact Org-Mode Guide
#+AUTHOR: Carsten Dominic

## Change TODO list to allow for TODO in headline
#+TODO: FIXME(f)

#+TEXINFO_FILENAME: orgguide.info

# #+TEXINFO_HEADER: @include org-version.inc
#+TEXINFO_HEADER: @c Use proper quote and backtick for code sections in PDF output
#+TEXINFO_HEADER: @c Cf. Texinfo manual 14.2
#+TEXINFO_HEADER: @set txicodequoteundirected
#+TEXINFO_HEADER: @set txicodequotebacktick
#+TEXINFO_HEADER: @c Version and Contact Info
#+TEXINFO_HEADER: @set MAINTAINERSITE @uref{http://orgmode.org,maintainers webpage}
#+TEXINFO_HEADER: @set MAINTAINER Carsten Dominik
#+TEXINFO_HEADER: @set MAINTAINEREMAIL @email{carsten at orgmode dot org}
#+TEXINFO_HEADER: @set MAINTAINERCONTACT @uref{mailto:carsten at orgmode dot org,contact the maintainer}

#+TEXINFO_DIR_CATEGORY: Emacs
#+TEXINFO_DIR_TITLE: Org Mode Guide: (orgguide)
#+TEXINFO_DIR_DESC: Abbreviated Org-mode Manual


* Copying
:PROPERTIES:
:copying: t
:END:

Copyright @@info:@copyright{}@@ 2010-2012 Free Software Foundation

#+BEGIN_QUOTE
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with the Front-Cover texts being "A GNU Manual,"
and with the Back-Cover Texts as in (a) below.  A copy of the license
is included in the section entitled "GNU Free Documentation License."

(a) The FSF's Back-Cover Text is: "You have the freedom to copy and
modify this GNU manual.  Buying copies from the FSF supports it in
developing GNU and promoting software freedom."

This document is part of a collection distributed under the GNU Free
Documentation License.  If you want to distribute this document
separately from the collection, you can do so by adding a copy of the
license to the document, as described in section 6 of the license.
#+END_QUOTE

* Introduction
:PROPERTIES:
:DESCRIPTION: Getting started
:END:

** Preface
:PROPERTIES:
:DESCRIPTION: Welcome
:END:

Org is a mode for keeping notes, maintaining TODO lists, and doing
project planning with a fast and effective plain-text system.  It is
also an authoring and publishing system.

This document is a much compressed derivative of the [[http://orgmode.org/index.html#sec-4_1][comprehensive
Org-mode manual]].  It contains all basic features and commands, along
with important hints for customization.  It is intended for beginners
who would shy back from a 200 page manual because of sheer size.

** Installation
:PROPERTIES:
:DESCRIPTION: How to install a downloaded version of Org
:END:

*Important*: If you are using a version of Org that is part of the
Emacs distribution or an XEmacs package, please skip this section and
go directly to [[Activation]].

If you have downloaded Org from the Web, either as a distribution
@@info:@file{.zip}@@ or @@info:@file{.tar}@@ file, or as a Git archive,
it is best to run it directly from the distribution directory.  You
need to add the @@info:@file{lisp}@@ subdirectories to the Emacs load
path.  To do this, add the following line to @@info:@file{.emacs}@@:

#+begin_src emacs-lisp
  (setq load-path (cons "~/path/to/orgdir/lisp" load-path))
  (setq load-path (cons "~/path/to/orgdir/contrib/lisp" load-path))
#+end_src

@@info:@noindent@@ For speed you should byte-compile the Lisp files
with the shell command:

#+begin_src shell
make
#+end_src

Then add the following line to @@info:@file{.emacs}@@.  It is needed so that
Emacs can autoload functions that are located in files not immediately
loaded when Org-mode starts.
#+begin_src emacs-lisp
(require 'org-install)
#+end_src

** Activation
:PROPERTIES:
:DESCRIPTION: How to activate Org for certain buffers
:END:

Add the following lines to your @@info:@file{.emacs}@@ file.  The last
three lines define /global/ keys for some commands --- please choose
suitable keys yourself.

#+begin_src emacs-lisp
;; The following lines are always needed.  Choose your own keys.
(add-to-list 'auto-mode-alist '("\\.org\\'" . org-mode))
(add-hook 'org-mode-hook 'turn-on-font-lock) ; not needed when global-font-lock-mode is on
(global-set-key "\C-cl" 'org-store-link)
(global-set-key "\C-ca" 'org-agenda)
(global-set-key "\C-cb" 'org-iswitchb)
#+end_src

With this setup, all files with extension @@info:@samp{.org}@@ will be
put into Org mode.
** Feedback
:PROPERTIES:
:DESCRIPTION: Bug reports, ideas, patches etc.
:END:

If you find problems with Org, or if you have questions, remarks, or
ideas about it, please mail to the Org mailing list
[[mailto:emacs-orgmode@gnu.org]].  For information on how to submit bug reports,
see the main manual.
* Document Structure
:PROPERTIES:
:DESCRIPTION: A tree works like your brain
:END:

Org is based on Outline mode and provides flexible commands to
edit the structure of the document.

** Outlines
:PROPERTIES:
:DESCRIPTION: Org is based on Outline mode
:END:

Org is implemented on top of Outline mode.  Outlines allow a document
to be organized in a hierarchical structure, which (at least for me)
is the best representation of notes and thoughts.  An overview of this
structure is achieved by folding (hiding) large parts of the document
to show only the general document structure and the parts currently
being worked on.  Org greatly simplifies the use of outlines by
compressing the entire show/hide functionality into a single command,
@@info:@command{org-cycle}@@, which is bound to the @@info:@key{TAB}@@
key.

** Headlines
:PROPERTIES:
:DESCRIPTION: How to typeset Org tree headlines
:END:

Headlines define the structure of an outline tree.  The headlines in
Org start with one or more stars, on the left margin[fn:1].  For
example:

#+begin_src org
  ,* Top level headline
  ,** Second level
  ,*** 3rd level
  ,    some text
  ,*** 3rd level
  ,    more text
  
  ,* Another top level headline
#+end_src

@@info:@noindent@@ Some people find the many stars too noisy and would
prefer an outline that has whitespace followed by a single star as
headline starters.  [[Clean view]], describes a setup to realize this.

** Visibility cycling
:PROPERTIES:
:DESCRIPTION: Show and hide, much simplified
:END:

Outlines make it possible to hide parts of the text in the buffer.
Org uses just two commands, bound to @@info:@key{TAB}@@ and
@@info:@kbd{S-@key{TAB}@@} to change the visibility in the buffer.


- @@info:@key{TAB}@@ :: /Subtree cycling/: Rotate current subtree among the states

     #+begin_example
       ,-> FOLDED -> CHILDREN -> SUBTREE --.
       '-----------------------------------'
     #+end_example

     When called with a prefix argument (@@info:@kbd{C-u @key{TAB}}@@) or with
     the shift key, global cycling is invoked.

- S-@@info:@key{TAB}@@ @@info:@r{and}@@ C-u @@info:@key{TAB}@@ :: /Global
     cycling/: Rotate the entire buffer among the states

     #+begin_example
       ,-> OVERVIEW -> CONTENTS -> SHOW ALL --.
       '--------------------------------------'
     #+end_example

- C-u C-u C-u @@info:@key{TAB}@@ :: Show all, including drawers.

When Emacs first visits an Org file, the global state is set to
OVERVIEW, i.e.: only the top level headlines are visible.  This can be
configured through the variable ~org-startup-folded~, or on a
per-file basis by adding a startup keyword ~overview~, ~content~,
~showall~, like this:

#+begin_src org
  ,#+STARTUP: content
#+end_src

** Motion
:PROPERTIES:
:DESCRIPTION: Jumping to other headlines
:END:
The following commands jump to other headlines in the buffer.

- C-c C-n :: Next heading.
- C-c C-p :: Previous heading.
- C-c C-f :: Next heading same level.
- C-c C-b :: Previous heading same level.
- C-c C-u :: Backward to higher level heading.

** Structure editing
:PROPERTIES:
:DESCRIPTION: Changing sequence and level of headlines
:END:

- M-@@info:@key{RET}@@
Insert new heading with same level as current.  If the cursor is in a plain
list item, a new item is created ([[Plain lists]]).  When this command is
used in the middle of a line, the line is split and the rest of the line
becomes the new headline[fn:2].
- M-S-@@info:@key{RET}@@ :: Insert new TODO entry with same level as
     current heading.
- @@info:@key{TAB}@@ in new, empty entry :: In a new entry with no text
     yet, @@info:@key{TAB}@@ will cycle through reasonable levels.
- M-@@info:@key{left}@r{/}@key{right}@@ :: Promote/demote current
     heading by one level.
- M-S-@@info:@key{left}@r{/}@key{right}@@ :: Promote/demote the
     current subtree by one level.
- M-S-@@info:@key{up}@r{/}@key{down}@@ :: Move subtree up/down
     (swap with previous/next subtree of same level).
- C-c C-w :: Refile entry or region to a different location.  [[Refiling%20notes][Refiling notes]].
- C-x n s/w :: Narrow buffer to current subtree / widen it again

When there is an active region (Transient Mark mode), promotion and
demotion work on all headlines in the region.

** Sparse trees
:PROPERTIES:
:DESCRIPTION: Matches embedded in context
:END:

An important feature of Org mode is the ability to construct /sparse
trees/ for selected information in an outline tree, so that the entire
document is folded as much as possible, but the selected information
is made visible along with the headline structure above
it[fn:12].  Just try it out and you will see
immediately how it works.

Org mode contains several commands creating such trees, all these
commands can be accessed through a dispatcher:

- C-c / :: This prompts for an extra key to select a sparse-tree
           creating command.
- C-c / r :: Occur.  Prompts for a regexp and shows a sparse tree with
             all matches.  Each match is also highlighted; the
             highlights disappear by pressing @@info:@kbd{C-c C-c}@@.

The other sparse tree commands select headings based on TODO keywords,
tags, or properties and will be discussed later in this manual.

** Plain lists
:PROPERTIES:
:DESCRIPTION: Additional structure within an entry
:END:

Within an entry of the outline tree, hand-formatted lists can provide
additional structure.  They also provide a way to create lists of
checkboxes ([[Checkboxes]]).  Org supports editing such lists,
and the HTML exporter ([[Exporting]]) parses and formats them.

Org knows ordered lists, unordered lists, and description lists.
- /Unordered/ list items start with @@info:@samp{-}@@,
  @@info:@samp{+}@@, or @@info:@samp{*}@@ as bullets.
- /Ordered/ list items start with @@info:@samp{1.}@@ or
  @@info:@samp{1)}@@.
- /Description/ list use '::' to separate the
     /term/ from the description.

Items belonging to the same list must have the same indentation on the first
line.  An item ends before the next line that is indented like its
bullet/number, or less.  A list ends when all items are closed, or before two
blank lines.  An example:

#+begin_src org
  ,** Lord of the Rings
  ,   My favorite scenes are (in this order)
  ,   1. The attack of the Rohirrim
  ,   2. Eowyn's fight with the witch king
  ,      + this was already my favorite scene in the book
  ,      + I really like Miranda Otto.
  ,   Important actors in this film are:
  ,   - Elijah Wood :: He plays Frodo
  ,   - Sean Austin :: He plays Sam, Frodo's friend.
#+end_src


The following commands act on items when the cursor is in the first line of
an item (the line with the bullet or number).

- @@info:@key{TAB}@@ :: Items can be folded just like headline levels.
- M-@@info:@key{RET}@@ :: Insert new item at current level.  With a
     prefix argument, force a new heading ([[Structure editing]]).
- M-S-@@info:@key{RET}@@ :: Insert a new item with a checkbox
     ([[Checkboxes]]).
- M-S-@@info:@key{up}@r{/}@key{down}@@ :: Move the item including
     subitems up/down (swap with previous/next item of same
     indentation).  If the list is ordered, renumbering is automatic.
- M-@@info:@key{left}@r{/}M-@key{right}@@ :: Decrease/increase the
     indentation of an item, leaving children alone.
- M-S-@@info:@key{left}@r{/}@key{right}@@ :: Decrease/increase the
     indentation of the item, including subitems.
- C-c C-c :: If there is a checkbox ([[Checkboxes]]) in the item
             line, toggle the state of the checkbox.  Also verify
             bullets and indentation consistency in the whole list.
- C-c - :: Cycle the entire list level through the different
           itemize/enumerate bullets (@@info:@samp{-}@@,
           @@info:@samp{+}@@, @@info:@samp{*}@@, @@info:@samp{1.}@@,
           @@info:@samp{1)}@@).

** Footnote
:PROPERTIES:
:DESCRIPTION: How footnotes are defined in Org's syntax
:END:

A footnote is defined in a paragraph that is started by a footnote marker in
square brackets in column 0, no indentation allowed.  The footnote reference
is simply the marker in square brackets, inside text.  For example:

#+begin_src org
  ,The Org homepage[fn:1] now looks a lot better than it used to.
  ,...
  ,[fn:1] The link is: http://orgmode.org
#+end_src

@@info:@noindent@@ The following commands handle footnotes:

- C-c C-x f :: The footnote action command.  When the cursor is on a
               footnote reference, jump to the definition.  When it is
               at a definition, jump to the (first) reference.
               Otherwise, create a new footnote.  When this command is
               called with a prefix argument, a menu of additional
               options including renumbering is offered.

- C-c C-c :: Jump between definition and reference.

@@info:@noindent@@ *Further Reading*\\
[[http://orgmode.org/manual/Document-Structure.html#Document-Structure][Chapter 2 of the manual]]\\
[[http://sachachua.com/wp/2008/01/outlining-your-notes-with-org/][Sacha Chua's tutorial]]

* Tables
:PROPERTIES:
:DESCRIPTION: Pure magic for quick formatting
:END:


Org comes with a fast and intuitive table editor.  Spreadsheet-like
calculations are supported in connection with the Emacs
@@info:@file{calc}@@ package
#+BEGIN_TEXINFO
@ifinfo
(@pxref{Top,Calc,,Calc,Gnu Emacs Calculator Manual}).
@end ifinfo
@ifnotinfo
(see the Emacs Calculator manual for more information about the Emacs
calculator).
@end ifnotinfo
#+END_TEXINFO

Org makes it easy to format tables in plain ASCII.  Any line with
@@info:@samp{|}@@ as the first non-whitespace character is considered
part of a table.  @@info:@samp{|}@@ is also the column separator.  A
table might look like this:

#+begin_src org
  ,| Name  | Phone | Age |
  ,|-------+-------+-----|
  ,| Peter |  1234 |  17 |
  ,| Anna  |  4321 |  25 |
#+end_src

A table is re-aligned automatically each time you press
@@info:@key{TAB}@@ or @@info:@key{RET}@@ or @@info:@kbd{C-c C-c}@@
inside the table.  @@info:@key{TAB}@@ also moves to the next field
(@@info:@key{RET}@@ to the next row) and creates new table rows at the
end of the table or before horizontal lines.  The indentation of the
table is set by the first line.  Any line starting with
@@info:@samp{|-}@@ is considered as a horizontal separator line and
will be expanded on the next re-align to span the whole table width.
So, to create the above table, you would only type

#+begin_src org
  ,|Name|Phone|Age|
  ,|-
#+end_src

@noindent and then press @@info:@key{TAB}@@ to align the table and start filling in
fields.  Even faster would be to type @@info:@code{|Name|Phone|Age}@@ followed by
@@info:@kbd{C-c @key{RET}@@}.

When typing text into a field, Org treats @@info:@key{DEL}@@,
@@info:@key{Backspace}@@, and all character keys in a special way, so that
inserting and deleting avoids shifting other fields.  Also, when
typing @@info:@emph{immediately after the cursor was moved into a new field
with @kbd{@key{TAB}}, @kbd{S-@key{TAB}} or @kbd{@key{RET}}}@@, the
field is automatically made blank.

@@info:@subsubheading Creation and conversion@@
- C-c | :: Convert the active region to table.  If every line contains
           at least one TAB character, the function assumes that the
           material is tab separated.  If every line contains a comma,
           comma-separated values (CSV) are assumed.  If not, lines
           are split at whitespace into fields.

           If there is no active region, this command creates an empty
           Org table.  But it's easier just to start typing, like
           @@info:@kbd{|Name|Phone|Age C-c @key{RET}}@@.

@@info:@subsubheading Re-aligning and field motion@@
- C-c C-c :: Re-align the table without moving the cursor.
- @@info:@key{TAB}@@ :: Re-align the table, move to the next field.
     Creates a new row if necessary.
- S-@@info:@key{TAB}@@ :: Re-align, move to previous field.
- @@info:@key{RET}@@ :: Re-align the table and move down to next row.
     Creates a new row if necessary.

@@info:@subsubheading Column and row editing@@
- M-@@info:@key{left}@@ :: @@info:@itemx M-@key{right}@@ 
                           Move the current column left/right.
- M-S-@@info:@key{left}@@ :: Kill the current column.
- M-S-@@info:@key{right}@@ :: Insert a new column to the left of the cursor
     position.
- M-@@info:@key{up}@@ :: @@info:@itemx M-@key{down}@@
                Move the current row up/down.
- M-S-@@info:@key{up}@@ :: Kill the current row or horizontal line.
- M-S-@@info:@key{down}@@ :: Insert a new row above the current row.
     With a prefix argument, the line is created below the current
     one.
- C-c - :: Insert a horizontal line below current row.  With a prefix
           argument, the line is created above the current line.
- C-c @@info:@key{RET}@@ :: Insert a horizontal line below current
     row, and move the cursor into the row below that line.
- C-c ^ :: Sort the table lines in the region.  The position of point
           indicates the column to be used for sorting, and the range
           of lines is the range between the nearest horizontal
           separator lines, or the entire table.

@@info:@noindent@@ *Further Reading*\\
[[http://orgmode.org/manual/Tables.html#Tables][Chapter 3 of the manual]]\\
[[http://orgmode.org/worg/org-tutorials/tables.php][Bastien's table tutorial]]\\
[[{http://orgmode.org/worg/org-tutorials/org-spreadsheet-intro.php][Bastien's spreadsheet tutorial]]\\
[[http://orgmode.org/worg/org-tutorials/org-plot.php][Eric's plotting tutorial]]

* Hyperlinks
:PROPERTIES:
:DESCRIPTION: Notes in context
:END:

Like HTML, Org provides links inside a file, external links to other
files, Usenet articles, emails, and much more.

** Link format
:PROPERTIES:
:DESCRIPTION: How links in Org are formatted
:END:

Org will recognize plain URL-like links and activate them as clickable
links.  The general link format, however, looks like this:

#+begin_src org
[[link][description]]       @r{or alternatively}           [[link]]
#+end_src

@@info:@noindent Once@@ a link in the buffer is complete (all brackets
present), Org will change the display so that
@@info:@samp{description}@@ is displayed instead of
@@info:@samp{[[link][description]]}@@ and @@info:@samp{link}@@ is displayed
instead of @@info:@samp{[[link]]}@@.  To edit the invisible
@@info:@samp{link}@@ part, use @@info:@kbd{C-c C-l}@@ with the cursor
on the link.

** Internal links
:PROPERTIES:
:DESCRIPTION: Links to other places in the current file
:END:

If the link does not look like a URL, it is considered to be internal
in the current file.  The most important case is a link like
@@info:@samp{[[#my-custom-id]]}@@ which will link to the entry with the
@@info:@code{CUSTOM_ID}@@ property @@info:@samp{my-custom-id}@@.

Links such as @@info:@samp{[[My Target]]}@@ or @@info:@samp{[[My Target][Find my
target]]}@@ lead to a text search in the current file for the
corresponding target which looks like @@info:@samp{<<My Target>>}@@.

** External links
:PROPERTIES:
:DESCRIPTION: URL-like links to the world
:END:

Org supports links to files, websites, Usenet and email messages, BBDB
database entries and links to both IRC conversations and their logs.
External links are URL-like locators.  They start with a short
identifying string followed by a colon.  There can be no space after
the colon.  Here are some examples:

: http://www.astro.uva.nl/~dominik          @r{on the web}
: file:/home/dominik/images/jupiter.jpg     @r{file, absolute path}
: /home/dominik/images/jupiter.jpg          @r{same as above}
: file:papers/last.pdf                      @r{file, relative path}
: file:projects.org                         @r{another Org file}
: docview:papers/last.pdf::NNN              @r{open file in doc-view mode at page NNN}
: id:B7423F4D-2E8A-471B-8810-C40F074717E9   @r{Link to heading by ID}
: news:comp.emacs                           @r{Usenet link}
: mailto:adent@@galaxy.net                   @r{Mail link}
: vm:folder                                 @r{VM folder link}
: vm:folder#id                              @r{VM message link}
: wl:folder#id                              @r{WANDERLUST message link}
: mhe:folder#id                             @r{MH-E message link}
: rmail:folder#id                           @r{RMAIL message link}
: gnus:group#id                             @r{Gnus article link}
: bbdb:R.*Stallman                          @r{BBDB link (with regexp)}
: irc:/irc.com/#emacs/bob                   @r{IRC link}
: info:org:External%20links                 @r{Info node link (with encoded space)}

A link should be enclosed in double brackets and may contain a
descriptive text to be displayed instead of the URL ([[Link format]]),
for example:

#+begin_src org
[[http://www.gnu.org/software/emacs/][GNU Emacs]]
#+end_src

@@info:@noindent If@@ the description is a file name or URL that
points to an image, HTML export ([[HTML export]]) will inline the
image as a clickable button.  If there is no description at all and
the link points to an image, that image will be inlined into the
exported HTML file.

** Handling links
:PROPERTIES:
:DESCRIPTION: Creating, inserting and following
:END:

Org provides methods to create a link in the correct syntax, to
insert it into an Org file, and to follow the link.

- C-c l :: Store a link to the current location.  This is a /global/
           command (you must create the key binding yourself) which
           can be used in any buffer to create a link.  The link will
           be stored for later insertion into an Org buffer (see
           below).
- C-c C-l :: Insert a link.  This prompts for a link to be inserted
             into the buffer.  You can just type a link, or use
             history keys @@info:@key{up}@@ and @@info:@key{down}@@ to
             access stored links.  You will be prompted for the
             description part of the link. When called with a
             @@info:@kbd{C-u}@@ prefix argument, file name completion
             is used to link to a file.
- C-c C-l @@info:@r{(with cursor on existing link)}@@ :: When the
     cursor is on an existing link, @@info:@kbd{C-c C-l}@@ allows you
     to edit the link and description parts of the link.
- C-c C-o @@info:@r{or}@@ mouse-1 @@info:@r{or}@@ mouse-2 :: Open link
     at point.
- C-c & :: Jump back to a recorded position.  A position is recorded
           by the commands following internal links, and by
           @@info:@kbd{C-c %}@@.  Using this command several times in
           direct succession moves through a ring of previously
           recorded positions.

** Targeted links
:PROPERTIES:
:DESCRIPTION: Point at a location in a file
:END:

File links can contain additional information to make Emacs jump to a
particular location in the file when following a link.  This can be a
line number or a search option after a double colon.

Here is the syntax of the different ways to attach a search to a file
link, together with an explanation:

: [[file:~/code/main.c::255]]                 @r{Find line 255}
: [[file:~/xx.org::My Target]]                @r{Find @samp{<<My Target>>}}
: [[file:~/xx.org::#my-custom-id]]            @r{Find entry with custom id}

@@info:@noindent@@ *Further Reading*
[[http://orgmode.org/manual/Hyperlinks.html#Hyperlinks][Chapter 4 of the manual]]

* TODO Items
:PROPERTIES:
:DESCRIPTION: Every tree branch can be a TODO item
:END:

Org mode does not maintain TODO lists as separate documents[fn:3].
Instead, TODO items are an integral part of the notes file, because
TODO items usually come up while taking notes!  With Org mode, simply
mark any entry in a tree as being a TODO item.  In this way,
information is not duplicated, and the entire context from which the
TODO item emerged is always present.

Of course, this technique for managing TODO items scatters them
throughout your notes file.  Org mode compensates for this by
providing methods to give you an overview of all the things that you
have to do.

** Using TODO states
:PROPERTIES:
:DESCRIPTION: Setting and switching states
:END:

Any headline becomes a TODO item when it starts with the word
@@info:@samp{TODO}@@, for example:

#+begin_src org
  ,*** TODO Write letter to Sam Fortune
#+end_src

@@info:@noindent
The@@ most important commands to work with TODO entries are:

- C-c C-t :: Rotate the TODO state of the current item among

             #+begin_example
               ,-> (unmarked) -> TODO -> DONE --.
               '--------------------------------'
             #+end_example

             The same rotation can also be done ``remotely'' from the
             timeline and agenda buffers with the @@info:@kbd{t}@@
             command key ([[Agenda commands]]).

- S-@@info:@key{right}@r{/}@key{left}@@ :: Select the
     following/preceding TODO state, similar to cycling.
- C-c / t :: View TODO items in a /sparse tree/ ([[Sparse trees]]).  Folds
             the buffer, but shows all TODO items and the headings
             hierarchy above them.
- C-c a t :: Show the global TODO list.  Collects the TODO items from
             all agenda files ([[Agenda Views]]) into a single buffer.
             [[Global TODO list]], for more information.
- S-M-@@info:@key{RET}@@ :: Insert a new TODO entry below the current
     one.

@@info:@noindent@@ Changing a TODO state can also trigger tag changes.
See the docstring of the option ~org-todo-state-tags-triggers~ for
details.

** Multi-state workflows
:PROPERTIES:
:DESCRIPTION: More than just on/off
:END:

You can use TODO keywords to indicate different /sequential/
states in the process of working on an item, for example:

#+begin_src emacs-lisp
  (setq org-todo-keywords
    '((sequence "TODO" "FEEDBACK" "VERIFY" "|" "DONE" "DELEGATED")))
#+end_src

The vertical bar separates the TODO keywords (states that /need
action/) from the DONE states (which need /no further action/).  If
you don't provide the separator bar, the last state is used as the
DONE state.  With this setup, the command @@info:@kbd{C-c C-t}@@ will
cycle an entry from TODO to FEEDBACK, then to VERIFY, and finally to
DONE and DELEGATED.

Sometimes you may want to use different sets of TODO keywords in
parallel.  For example, you may want to have the basic ~TODO~/~DONE~,
but also a workflow for bug fixing, and a separate state indicating
that an item has been canceled (so it is not DONE, but also does not
require action).  Your setup would then look like this:

#+begin_src emacs-lisp
  (setq org-todo-keywords
        '((sequence "TODO(t)" "|" "DONE(d)")
          (sequence "REPORT(r)" "BUG(b)" "KNOWNCAUSE(k)" "|" "FIXED(f)")
          (sequence "|" "CANCELED(c)")))
#+end_src

The keywords should all be different, this helps Org mode to keep
track of which subsequence should be used for a given entry.  The
example also shows how to define keys for fast access of a particular
state, by adding a letter in parenthesis after each keyword - you will
be prompted for the key after @@info:@kbd{C-c C-t}@@.

To define TODO keywords that are valid only in a single file, use the
following text anywhere in the file.

#+begin_src org
  ,#+TODO: TODO(t) | DONE(d)
  ,#+TODO: REPORT(r) BUG(b) KNOWNCAUSE(k) | FIXED(f)
  ,#+TODO: | CANCELED(c)
#+end_src

After changing one of these lines, use @@info:@kbd{C-c C-c}@@ with the
cursor still in the line to make the changes known to Org mode.

** Progress logging
:PROPERTIES:
:DESCRIPTION: Dates and notes for progress
:END:

Org mode can automatically record a timestamp and possibly a note when
you mark a TODO item as DONE, or even each time you change the state
of a TODO item.  This system is highly configurable, settings can be
on a per-keyword basis and can be localized to a file or even a
subtree.  For information on how to clock working time for a task, see
[[Clocking work time]].

*** Closing items
:PROPERTIES:
:DESCRIPTION: When was this entry marked DONE?
:END:

The most basic logging is to keep track of /when/ a certain TODO item
was finished.  This is achieved with[fn:4].

#+begin_src emacs-lisp
  (setq org-log-done 'time)
#+end_src

@@info:@noindent@@ Then each time you turn an entry from a TODO
(not-done) state into any of the DONE states, a line
@@info:@samp{CLOSED: [timestamp]}@@ will be inserted just after the
headline.  If you want to record a note along with the timestamp,
use[fn:5]

#+begin_src emacs-lisp
  (setq org-log-done 'note)
#+end_src

@@info:@noindent You@@ will then be prompted for a note, and that note
will be stored below the entry with a @@info:@samp{Closing Note}@@
heading.

*** Tracking TODO state changes
:PROPERTIES:
:DESCRIPTION:  When did the status change?
:END:

You might want to keep track of TODO state changes.  You can either record
just a timestamp, or a time-stamped note for a change.  These records will be
inserted after the headline as an itemized list.  When taking a lot of notes,
you might want to get the notes out of the way into a drawer.  Customize the
variable ~org-log-into-drawer~ to get this behavior.

For state logging, Org mode expects configuration on a per-keyword basis.
This is achieved by adding special markers @@info:@samp{!}@@ (for a timestamp) and
@@info:@samp{@@}@@ (for a note) in parentheses after each keyword.  For example:
#+begin_src org
  ,#+TODO: TODO(t) WAIT(w@@/!) | DONE(d!) CANCELED(c@@)
#+end_src
@@info:@noindent@@ will define TODO keywords and fast access keys, and
also request that a time is recorded when the entry is set to DONE,
and that a note is recorded when switching to WAIT or CANCELED.  The
same syntax works also when setting ~org-todo-keywords~.

** Priorities
:PROPERTIES:
:DESCRIPTION: Some things are more important than others
:END:

If you use Org mode extensively, you may end up with enough TODO items
that it starts to make sense to prioritize them.  Prioritizing can be
done by placing a /priority cookie/ into the headline of a TODO item,
like this

#+begin_src org
  ,*** TODO [#A] Write letter to Sam Fortune
#+end_src

@@info:@noindent@@ Org mode supports three priorities:
@@info:@samp{A}@@, @@info:@samp{B}@@, and @@info:@samp{C}@@.
@@info:@samp{A}@@ is the highest, @@info:@samp{B}@@ the default if
none is given.  Priorities make a difference only in the agenda.

- @@info:@kbd{C-c ,}@@ :: Set the priority of the current headline.
     Press @@info:@samp{A}@@, @@info:@samp{B}@@ or @@info:@samp{C}@@
     to select a priority, or @@info:@key{SPC}@@ to remove the cookie.
- S-@@info:@key{up}@@ :: @@info:@itemx S-@key{down}@@
     Increase/decrease priority of current headline

** Breaking down tasks
:PROPERTIES:
:DESCRIPTION: Splitting a task into manageable pieces
:END:

It is often advisable to break down large tasks into smaller, manageable
subtasks.  You can do this by creating an outline tree below a TODO item,
with detailed subtasks on the tree.  To keep the overview over the fraction
of subtasks that are already completed, insert either @@info:@samp{[/]}@@ or
@@info:@samp{[%]}@@ anywhere in the headline.  These cookies will be updated each time
the TODO status of a child changes, or when pressing @@info:@kbd{C-c C-c}@@ on the
cookie.  For example:

#+begin_src org
  ,* Organize Party [33%]
  ,** TODO Call people [1/2]
  ,*** TODO Peter
  ,*** DONE Sarah
  ,** TODO Buy food
  ,** DONE Talk to neighbor
#+end_src
** Checkboxes
:PROPERTIES:
:DESCRIPTION: Tick-off lists
:END:

Every item in a plain list ([[Plain lists]]) can be made into a checkbox
by starting it with the string @@info:@samp{[ ]}@@.  Checkboxes are
not included into the global TODO list, so they are often great to
split a task into a number of simple steps.  
Here is an example of a checkbox list.

#+begin_src org
  ,* TODO Organize party [1/3]
  ,  - [-] call people [1/2]
  ,    - [ ] Peter
  ,    - [X] Sarah
  ,  - [X] order food
  ,  - [ ] think about what music to play
#+end_src

Checkboxes work hierarchically, so if a checkbox item has children that
are checkboxes, toggling one of the children checkboxes will make the
parent checkbox reflect if none, some, or all of the children are
checked.

@@info:@noindent@@ The following commands work with checkboxes:

- C-c C-c :: Toggle checkbox status or (with prefix arg) checkbox
             presence at point.
- M-S-@@info:@key{RET}@@ :: Insert a new item with a checkbox.  This
     works only if the cursor is already in a plain list item ([[Plain lists]]).

@@info:@noindent@@ *Further Reading*\\
[[http://orgmode.org/manual/TODO-Items.html#TODO-Items][Chapter 5 of the manual]]\\
[[http://orgmode.org/worg/org-tutorials/orgtutorial_dto.php][David O'Toole's introductory tutorial]]\\
[[http://members.optusnet.com.au/~charles57/GTD/gtd_workflow.html][Charles Cave's GTD setup]]

* Tags
:PROPERTIES:
:DESCRIPTION: Tagging headlines and matching sets of tags
:END:

An excellent way to implement labels and contexts for
cross-correlating information is to assign /tags/ to headlines.  Org
mode has extensive support for tags.

Every headline can contain a list of tags; they occur at the end of
the headline.  Tags are normal words containing letters, numbers,
@@info:@samp{_}@@, and @@info:@samp{@@}@@.  Tags must be preceded and
followed by a single colon, e.g., @@info:@samp{:work:}@@.  Several
tags can be specified, as in @@info:@samp{:work:urgent:}@@.  Tags will
by default be in bold face with the same color as the headline.

** Tag inheritance
:PROPERTIES:
:DESCRIPTION: Tags use the tree structure of the outline
:END:

/Tags/ make use of the hierarchical structure of outline trees.  If a
heading has a certain tag, all subheadings will inherit the tag as
well.  For example, in the list

#+begin_src org
  ,* Meeting with the French group      :work:
  ,** Summary by Frank                  :boss:notes:
  ,*** TODO Prepare slides for him      :action:
#+end_src

@@info:@noindent@@
the final heading will have the tags @@info:@samp{:work:}@@, @@info:@samp{:boss:}@@,
@@info:@samp{:notes:}@@, and @@info:@samp{:action:}@@ even though the final heading is not
explicitly marked with those tags.  You can also set tags that all entries in
a file should inherit just as if these tags were defined in a hypothetical
level zero that surrounds the entire file.  Use a line like this[fn:6]:

#+begin_src org
  ,#+FILETAGS: :Peter:Boss:Secret:
#+end_src

** Setting tags
:PROPERTIES:
:DESCRIPTION: How to assign tags to a headline
:END:

Tags can simply be typed into the buffer at the end of a headline.
After a colon, @@info:@kbd{M-@key{TAB}}@@ offers completion on tags.
There is also a special command for inserting tags:

- C-c C-q :: Enter new tags for the current headline.  Org mode will
             either offer completion or a special single-key interface
             for setting tags, see below.  After pressing
             @@info:@key{RET}@@, the tags will be inserted and aligned
             to ~org-tags-column~.  When called with a
             @@info:@kbd{C-u}@@ prefix, all tags in the current buffer
             will be aligned to that column, just to make things look
             nice.
- C-c C-c :: When the cursor is in a headline, this does the same as
             @@info:@kbd{C-c C-q}@@.

Org will support tag insertion based on a /list of tags/.  By default
this list is constructed dynamically, containing all tags currently
used in the buffer.  You may also globally specify a hard list of tags
with the variable ~org-tag-alist~.  Finally you can set the default
tags for a given file with lines like

@smallexample
#+TAGS: @@work @@home @@tennisclub
#+TAGS: laptop car pc sailboat
@end smallexample

By default Org mode uses the standard minibuffer completion facilities
for entering tags.  However, it also implements another, quicker, tag
selection method called /fast tag selection/.  This allows you to
select and deselect tags with just a single key press.  For this to
work well you should assign unique letters to most of your commonly
used tags.  You can do this globally by configuring the variable
~org-tag-alist~ in your @@info:@file{.emacs}@@ file.  For example, you
may find the need to tag many items in different files with
@@info:@samp{:@@home:}@@.  In this case you can set something like:

#+begin_src emacs-lisp
(setq org-tag-alist '(("@@work" . ?w) ("@@home" . ?h) ("laptop" . ?l)))
#+end_src

@@info:@noindent@@ If the tag is only relevant to the file you are
working on, then you can instead set the TAGS option line as:

#+begin_src org
  ,#+TAGS: @@work(w)  @@home(h)  @@tennisclub(t)  laptop(l)  pc(p)
#+end_src

** Tag searches
:PROPERTIES:
:DESCRIPTION: Searching for combinations of tags
:END:

Once a system of tags has been set up, it can be used to collect related
information into special lists.

- C-c \ :: @@info:@itemx C-c / m@@ 
           Create a sparse tree with all headlines matching a tags
           search.  With a @@info:@kbd{C-u}@@ prefix argument, ignore
           headlines that are not a TODO line.

- C-c a m :: Create a global list of tag matches from all agenda
             files. [[Matching tags and properties]].
- C-c a M :: Create a global list of tag matches from all agenda
             files, but check only TODO items and force checking
             subitems (see variable ~org-tags-match-list-sublevels~).

These commands all prompt for a match string which allows basic
Boolean logic like @@info:@samp{+boss+urgent-project1}@@, to find
entries with tags @@info:@samp{boss}@@ and @@info:@samp{urgent}@@, but
not @@info:@samp{project1}@@, or @@info:@samp{Kathy|Sally}@@ to find
entries which are tagged, like @@info:@samp{Kathy}@@ or
@@info:@samp{Sally}@@.  The full syntax of the search string is rich
and allows also matching against TODO keywords, entry levels and
properties.  For a complete description with many examples, see
[[Matching tags and properties]].

@@info:@noindent@@ *Further Reading*\\
[[http://orgmode.org/manual/Tags.html#Tags][Chapter 6 of the manual]]\\
[[http://sachachua.com/wp/2008/01/tagging-in-org-plus-bonus-code-for-timeclocks-and-tags/][Sacha Chua's article about tagging in Org-mode]]

* Properties
:PROPERTIES:
:DESCRIPTION: Properties
:END:

Properties are key-value pairs associates with and entry.  They live
in a special drawer with the name ~PROPERTIES~.  Each property is
specified on a single line, with the key (surrounded by colons) first,
and the value after it:

#+begin_src org
  ,* CD collection
  ,** Classic
  ,*** Goldberg Variations
  ,    :PROPERTIES:
  ,    :Title:     Goldberg Variations
  ,    :Composer:  J.S. Bach
  ,    :Publisher: Deutsche Grammophon
  ,    :NDisks:    1
  ,    :END:
#+end_src

You may define the allowed values for a particular property
@@info:@samp{:Xyz:}@@ by setting a property @@info:@samp{:Xyz_ALL:}@@.
This special property is @@info:@emph{inherited}@@, so if you set it
in a level 1 entry, it will apply to the entire tree.  When allowed
values are defined, setting the corresponding property becomes easier
and is less prone to typing errors.  For the example with the CD
collection, we can predefine publishers and the number of disks in a
box like this:

#+begin_src org
  ,* CD collection
  ,  :PROPERTIES:
  ,  :NDisks_ALL:  1 2 3 4
  ,  :Publisher_ALL: "Deutsche Grammophon" Philips EMI
  ,  :END:
#+end_src
or globally using ~org-global-properties~, or file-wide like this:
#+begin_src org
  ,#+PROPERTY: NDisks_ALL 1 2 3 4
#+end_src

- C-c C-x p :: Set a property.  This prompts for a property name and a
               value.
- C-c C-c d :: Remove a property from the current entry.

To create sparse trees and special lists with selection based on
properties, the same commands are used as for tag searches ([[Tag%20searches][Tag searches]]).
The syntax for the search string is described in [[Matching%20tags%20and%20properties][Matching tags and properties]].

@@info:@noindent@@ *Further Reading*\\
[[http://orgmode.org/manual/Properties-and-Columns.html#Properties-and-Columns][Chapter 7 of the manual]]\\
[[http://orgmode.org/worg/org-tutorials/org-column-view-tutorial.php][Bastien Guerry's column view tutorial]]

* Dates and Times
:PROPERTIES:
:DESCRIPTION: Making items useful for planning
:END:

To assist project planning, TODO items can be labeled with a date and/or
a time.  The specially formatted string carrying the date and time
information is called a /timestamp/ in Org mode.

** Timestamps
:PROPERTIES:
:DESCRIPTION: Assigning a time to a tree entry
:END:

A timestamp is a specification of a date (possibly with a time or a
range of times) in a special format, either @@info:@samp{<2003-09-16
Tue>}@@ or @@info:@samp{<2003-09-16 Tue 09:39>}@@ or
@@info:@samp{<2003-09-16 Tue 12:00-12:30>}@@.  A timestamp can appear
anywhere in the headline or body of an Org tree entry.  Its presence
causes entries to be shown on specific dates in the agenda
([[Weekly/daily agenda]]).  We distinguish:

@@info:@noindent@@ *Plain timestamp; Event; Appointment*\\
A simple timestamp just assigns a date/time to an item.  This is just
like writing down an appointment or event in a paper agenda.

#+begin_src org
  ,* Meet Peter at the movies
  ,  <2006-11-01 Wed 19:15>
  ,* Discussion on climate change
  ,  <2006-11-02 Thu 20:00-22:00>
#+end_src

@@info:@noindent@@ *Timestamp with repeater interval*\\
A timestamp may contain a /repeater interval/, indicating that it
applies not only on the given date, but again and again after a
certain interval of N days (d), weeks (w), months (m), or years (y).
The following will show up in the agenda every Wednesday:
#+begin_src org
  ,* Pick up Sam at school
  ,  <2007-05-16 Wed 12:30 +1w>
#+end_src

@@info:@noindent@@ *Diary-style sexp entries*\\
For more complex date specifications, Org mode supports using the
special sexp diary entries implemented in the Emacs calendar/diary
package.  For example
#+begin_src org
  ,* The nerd meeting on every 2nd Thursday of the month
  ,  <%%(diary-float t 4 2)>
#+end_src

@@info:@noindent@@ *Time/Date range*\\
Two timestamps connected by @@info:@samp{--}@@ denote a range.
#+begin_src org
  ,** Meeting in Amsterdam
  ,   <2004-08-23 Mon>--<2004-08-26 Thu>
#+end_src

@@info:@noindent@@ *Inactive timestamp*\\
Just like a plain timestamp, but with square brackets instead of
angular ones.  These timestamps are inactive in the sense that they do
/not/ trigger an entry to show up in the agenda.

#+begin_src org
  ,* Gillian comes late for the fifth time
  ,  [2006-11-01 Wed]
#+end_src

** Creating timestamps
:PROPERTIES:
:DESCRIPTION: Commands which insert timestamps
:END:

For Org mode to recognize timestamps, they need to be in the specific
format.  All commands listed below produce timestamps in the correct
format.

- C-c . :: Prompt for a date and insert a corresponding timestamp.
           When the cursor is at an existing timestamp in the buffer,
           the command is used to modify this timestamp instead of
           inserting a new one.  When this command is used twice in
           succession, a time range is inserted.  With a prefix, also
           add the current time.
- C-c ! :: Like @@info:@kbd{C-c .}@@, but insert an inactive timestamp
           that will not cause an agenda entry.
- S-@@info:@key{left}@r{/}@key{right}@@ :: Change date at cursor by
     one day.
- S-@@info:@key{up}@r{/}@key{down}@@ :: Change the item under the
     cursor in a timestamp.  The cursor can be on a year, month, day,
     hour or minute.  When the timestamp contains a time range like
     @@info:@samp{15:30-16:30}@@, modifying the first time will also
     shift the second, shifting the time block with constant length.
     To change the length, modify the second time.

When Org mode prompts for a date/time, it will accept any string containing
some date and/or time information, and intelligently interpret the string,
deriving defaults for unspecified information from the current date and time.
You can also select a date in the pop-up calendar.  See the manual for more
information on how exactly the date/time prompt works.

** Deadlines and scheduling
:PROPERTIES:
:DESCRIPTION: Planning your work
:END:

A timestamp may be preceded by special keywords to facilitate planning:

@@info:@noindent@@ *DEADLINE*\
Meaning: the task (most likely a TODO item, though not necessarily) is supposed
to be finished on that date.

- C-c C-d :: Insert @@info:@samp{DEADLINE}@@ keyword along with a
             stamp, in the line following the headline.

On the deadline date, the task will be listed in the agenda.  In
addition, the agenda for /today/ will carry a warning about the
approaching or missed deadline, starting ~org-deadline-warning-days~
before the due date, and continuing until the entry is marked DONE.
An example:

#+begin_src org
  ,*** TODO write article about the Earth for the Guide
  ,    The editor in charge is [[bbdb:Ford Prefect]]
  ,    DEADLINE: <2004-02-29 Sun>
#+end_src

@@info:@noindent@@ *SCHEDULED*\\
Meaning: you are /planning to start working/ on that task on the given
date[fn:7].

- C-c C-s :: Insert @@info:@samp{SCHEDULED}@@ keyword along with a
             stamp, in the line following the headline.

The headline will be listed under the given date[fn:8].  In addition, a reminder that
the scheduled date has passed will be present in the compilation for
/today/, until the entry is marked DONE.  I.e.: the task will
automatically be forwarded until completed.

#+begin_src org
  ,*** TODO Call Trillian for a date on New Years Eve.
  ,    SCHEDULED: <2004-12-25 Sat>
#+end_src

Some tasks need to be repeated again and again.  Org mode helps to
organize such tasks using a so-called repeater in a DEADLINE,
SCHEDULED, or plain timestamp.  In the following example
#+begin_src org
  ,** TODO Pay the rent
  ,   DEADLINE: <2005-10-01 Sat +1m>
#+end_src
@@info:@noindent@@ the ~+1m~ is a repeater; the intended
interpretation is that the task has a deadline on <2005-10-01> and
repeats itself every (one) month starting from that time.

** Clocking work time
:PROPERTIES:
:DESCRIPTION: Tracking how long you spend on a task
:END:

Org mode allows you to clock the time you spend on specific tasks in a
project.

- C-c C-x C-i :: Start the clock on the current item (clock-in).  This
                 inserts the CLOCK keyword together with a timestamp.
                 When called with a @@info:@kbd{C-u}@@ prefix
                 argument, select the task from a list of recently
                 clocked tasks.
- C-c C-x C-o :: Stop the clock (clock-out).  This inserts another
                 timestamp at the same location where the clock was
                 last started.  It also directly computes the
                 resulting time in inserts it after the time range as
                 @@info:@samp{=> HH:MM}@@.
- C-c C-x C-e :: Update the effort estimate for the current clock
                 task.
- C-c C-x C-x :: Cancel the current clock.  This is useful if a clock
                 was started by mistake, or if you ended up working on
                 something else.
- C-c C-x C-j :: Jump to the entry that contains the currently running
                 clock.  With a @@info:@kbd{C-u}@@ prefix arg, select
                 the target task from a list of recently clocked
                 tasks.
- C-c C-x C-r :: Insert a dynamic block containing a clock report as
                 an Org-mode table into the current file.  When the
                 cursor is at an existing clock table, just update it.

                 #+begin_src org
                   ,#+BEGIN: clocktable :maxlevel 2 :emphasize nil :scope file
                   ,#+END: clocktable
                 #+end_src
                 @@info:@noindent@@ For details about how to customize
                 this view, see [[http://orgmode.org/manual/Clocking-work-time.html#Clocking-work-time][the manual]].
- C-c C-c :: Update dynamic block at point.  The cursor needs to be in
             the ~#+BEGIN~ line of the dynamic block.

The @@info:@kbd{l}@@ key may be used in the timeline ([[Timeline]]) and in
the agenda ([[Weekly/daily agenda]]) to show which tasks have been worked
on or closed during a day.

@@info:@noindent@@ *Further Reading*\\
[[http://orgmode.org/manual/Dates-and-Times.html#Dates-and-Times][Chapter 8 of the manual]]\\
[[http://members.optusnet.com.au/~charles57/GTD/org_dates/][Charles Cave's Date and Time tutorial]]\\
[[http://doc.norang.ca/org-mode.html#Clocking][Bernt Hansen's clocking workflow]]

* Capture - Refile - Archive
:PROPERTIES:
:DESCRIPTION: The ins and outs for projects
:END:

An important part of any organization system is the ability to quickly
capture new ideas and tasks, and to associate reference material with
them.  Org defines a capture process to create tasks.  It stores files
related to a task (/attachments/) in a special directory.  Once in the
system, tasks and projects need to be moved around.  Moving completed
project trees to an archive file keeps the system compact and fast.

** Capture
:PROPERTIES:
:DESCRIPTION: 
:END:

Org's method for capturing new items is heavily inspired by John
Wiegley excellent remember package.  It lets you store quick notes
with little interruption of your work flow.  Org lets you define
templates for new entries and associate them with different targets
for storing notes.

*** Setting up a capture location
:PROPERTIES:
:DESCRIPTION:   Where notes will be stored
:END:

The following customization sets a default target[fn:9] file for
notes, and defines a global key[fn:10] for capturing new stuff.

#+begin_src emacs-lisp
  (setq org-default-notes-file (concat org-directory "/notes.org"))
  (define-key global-map "\C-cc" 'org-capture)
#+end_src

*** Using capture
:PROPERTIES:
:DESCRIPTION: Commands to invoke and terminate capture
:END:

- C-c c :: Start a capture process.  You will be placed into a
           narrowed indirect buffer to edit the item.
- C-c C-c :: Once you are done entering information into the capture
             buffer, @@info:@kbd{C-c C-c}@@ will return you to the
             window configuration before the capture process, so that
             you can resume your work without further distraction.
- C-c C-w :: Finalize by moving the entry to a refile location
             ([[Refiling notes]]).
- C-c C-k :: Abort the capture process and return to the previous
             state.

*** Capture templates
:PROPERTIES:
:DESCRIPTION: Define the outline of different note types
:END:

You can use templates to generate different types of capture notes,
and to store them in different places.  For example, if you would like
to store new tasks under a heading @@info:@samp{Tasks}@@ in file
@@info:@file{TODO.org}@@, and journal entries in a date tree in
@@info:@file{journal.org}@@ you could use:

#+begin_src emacs-lisp
  (setq org-capture-templates
   '(("t" "Todo" entry (file+headline "~/org/gtd.org" "Tasks")
          "* TODO %?\n  %i\n  %a")
     ("j" "Journal" entry (file+datetree "~/org/journal.org")
          "* %?\nEntered on %U\n  %i\n  %a")))
#+end_src

@@info:@noindent@@ In these entries, the first string is the key to
reach the template, the second is a short description.  Then follows
the type of the entry and a definition of the target location for
storing the note.  Finally, the template itself, a string with
%-escapes to fill in information based on time and context.

When you call @@info:@kbd{M-x org-capture}@@, Org will prompt for a
key to select the template (if you have more than one template) and
then prepare the buffer like
#+begin_src org
  ,* TODO
  ,  [[file:@var{link to where you were when initiating capture}]]
#+end_src

@@info:@noindent@@ During expansion of the template, special
@@info:@kbd{%}@@-escapes[fn:11] allow dynamic insertion of content.
Here is a small selection of the possibilities, consult the manual for
more.

: %a          @r{annotation, normally the link created with @code{org-store-link}}
: %i          @r{initial content, the region when remember is called with C-u.}
: %t          @r{timestamp, date only}
: %T          @r{timestamp with date and time}
: %u, %U      @r{like the above, but inactive timestamps}

** Refiling notes
:PROPERTIES:
:DESCRIPTION: Moving a tree from one place to another
:END:
When reviewing the captured data, you may want to refile some of the entries
into a different list, for example into a project.  Cutting, finding the
right location, and then pasting the note is cumbersome.  To simplify this
process, you can use the following special command:

- C-c C-w :: Refile the entry or region at point.  This command offers
             possible locations for refiling the entry and lets you
             select one with completion.  The item (or all items in
             the region) is filed below the target heading as a
             subitem.\\ 
             By default, all level 1 headlines in the current buffer
             are considered to be targets, but you can have more
             complex definitions across a number of files. See the
             variable ~org-refile-targets~ for details.
- C-u C-c C-w :: Use the refile interface to jump to a heading.
- C-u C-u C-c C-w :: Jump to the location where ~org-refile~ last
     moved a tree to.

** Archiving
:PROPERTIES:
:DESCRIPTION: What to do with finished projects
:END:

When a project represented by a (sub)tree is finished, you may want to
move the tree out of the way and to stop it from contributing to the
agenda.  Archiving is important to keep your working files compact and
global searches like the construction of agenda views fast.  The most
common archiving action is to move a project tree to another file, the
archive file.

- C-c C-x C-a :: Archive the current entry using the command specified
                 in the variable ~org-archive-default-command~.
- C-c C-x C-s@@info:@ @r{or short} @@@ C-c $ :: Archive the subtree starting at
     the cursor position to the location given by
     ~org-archive-location~.

The default archive location is a file in the same directory as the
current file, with the name derived by appending
@@info:@file{_archive}@@ to the current file name.  For information
and examples on how to change this, see the documentation string of
the variable ~org-archive-location~.  There is also an in-buffer
option for setting this variable, for example

#+begin_src org
  ,#+ARCHIVE: %s_done::
#+end_src

@@info:@noindent@@ *Further Reading*\\
[[http://orgmode.org/manual/Capture-_002d-Refile-_002d-Archive.html#Capture-_002d-Refile-_002d-Archive][Chapter 9 of the manual]]\\
[[http://members.optusnet.com.au/~charles57/GTD/remember.html][Charles Cave's remember tutorial]]\\
[[http://orgmode.org/worg/org-tutorials/org-protocol-custom-handler.php][Sebastian Rose's tutorial for capturing from a web browser]]

* Agenda Views
:PROPERTIES:
:DESCRIPTION: Collecting information into views
:END:

Due to the way Org works, TODO items, time-stamped items, and tagged
headlines can be scattered throughout a file or even a number of
files.  To get an overview of open action items, or of events that are
important for a particular date, this information must be collected,
sorted and displayed in an organized way.  There are several different
views, see below.

The extracted information is displayed in a special /agenda buffer/.
This buffer is read-only, but provides commands to visit the
corresponding locations in the original Org files, and even to edit
these files remotely.  Remote editing from the agenda buffer means,
for example, that you can change the dates of deadlines and
appointments from the agenda buffer.  The commands available in the
Agenda buffer are listed in [[Agenda commands]].

** Agenda files
:PROPERTIES:
:DESCRIPTION: Files being searched for agenda information
:END:

The information to be shown is normally collected from all /agenda
files/, the files listed in the variable ~org-agenda-files~.

- C-c [ :: Add current file to the list of agenda files.  The file is
           added to the front of the list.  If it was already in the
           list, it is moved to the front.  With a prefix argument,
           file is added/moved to the end.
- C-c ] :: Remove current file from the list of agenda files.
- C-, :: Cycle through agenda file list, visiting one file after the
         other.

** Agenda dispatcher
:PROPERTIES:
:DESCRIPTION: Keyboard access to agenda views
:END:

The views are created through a dispatcher, which should be bound to a
global key---for example @@info:@kbd{C-c a}@@ ([[Installation]]).  After
pressing @@info:@kbd{C-c a}@@, an additional letter is required to execute a
command:

- a :: The calendar-like agenda ([[Weekly/daily agenda]]).

- t @@info:@r{/}@@ T :: A list of all TODO items ([[Global TODO list]]).

- m @@info:@r{/}@@ M :: A list of headlines matching a TAGS expression
     ([[Matching tags and properties]]).

- L :: The timeline view for the current buffer ([[Timeline]]).

- s :: A list of entries selected by a boolean expression of keywords
       and/or regular expressions that must or must not occur in the
       entry.

** Built-in agenda views
:PROPERTIES:
:DESCRIPTION: What is available out of the box?
:END:
*** Weekly/daily agenda
:PROPERTIES:
:DESCRIPTION: The calendar page with current tasks
:END:

The purpose of the weekly/daily /agenda/ is to act like a page of a
paper agenda, showing all the tasks for the current week or day.

- C-c a a :: Compile an agenda for the current week from a list of Org
             files.  The agenda shows the entries for each day.

Emacs contains the calendar and diary by Edward M. Reingold.  Org-mode
understands the syntax of the diary and allows you to use diary sexp
entries directly in Org files:

#+begin_src org
  ,* Birthdays and similar stuff
  ,#+CATEGORY: Holiday
  ,%%(org-calendar-holiday)   ; special function for holiday names
  ,#+CATEGORY: Ann
  ,%%(diary-anniversary  5 14 1956)@footnote{Note that the order of the arguments (month, day, year) depends on the setting of @code{calendar-date-style}.}Arthur Dent is %d years old
  ,%%(diary-anniversary 10  2 1869) Mahatma Gandhi would be %d years old
#+end_src

Org can interact with Emacs appointments notification facility.  To add all
the appointments of your agenda files, use the command
~org-agenda-to-appt~.  See the docstring for details.

*** Global TODO list
:PROPERTIES:
:DESCRIPTION: All unfinished action items
:END:

The global TODO list contains all unfinished TODO items formatted and
collected into a single place.  Remote editing of TODO items lets you
can change the state of a TODO entry with a single key press.  The commands
available in the TODO list are described in [[Agenda commands]].

- C-c a t :: Show the global TODO list.  This collects the TODO items
             from all agenda files ([[Agenda Views]]) into a single
             buffer.
- C-c a T :: Like the above, but allows selection of a specific TODO
             keyword.

*** Matching tags and properties
:PROPERTIES:
:DESCRIPTION:   Structured information with fine-tuned search
:END:

If headlines in the agenda files are marked with /tags/ ([[Tags]]), or
have properties ([[Properties]]), you can select headlines based on this
metadata and collect them into an agenda buffer.  The match syntax
described here also applies when creating sparse trees with
@@info:@kbd{C-c / m}@@.  The commands available in the tags list are
described in [[Agenda commands]].

- C-c a m :: Produce a list of all headlines that match a given set of
             tags.  The command prompts for a selection criterion,
             which is a boolean logic expression with tags, like
             @@info:@samp{+work+urgent-withboss}@@ or
             @@info:@samp{work|home}@@ ([[Tags]]).  If you often need a
             specific search, define a custom command for it ([[Agenda%20dispatcher][Agenda dispatcher]]).
- C-c a M :: Like @@info:@kbd{C-c a m}@@, but only select headlines
             that are also TODO items.

@@info:@subsubheading Match syntax@@

A search string can use Boolean operators @@info:@samp{&}@@ for AND
and @@info:@samp{|}@@ for OR.  @@info:@samp{&}@@ binds more strongly
than @@info:@samp{|}@@.  Parentheses are currently not implemented.
Each element in the search is either a tag, a regular expression
matching tags, or an expression like ~PROPERTY OPERATOR VALUE~ with a
comparison operator, accessing a property value.  Each element may be
preceded by @@info:@samp{-}@@, to select against it, and
@@info:@samp{+}@@ is syntactic sugar for positive selection.  The AND
operator @@info:@samp{&}@@ is optional when @@info:@samp{+}@@ or
@@info:@samp{-}@@ is present.  Here are some examples, using only
tags.

- +work-boss :: Select headlines tagged @@info:@samp{:work:}@@, but
                discard those also tagged @@info:@samp{:boss:}@@.
- work|laptop :: Selects lines tagged @@info:@samp{:work:}@@ or
                 @@info:@samp{:laptop:}@@.
- work|laptop+night :: Like before, but require the
     @@info:@samp{:laptop:}@@ lines to be tagged also
     @@info:@samp{:night:}@@.

You may also test for properties at the same
time as matching tags, see the manual for more information.

*** Timeline
:PROPERTIES:
:DESCRIPTION: Time-sorted view for single file
:END:

The timeline summarizes all time-stamped items from a single Org mode
file in a /time-sorted view/.  The main purpose of this command is
to give an overview over events in a project.

- C-c a L :: Show a time-sorted view of the Org file, with all
             time-stamped items. When called with a @@info:@kbd{C-u}@@
             prefix, all unfinished TODO entries (scheduled or not)
             are also listed under the current date.

*** Search view
:PROPERTIES:
:DESCRIPTION: Find entries by searching for text
:END:

This agenda view is a general text search facility for Org mode entries.
It is particularly useful to find notes.

- C-c a s :: This is a special search that lets you select entries by
             matching a substring or specific words using a boolean
             logic.

For example, the search string @@info:@samp{computer equipment}@@ will find entries
that contain @@info:@samp{computer equipment}@@ as a substring. 
Search view can also search for specific keywords in the entry, using Boolean
logic.  The search string @@info:@samp{+computer +wifi -ethernet -@{8\.11[bg]@}}@@
will search for note entries that contain the keywords ~computer~
and ~wifi~, but not the keyword ~ethernet~, and which are also
not matched by the regular expression ~8\.11[bg]~, meaning to
exclude both 8.11b and 8.11g. 

Note that in addition to the agenda files, this command will also search
the files listed in ~org-agenda-text-search-extra-files~.

** Agenda commands
:PROPERTIES:
:DESCRIPTION: Remote editing of Org trees
:END:

Entries in the agenda buffer are linked back to the Org file or diary
file where they originate.  Commands are provided to show and jump to the
original entry location, and to edit the Org files "remotely" from
the agenda buffer.  This is just a selection of the many commands, explore
the ~Agenda~ menu and the manual for a complete list.

@@info:@subsubheading Motion@@
- n :: Next line (same as @@info:@key{up}@@ and @@info:@kbd{C-p}@@).
- p :: Previous line (same as @@info:@key{down}@@ and
       @@info:@kbd{C-n}@@).

@@info:@subsubheading View/Go to Org file@@
- mouse-3 :: @@info:@itemx @key{SPC}@@ 
             Display the original location of the item in another
             window.  With prefix arg, make sure that the entire entry
             is made visible in the outline, not only the heading.
             # 
             @@info:@itemx @key{TAB}@@
             Go to the original location of the item in another
             window.  Under Emacs 22, @@info:@kbd{mouse-1}@@ will also
             work for this.
             # 
             @@info:@itemx @key{RET}@@
             Go to the original location of the item and delete other
             windows.

@@info:@subsubheading Change display@@
- o :: Delete other windows.
- d @@info:@r{/}@@ w :: Switch to day/week view.
- f @@info:@r{and}@@ b :: Go forward/backward in time to display the
     following ~org-agenda-current-span~ days.  For example, if the
     display covers a week, switch to the following/previous week.
- . :: Go to today.
- j :: Prompt for a date and go there.
- v l @@info:@r{or short}@@ l :: Toggle Logbook mode.  In Logbook
     mode, entries that were marked DONE while logging was on
     (variable ~org-log-done~) are shown in the agenda, as are
     entries that have been clocked on that day.  When called with a
     @@info:@kbd{C-u}@@ prefix, show all possible logbook entries, including
     state changes.
- r @@info:@r{or}@@ g :: Recreate the agenda buffer, to reflect the
     changes.
- s :: Save all Org buffers in the current Emacs session, and also the
       locations of IDs.

@@info:@subsubheading Secondary filtering and query editing@@
- / :: Filter the current agenda view with respect to a tag.  You are
       prompted for a letter to select a tag.  Press @@info:@samp{-}@@ first to
       select against the tag.
- \ :: Narrow the current agenda filter by an additional condition.

@@info:@subsubheading Remote editing (see the manual for many more commands)@@
- 0-9 :: Digit argument.
- t :: Change the TODO state of the item, in the agenda and in the org
       file.
- C-k :: Delete the current agenda item along with the entire subtree
         belonging to it in the original Org file.
- C-c C-w :: Refile the entry at point.
- C-c C-x C-a @@info:@r{or short}@@ a :: Archive the subtree
     corresponding to the entry at point using the default archiving
     command set in ~org-archive-default-command~.
- C-c C-x C-s @@info:@r{or short}@@ $ :: Archive the subtree
     corresponding to the current headline.
- C-c C-s :: Schedule this item, with prefix arg remove the scheduling
             timestamp
- C-c C-d :: Set a deadline for this item, with prefix arg remove the
             deadline.
- S-@@info:@key{right} @r{and} S-@key{left}@@ :: Change the timestamp
     associated with the current line by one day.
- I :: Start the clock on the current item.
- O / X :: Stop/cancel the previously started clock.
- J :: Jump to the running clock in another window.

** Custom agenda views
:PROPERTIES:
:DESCRIPTION: Defining special searches and views
:END:

The main application of custom searches is the definition of keyboard
shortcuts for frequently used searches, either creating an agenda
buffer, or a sparse tree (the latter covering of course only the
current buffer).
Custom commands are configured in the variable
~org-agenda-custom-commands~.  You can customize this variable, for
example by pressing @@info:@kbd{C-c a C}@@.  You can also directly set
it with Emacs Lisp in @@info:@file{.emacs}@@.  The following example
contains all valid search types:

#+begin_src emacs-lisp
(setq org-agenda-custom-commands
      '(("w" todo "WAITING")
        ("u" tags "+boss-urgent")
        ("v" tags-todo "+boss-urgent")))
#+end_src

@@info:@noindent@@ The initial string in each entry defines the keys
you have to press after the dispatcher command @@info:@kbd{C-c a}@@ in
order to access the command.  Usually this will be just a single
character.  The second parameter is the search type, followed by the
string or regular expression to be used for the matching.  The example
above will therefore define:

- C-c a w :: as a global search for TODO entries with
             @@info:@samp{WAITING}@@ as the TODO keyword
- C-c a u :: as a global tags search for headlines marked
             @@info:@samp{:boss:}@@ but not @@info:@samp{:urgent:}@@
- C-c a v :: as the same search as @@info:@kbd{C-c a u}@@, but
             limiting the search to headlines that are also TODO items

@@info:@noindent@@ *Further Reading*\\
[[http://orgmode.org/manual/Agenda-Views.html#Agenda-Views][Chapter 10 of the manual]]\\
[[http://orgmode.org/worg/org-tutorials/org-custom-agenda-commands.php][Mat Lundin's tutorial about custom agenda commands]]\\
[[http://www.newartisans.com/2007/08/using-org-mode-as-a-day-planner.html][John Wiegley's setup]]

* Markup
:PROPERTIES:
:DESCRIPTION: Prepare text for rich export
:END:

When exporting Org-mode documents, the exporter tries to reflect the
structure of the document as accurately as possible in the backend.  Since
export targets like HTML, LaTeX, or DocBook allow much richer formatting,
Org mode has rules on how to prepare text for rich export.  This section
summarizes the markup rules used in an Org-mode buffer.

** Structural markup elements
:PROPERTIES:
:DESCRIPTION: The basic structure as seen by the exporter
:END:

*** Document title
:PROPERTIES:
:DESCRIPTION: Where the title is taken from
:END:

@@info:@noindent@@ The title of the exported document is taken from
the special line

#+begin_src org
  ,#+TITLE: This is the title of the document
#+end_src

*** Headings and sections
:PROPERTIES:
:DESCRIPTION: The document structure as seen by the exporter
:END:

The outline structure of the document as described in [[Document%20Structure][Document Structure]],
forms the basis for defining sections of the exported document.
However, since the outline structure is also used for (for example)
lists of tasks, only the first three outline levels will be used as
headings.  Deeper levels will become itemized lists.  You can change
the location of this switch globally by setting the variable
~org-export-headline-levels~, or on a per-file basis with a line

#+begin_src org
  ,#+OPTIONS: H:4
#+end_src

*** Table of contents
:PROPERTIES:
:DESCRIPTION: The if and where of the table of contents
:END:

The table of contents is normally inserted directly before the first headline
of the file.

#+begin_src org
  ,#+OPTIONS: toc:2          (only to two levels in TOC)
  ,#+OPTIONS: toc:nil        (no TOC at all)
#+end_src 

*** Paragraphs
:PROPERTIES:
:DESCRIPTION: Paragraphs
:END:

Paragraphs are separated by at least one empty line.  If you need to enforce
a line break within a paragraph, use @@info:@samp{\\}@@ at the end of a line.

To keep the line breaks in a region, but otherwise use normal formatting, you
can use this construct, which can also be used to format poetry.

#+begin_src org
  ,#+BEGIN_VERSE
  , Great clouds overhead
  , Tiny black birds rise and fall
  , Snow covers Emacs
  
  ,     -- AlexSchroeder
  ,#+END_VERSE
#+end_src

When quoting a passage from another document, it is customary to format this
as a paragraph that is indented on both the left and the right margin.  You
can include quotations in Org-mode documents like this:

#+begin_src org
  ,#+BEGIN_QUOTE
  ,Everything should be made as simple as possible,
  ,but not any simpler -- Albert Einstein
  ,#+END_QUOTE
#+end_src

If you would like to center some text, do it like this:
#+begin_src org
  ,#+BEGIN_CENTER
  ,Everything should be made as simple as possible, \\
  ,but not any simpler
  ,#+END_CENTER
#+end_src

*** Emphasis and monospace
:PROPERTIES:
:DESCRIPTION: Bold, italic, etc.
:END:

You can make words @@info:@b{*bold*}@@, @@info:@i{/italic/}@@,
_underlined_, @@info:@code{=code=}@@ and @@info:@code{~verbatim~}@@,
and, if you must, @@info:@samp{+strike-through+}@@.  Text in the code
and verbatim string is not processed for Org-mode specific syntax, it
is exported verbatim.  To insert a horizontal rules, use a line
consisting of only dashes, and at least 5 of them.

*** Comment lines
:PROPERTIES:
:DESCRIPTION: What will *not* be exported
:END:

Lines starting with @@info:@samp{#}@@ in column zero are treated as
comments and will never be exported.  If you want an indented line to
be treated as a comment, start it with @@info:@samp{#+ }@@.  Also
entire subtrees starting with the word @@info:@samp{COMMENT}@@ will
never be exported.  Finally, regions surrounded by
@@info:@samp{#+BEGIN_COMMENT}@@ ... @@info:@samp{#+END_COMMENT}@@ will
not be exported.

- C-c ; :: Toggle the COMMENT keyword at the beginning of an entry.

** Images and tables
:PROPERTIES:
:DESCRIPTION: Tables and Images will be included
:END:

For Org mode tables, the lines before the first horizontal separator line
will become table header lines.  You can use the following lines somewhere
before the table to assign a caption and a label for cross references, and in
the text you can refer to the object with ~\ref{tab:basic-data}~:

#+begin_src org
  ,#+CAPTION: This is the caption for the next table (or link)
  ,#+LABEL:   tbl:basic-data
  ,   | ... | ...|
  ,   |-----|----|
#+end_src

Some backends (HTML, LaTeX, and DocBook) allow you to directly include
images into the exported document.  Org does this, if a link to an image
files does not have a description part, for example ~[[./img/a.jpg]]~.
If you wish to define a caption for the image and maybe a label for internal
cross references, you sure that the link is on a line by itself precede it
with:

#+begin_src org
  ,#+CAPTION: This is the caption for the next figure link (or table)
  ,#+LABEL:   fig:SED-HR4049
  ,[[./img/a.jpg]]
#+end_src

You may also define additional attributes for the figure.  As this is
backend-specific, see the sections about the individual backends for more
information.

** Literal examples
:PROPERTIES:
:DESCRIPTION: Source code examples with special formatting
:END:

You can include literal examples that should not be subjected to
markup.  Such examples will be typeset in monospace, so this is well suited
for source code and similar examples.

#+begin_src org
  ,#+BEGIN_EXAMPLE
  ,Some example from a text file.
  ,#+END_EXAMPLE
#+end_src

For simplicity when using small examples, you can also start the example
lines with a colon followed by a space.  There may also be additional
whitespace before the colon:

#+begin_src org
  ,Here is an example
  ,   : Some example from a text file.
#+end_src

For source code from a programming language, or any other text
that can be marked up by font-lock in Emacs, you can ask for it to
look like the fontified Emacs buffer

#+begin_example
  ,#+BEGIN_SRC emacs-lisp
  (defun org-xor (a b)
     "Exclusive or."
     (if a (not b) b))
  ,#+END_SRC
#+end_example

To edit the example in a special buffer supporting this language, use
@@info:@kbd{C-c '}@@ to both enter and leave the editing buffer.

** Include files
:PROPERTIES:
:DESCRIPTION: Include additional files into a document
:END:

During export, you can include the content of another file.  For example, to
include your @@info:@file{.emacs}@@ file, you could use:

#+begin_src org
  ,#+INCLUDE: "~/.emacs" src emacs-lisp
#+end_src
@@info:@noindent@@ The optional second and third parameter are the
markup (e.g.@@info:@: @samp{quote}@@, @@info:@samp{example}@@, or
@@info:@samp{src}@@), and, if the markup is @@info:@samp{src}@@, the
language for formatting the contents.  The markup is optional, if it
is not given, the text will be assumed to be in Org mode format and
will be processed normally. @@info:@kbd{C-c '}@@ will visit the
included file.

** Embedded LaTeX
:PROPERTIES:
:DESCRIPTION: LaTeX can be freely used inside Org documents
:END:

For scientific notes which need to be able to contain mathematical
symbols and the occasional formula, Org-mode supports embedding LaTeX
code into its files.  You can directly use TeX-like macros for special
symbols, enter formulas and entire LaTeX environments.

#+begin_src org
  ,Angles are written as Greek letters \alpha, \beta and \gamma.  The mass if
  ,the sun is M_sun = 1.989 x 10^30 kg.  The radius of the sun is R_@{sun@} =
  ,6.96 x 10^8 m.  If $a^2=b$ and $b=2$, then the solution must be either
  ,$a=+\sqrt@{2@}$ or $a=-\sqrt@{2@}$.
  
  ,\begin@{equation@}
  ,x=\sqrt@{b@}
  ,\end@{equation@}
#+end_src

@@info:@noindent@@ With [[http://orgmode.org/manual/LaTeX-fragments.html#LaTeX-fragments][special setup]], LaTeX snippets will be included as images when exporting to HTML.

@@info:@noindent@@ *Further Reading*\\
[[http://orgmode.org/manual/Markup.html#Markup][Chapter 11 of the manual]]

* Exporting
:PROPERTIES:
:DESCRIPTION: Sharing and publishing of notes
:END:

Org-mode documents can be exported into a variety of other formats: ASCII
export for inclusion into emails, HTML to publish on the web, LaTeX/PDF
for beautiful printed documents and DocBook to enter the world of many other
formats using DocBook tools.  There is also export to iCalendar format so
that planning information can be incorporated into desktop calendars.

** Export options
:PROPERTIES:
:DESCRIPTION: Per-file export settings
:END:

The exporter recognizes special lines in the buffer which provide
additional information.  These lines may be put anywhere in the file.
The whole set of lines can be inserted into the buffer with
@@info:@kbd{C-c C-e t}@@.

- C-c C-e t :: Insert template with export options, see example below.

: #+TITLE:       the title to be shown (default is the buffer name)
: #+AUTHOR:      the author (default taken from @code{user-full-name})
: #+DATE:        a date, fixed, of a format string for @code{format-time-string}
: #+EMAIL:       his/her email address (default from @code{user-mail-address})
: #+DESCRIPTION: the page description, e.g.@: for the XHTML meta tag
: #+KEYWORDS:    the page keywords, e.g.@: for the XHTML meta tag
: #+LANGUAGE:    language for HTML, e.g.@: @samp{en} (@code{org-export-default-language})
: #+TEXT:        Some descriptive text to be inserted at the beginning.
: #+TEXT:        Several lines may be given.
: #+OPTIONS:     H:2 num:t toc:t \n:nil @@:t ::t |:t ^:t f:t TeX:t ...
: #+LINK_UP:     the ``up'' link of an exported page
: #+LINK_HOME:   the ``home'' link of an exported page
: #+LATEX_HEADER: extra line(s) for the @LaTeX{} header, like \usepackage@{xyz@}

** The export dispatcher
:PROPERTIES:
:DESCRIPTION: How to access exporter commands
:END:

All export commands can be reached using the export dispatcher, which
is a prefix key that prompts for an additional key specifying the
command.  Normally the entire file is exported, but if there is an
active region that contains one outline tree, the first heading is
used as document title and the subtrees are exported.

- C-c C-e :: Dispatcher for export and publishing commands.

** ASCII/Latin-1/UTF-8 export
:PROPERTIES:
:DESCRIPTION: Exporting to flat files with encoding
:END:

ASCII export produces a simple and very readable version of an
Org-mode file, containing only plain ASCII.  Latin-1 and UTF-8 export
augment the file with special characters and symbols available in
these encodings.

- C-c C-e a :: Export as ASCII file.
- C-c C-e n @@info:@ @ @r{and} @ @@@ C-c C-e N :: Like the above
     commands, but use Latin-1 encoding.
- C-c C-e u @@info:@ @ @r{and} @ @@@ C-c C-e U :: Like the above
     commands, but use UTF-8 encoding.

** HTML export
:PROPERTIES:
:DESCRIPTION: Exporting to HTML
:END:

- C-c C-e h :: Export as HTML file @@info:@file{myfile.html}@@.
- C-c C-e b :: Export as HTML file and immediately open it with a
               browser.

To insert HTML that should be copied verbatim to the exported file use
either

#+begin_src org
#+HTML: Literal HTML code for export
#+end_src
@@info:@noindent@@ or
#+begin_src org
#+BEGIN_HTML
All lines between these markers are exported literally
#+END_HTML
#+end_src

** LaTeX and PDF export
:PROPERTIES:
:DESCRIPTION: Exporting to LaTeX, and processing to PDF
:END:

- C-c C-e l :: Export as LaTeX file @@info:@file{myfile.tex}@@.
- C-c C-e p :: Export as LaTeX and then process to PDF.
- C-c C-e d :: Export as LaTeX and then process to PDF, then open the
               resulting PDF file.

By default, the LaTeX output uses the class ~article~.  You can
change this by adding an option like ~#+LaTeX_CLASS: myclass~ in your
file.  The class must be listed in ~org-export-latex-classes~.

Embedded LaTeX as described in [[Embedded LaTeX]], will be correctly
inserted into the LaTeX file.  Similarly to the HTML exporter, you can use
~#+LaTeX:~ and ~#+BEGIN_LaTeX ... #+END_LaTeX~ construct to add
verbatim LaTeX code.

** DocBook export
:PROPERTIES:
:DESCRIPTION: Exporting to DocBook
:END:

- C-c C-e D :: Export as DocBook file.

Similarly to the HTML exporter, you can use ~#+DOCBOOK:~ and
~#+BEGIN_DOCBOOK ... #+END_DOCBOOK~ construct to add verbatim LaTeX
code.

** iCalendar export
:PROPERTIES:
:DESCRIPTION: 
:END:

- C-c C-e i :: Create iCalendar entries for the current file in a
               @@info:@file{.ics}@@ file.
- C-c C-e c :: Create a single large iCalendar file from all files in
               ~org-agenda-files~ and write it to the file given
               by ~org-combined-agenda-icalendar-file~.

@@info:@noindent@@ *Further Reading*\\
[[http://orgmode.org/manual/Exporting.html#Exporting][Chapter 12 of the manual]]\\
[[http://orgmode.org/worg/org-tutorials/images-and-xhtml-export.php][Sebastian Rose's image handling tutorial]]\\
[[http://orgmode.org/worg/org-tutorials/org-latex-export.php][Thomas Dye's LaTeX export tutorial]]\\
[[http://orgmode.org/worg/org-tutorials/org-beamer/tutorial.php][Eric Fraga's BEAMER presentation tutorial]]

* Publishing
:PROPERTIES:
:DESCRIPTION: Create a web site of linked Org files
:END:


Org includes a publishing management system that allows you to configure
automatic HTML conversion of /projects/ composed of interlinked org
files.  You can also configure Org to automatically upload your exported HTML
pages and related attachments, such as images and source code files, to a web
server.  For detailed instructions about setup, see the manual.

Here is an example:

#+begin_src emacs-lisp
  (setq org-publish-project-alist
        '(("org"
           :base-directory "~/org/"
           :publishing-directory "~/public_html"
           :section-numbers nil
           :table-of-contents nil
           :style "<link rel=\"stylesheet\"
                  href=\"../other/mystyle.css\"
                  type=\"text/css\"/>")))
#+end_src

- C-c C-e C :: Prompt for a specific project and publish all files
               that belong to it.
- C-c C-e P :: Publish the project containing the current file.
- C-c C-e F :: Publish only the current file.
- C-c C-e E :: Publish every project.

Org uses timestamps to track when a file has changed.  The above functions
normally only publish changed files.  You can override this and force
publishing of all files by giving a prefix argument to any of the commands
above.

@@info:@noindent@@ *Further Reading*
[[http://orgmode.org/manual/Publishing.html#Publishing][Chapter 13 of the manual]]\\
[[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][Sebastian Rose's publishing tutorial]]\\
[[http://orgmode.org/worg/org-tutorials/org-jekyll.php][Ian Barton's Jekyll/blogging setup]]

* Working With Source Code
:PROPERTIES:
:DESCRIPTION: Source code snippets embedded in Org
:END:

Org-mode provides a number of features for working with source code,
including editing of code blocks in their native major-mode,
evaluation of code blocks, tangling of code blocks, and exporting code
blocks and their results in several formats.

@@info:@subheading Structure of Code Blocks@@
The structure of code blocks is as follows:

: #+NAME: <name>
: #+BEGIN_SRC <language> <switches> <header arguments>
:   <body>
: #+END_SRC


Where ~<name>~ is a string used to name the code block, ~<language>~
specifies the language of the code block (e.g.: ~emacs-lisp~, ~shell~,
~R~, ~python~, etc...), ~<switches>~ can be used to control export of
the code block, ~<header arguments>~ can be used to control many
aspects of code block behavior as demonstrated below, and ~<body>~
contains the actual source code.

@@info:@subheading Editing source code@@
Use @@info:@kbd{C-c '}@@ to edit the current code block.  This brings
up a language major-mode edit buffer containing the body of the code
block.  Saving this buffer will write the new contents back to the Org
buffer.  Use @@info:@kbd{C-c '}@@ again to exit the edit buffer.

@@info:@subheading Evaluating code blocks@@
Use @@info:@kbd{C-c C-c}@@ to evaluate the current code block and
insert its results in the Org-mode buffer.  By default, evaluation is
only turned on for ~emacs-lisp~ code blocks, however support exists
for evaluating blocks in many languages.  For a complete list of
supported languages see the manual.  The following shows a code block
and its results.

: #+BEGIN_SRC emacs-lisp
:   (+ 1 2 3 4)
: #+END_SRC
:  
: #+RESULTS:
: : 10

@@info:@subheading Extracting source code@@
Use @@info:@kbd{C-c C-v t}@@ to create pure source code files by
extracting code from source blocks in the current buffer.  This is
referred to as "tangling"---a term adopted from the literate
programming community.  During "tangling" of code blocks their bodies
are expanded using ~org-babel-expand-src-block~ which can expand both
variable and "noweb" style references.  In order to tangle a code
block it must have a ~:tangle~ header argument, see the manual for
details.

@@info:@subheading Library of Babel@@
Use @@info:@kbd{C-c C-v l}@@ to load the code blocks from an Org-mode
files into the "Library of Babel", these blocks can then be evaluated
from any Org-mode buffer.  A collection of generally useful code
blocks is distributed with Org-mode in ~contrib/library-of-babel.org~.

@@info:@subheading Header Arguments@@
Many aspects of the evaluation and export of code blocks are
controlled through header arguments.  These can be specified globally,
at the file level, at the outline subtree level, and at the individual
code block level.  The following describes some of the header
arguments.

- ~:var~ :: The ~:var~ header argument is used to pass arguments to
            code blocks.  The values passed to arguments can be
            literal values, values from org-mode tables and literal
            example blocks, or the results of other named code blocks.
- ~:results~ :: The ~:results~ header argument controls the
                /collection/, /type/, and /handling/ of code block
                results.  Values of ~output~ or ~value~ (the default)
                specify how results are collected from a code block's
                evaluation.  Values of ~vector~, ~scalar~ ~file~ ~raw~
                ~html~ ~latex~ and ~code~ specify the type of the
                results of the code block which dictates how they will
                be incorporated into the Org-mode buffer.  Values of
                ~silent~, ~replace~, ~prepend~, and ~append~ specify
                handling of code block results, specifically if and
                how the results should be inserted into the Org-mode
                buffer.
- ~:session~ :: A header argument of ~:session~ will cause the code
                block to be evaluated in a persistent interactive
                inferior process in Emacs.  This allows for persisting
                state between code block evaluations, and for manual
                inspection of the results of evaluation.
- ~:exports~ :: Any combination of the /code/ or the /results/ of a
                block can be retained on export, this is specified by
                setting the ~:results~ header argument to ~code~
                ~results~ ~none~ or ~both~.
- ~:tangle~ :: A header argument of ~:tangle yes~ will cause a code
               block's contents to be tangled to a file named after
               the filename of the Org-mode buffer.  An alternate file
               name can be specified with ~:tangle filename~.
- ~:cache~ :: A header argument of ~:cache yes~ will cause associate a
              hash of the expanded code block with the results,
              ensuring that code blocks are only re-run when their
              inputs have changed.
- ~:noweb~ :: A header argument of ~:noweb yes~ will expand "noweb"
              style references on evaluation and tangling.
- ~:file~ :: Code blocks which output results to files (e.g.: graphs,
             diagrams and figures) can accept a ~:file filename~
             header argument in which case the results are saved to
             the named file, and a link to the file is inserted into
             the Org-mode buffer.

@@info:@noindent@@ *Further Reading*\\
[[http://orgmode.org/manual/Literal-examples.html#Literal-examples][Chapter 11.3 of the manual]]\\
[[http://orgmode.org/worg/org-contrib/babel/index.php][The Babel site on Worg]]

* Miscellaneous
:PROPERTIES:
:DESCRIPTION: All the rest which did not fit elsewhere
:END:

** Completion
:PROPERTIES:
:DESCRIPTION: M-TAB knows what you need
:END:

Org supports in-buffer completion with @@info:@kbd{M-@key{TAB}}@@.  This type of
completion does not make use of the minibuffer.  You simply type a few
letters into the buffer and use the key to complete text right there.  For
example, this command will complete TeX symbols after @@info:@samp{\}@@, TODO
keywords at the beginning of a headline, and tags after @@info:@samp{:}@@ in a
headline.

** Clean view
:PROPERTIES:
:DESCRIPTION: Getting rid of leading stars in the outline
:END:

Some people find it noisy and distracting that the Org headlines start with a
potentially large number of stars, and that text below the headlines is not
indented.  While this is no problem when writing a /book-like/ document
where the outline headings are really section headings, in a more
/list-oriented/ outline, indented structure is a lot cleaner:

: * Top level headline             |    * Top level headline
: ** Second level                  |      * Second level
: *** 3rd level                    |        * 3rd level
: some text                        |          some text
: *** 3rd level                    |        * 3rd level
: more text                        |          more text
: * Another top level headline     |    * Another top level headline

@@info:@noindent@@ If you are using at least Emacs 23.1.50.3 and
version 6.29 of Org, this kind of view can be achieved dynamically at
display time using ~org-indent-mode~, which will prepend
intangible space to each line.  You can turn on ~org-indent-mode~
for all files by customizing the variable ~org-startup-indented~,
or you can turn it on for individual files using

#+begin_src org
  ,#+STARTUP: indent
#+end_src

If you want a similar effect in earlier version of Emacs and/or Org,
or if you want the indentation to be hard space characters so that the
plain text file looks as similar as possible to the Emacs display, Org
supports you by helping to indent (with @@info:@key{TAB}@@) text below
each headline, by hiding leading stars, and by only using levels 1, 3,
etc to get two characters indentation for each level.  To get this
support in a file, use

#+begin_src org
  ,#+STARTUP: hidestars odd
#+end_src

** MobileOrg
:PROPERTIES:
:DESCRIPTION: Org-mode on the iPhone
:END:

/MobileOrg/ is the name of the mobile companion app for Org mode, currently
available for iOS and for Android.  /MobileOrg/ offers offline viewing and
capture support for an Org mode system rooted on a "real" computer.  It
does also allow you to record changes to existing entries.

The [[http://mobileorg.ncogni.to/][iOS implementation]] for the
/iPhone/iPod Touch/iPad/ series of devices, was developed by Richard
Moreland. Android users should check out [[http://wiki.github.com/matburt/mobileorg-android/][MobileOrg Android]] by Matt
Jones.  The two implementations are not identical but offer similar
features.

@@info:@noindent@@ *Further Reading*\\
[[http://orgmode.org/manual/Miscellaneous.html#Miscellaneous][Chapter 15 of the manual]]\\
[[http://orgmode.org/manual/MobileOrg.html#MobileOrg][Appendix B of the manual]]\\
[[http://orgmode.org/orgcard.pdf][Key reference card]]

* Footnotes
:PROPERTIES:
:DESCRIPTION: How footnotes are defined in Org's syntax
:END:

[fn:1] See the variable ~org-special-ctrl-a/e~ to configure special
behavior of @@info:@kbd{C-a}@@ and @@info:@kbd{C-e}@@ in headlines.

[fn:2] If you do not want the line to be split, customize the variable
~org-M-RET-may-split-line~.

[fn:3] Of course, you can make a document that contains only long
lists of TODO items, but this is not required.

[fn:4] The corresponding in-buffer setting is: ~#+STARTUP: logdone~

[fn:5] The corresponding in-buffer setting is: ~#+STARTUP:
lognotedone~

[fn:6] As with all these in-buffer settings, pressing @@info:@kbd{C-c
C-c}@@ activates any changes in the line.

[fn:7] This is quite different from what is normally understood by
/scheduling a meeting/, which is done in Org-mode by just inserting a
time stamp without keyword.

[fn:8] It will still be listed on that date after it has been marked
DONE.  If you don't like this, set the variable
~org-agenda-skip-scheduled-if-done~.

[fn:9] Using capture templates, you can define more fine-grained
capture locations, see [[Capture templates]].

[fn:10] Please select your own key, @@info:@kbd{C-c c}@@ is only a suggestion.

[fn:11] If you need one of these sequences literally, escape the
@@info:@kbd{%}@@ with a backslash.

[fn:12] See also the variables ~org-show-hierarchy-above~,
~org-show-following-heading~, ~org-show-siblings~, and
~org-show-entry-below~ for detailed control on how much context is
shown around each match.

^ permalink raw reply	[relevance 1%]

* Export to Texinfo
@ 2012-07-20  0:29  1% Jonathan Leech-Pepin
    0 siblings, 1 reply; 59+ results
From: Jonathan Leech-Pepin @ 2012-07-20  0:29 UTC (permalink / raw)
  To: Org Mode Mailing List

[-- Attachment #1: Type: text/plain, Size: 3558 bytes --]

Hello all,

Over the last few days I've been working on implementing an Org ->
Texinfo exporter based on the new e-latex exporter.

It is not yet able to generate all the expected contents for export
towards an Info file, however it does create enough to successfully
export and read through Info.

Current it can do the following:
- Create the initial preamble.
- Create the menu and detailed menus in the =@top= node.
- Create the menus within each node for child menus.
- Descriptions for menus are pulled from the :DESCRIPTION: property of
  the headline.
- Convert *bold*, /italic/, ~verbatim~ and =code= markup to @strong{},
  @emph{}, @verb{} and @code{} respectively.
- Convert lisp code blocks to @lisp and other code blocks to @example.
- Create ordered and unordered lists.
- Turn descriptive lists into @table.
- Export verbatim tables to @verbatim blocks.
- Export standard tables as @multitable, using the largest cell in
  each column to define the output (outputs a string of a's equal to
  the lengths).
- Exports comments and comment blocks
- Exports Quote and example blocks, including labels for quotes.
- Footnotes are generated inline using @footnote{}.
- The copyright (@copying) section can be created by generating a
  headline with the property :copying: set to t (or any non-nil
  value).  It will be exported at the correct place in the .texi file
  and will not be duplicated in the tree.  Children of this headline
  will export within the block, so I would recommend not including any
  (it will likely result in a very odd section and errors in
  makeinfo).
- Export to .texi (org-e-texinfo-export-to-texinfo) and compile to
  info (org-e-texinfo-export-to-info).  It will not however provide an
  error buffer if it fails. That is also on the list of additions.


It will not do the following:
- Export table.el tables, they are currently being exported using the
  e-latex code, so they will cause issues with makeinfo.  I do plan to
  look at that in the future
- There is no provision for indices, limiting usefulness in
  cross-referencing.
- Additionally descriptive lists cannot be exported to @ftable or
  @vtable
- Sub and super-scripts are still being exported via latex processing.
  This likely will also fail in makeinfo.
- There is no #+attr_texinfo or #+TEXINFO: for arbitrary snippets or
  for passing features to tables/blocks.  I'm not sure exactly how to
  hook these in and would need a pointer in the right direction to do
  so.
- While looking over the reference document for the new exporter I
  realized I could likely use pre- and post- processing hooks to
  simplify some of the export process.  I have to look into this as
  well.
- The largest issue perhaps: There is no method to create @kbd{} and
  @key{} commands on export.  If anyone has any suggestions how these
  might be achieved (perhaps looking for a prefix in =code=?) I would
  greatly appreciate it.

There are a few limitations to what will successfully be exported:
- Headlines cannot contain any of the following symbols: periods,
  commas, colons or parentheses.  This is a limitation of texinfo and
  will result in errors when running makeinfo.  Semi-colons will
  export however.
- Headlines cannot contain markup or links.  Once again these are
  forbidden in texinfo and will cause failures.
- I've currently only been looking at creating valid info output,
  output to PDF or HTML via makeinfo may fail.

It can also be found at
https://github.com/jleechpe/org-mode/blob/texinfo/contrib/lisp/org-e-texinfo.el

Regards,

Jon

[-- Attachment #2: org-e-texinfo.el --]
[-- Type: application/octet-stream, Size: 61103 bytes --]

;;; org-e-texinfo.el --- Texinfo Back-End For Org Export Engine

;; Author: Jonathan Leech-Pepin <jonathan.leechpepin at gmail dot com
;; Keywords: outlines, hypermedia, calendar, wp

;; This program is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.

;; This program is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;; GNU General Public License for more details.

;; You should have received a copy of the GNU General Public License
;; along with this program.  If not, see <http://www.gnu.org/licenses/>.

;;; Commentary:
;;
;; This library implements a Texinfo back-end for Org generic exporter.
;;
;; To test it, run
;;
;;   M-: (org-export-to-buffer 'e-texinfo "*Test e-texinfo*") RET
;;
;; in an org-mode buffer then switch to the buffer to see the Texinfo
;; export.  See contrib/lisp/org-export.el for more details on how
;; this exporter works.
;;
;; It introduces five new buffer keywords: "TEXINFO_CLASS",
;; "TEXINFO_FILENAME", "TEXINFO_HEADER", "SUBTITLE" and "SUBAUTHOR".

;;; Code:

(eval-when-compile (require 'cl))
(require 'org-export)

(defvar orgtbl-exp-regexp)

\f
;;; Define Back-End

(defvar org-e-texinfo-translate-alist
  '((babel-call . org-e-texinfo-babel-call)
    (bold . org-e-texinfo-bold)
    (center-block . org-e-texinfo-center-block)
    (clock . org-e-texinfo-clock)
    (code . org-e-texinfo-code)
    (comment . org-e-texinfo-comment)
    (comment-block . org-e-texinfo-comment-block)
    (drawer . org-e-texinfo-drawer)
    (dynamic-block . org-e-texinfo-dynamic-block)
    (entity . org-e-texinfo-entity)
    (example-block . org-e-texinfo-example-block)
    (export-block . org-e-texinfo-export-block)
    (export-snippet . org-e-texinfo-export-snippet)
    (fixed-width . org-e-texinfo-fixed-width)
    (footnote-definition . org-e-texinfo-footnote-definition)
    (footnote-reference . org-e-texinfo-footnote-reference)
    (headline . org-e-texinfo-headline)
    (horizontal-rule . org-e-texinfo-horizontal-rule)
    (inline-babel-call . org-e-texinfo-inline-babel-call)
    (inline-src-block . org-e-texinfo-inline-src-block)
    (inlinetask . org-e-texinfo-inlinetask)
    (italic . org-e-texinfo-italic)
    (item . org-e-texinfo-item)
    (keyword . org-e-texinfo-keyword)
    (latex-environment . org-e-texinfo-latex-environment)
    (latex-fragment . org-e-texinfo-latex-fragment)
    (line-break . org-e-texinfo-line-break)
    (link . org-e-texinfo-link)
    (macro . org-e-texinfo-macro)
    (paragraph . org-e-texinfo-paragraph)
    (plain-list . org-e-texinfo-plain-list)
    (plain-text . org-e-texinfo-plain-text)
    (planning . org-e-texinfo-planning)
    (property-drawer . org-e-texinfo-property-drawer)
    (quote-block . org-e-texinfo-quote-block)
    (quote-section . org-e-texinfo-quote-section)
    (radio-target . org-e-texinfo-radio-target)
    (section . org-e-texinfo-section)
    (special-block . org-e-texinfo-special-block)
    (src-block . org-e-texinfo-src-block)
    (statistics-cookie . org-e-texinfo-statistics-cookie)
    (strike-through . org-e-texinfo-strike-through)
    (subscript . org-e-texinfo-subscript)
    (superscript . org-e-texinfo-superscript)
    (table . org-e-texinfo-table)
    (table-cell . org-e-texinfo-table-cell)
    (table-row . org-e-texinfo-table-row)
    (target . org-e-texinfo-target)
    (template . org-e-texinfo-template)
    (timestamp . org-e-texinfo-timestamp)
    (underline . org-e-texinfo-underline)
    (verbatim . org-e-texinfo-verbatim)
    (verse-block . org-e-texinfo-verse-block))
  "Alist between element or object types and translators.")

(defconst org-e-texinfo-options-alist
  '((:texinfo-filename "TEXINFO_FILENAME" nil org-e-texinfo-filename t)
    (:texinfo-class "TEXINFO_CLASS" nil org-e-texinfo-default-class t)
    (:texinfo-header "TEXINFO_HEADER" nil nil newline)
    (:subtitle "SUBTITLE" nil nil newline)
    (:subauthor "SUBAUTHOR" nil nil newline))
  "Alist between Texinfo export properties and ways to set them.
See `org-export-options-alist' for more information on the
structure of the values.

SUBAUTHOR and SUBTITLE are for the inclusion of additional author
and title information beyond the initial variable.")


\f
;;; Internal Variables

\f
;;; User Configurable Variables

(defgroup org-export-e-texinfo nil
  "Options for exporting Org mode files to Texinfo."
  :tag "Org Export Texinfo"
  :group 'org-export)


;;;; Preamble

(defcustom org-e-texinfo-filename nil
  "Default filename for texinfo output."
  :group 'org-export-e-texinfo
  :type '(string :tag "Export Filename"))

(defcustom org-e-texinfo-default-class "info"
  "The default Texinfo class."
  :group 'org-export-e-texinfo
  :type '(string :tag "Texinfo class"))

(defcustom org-e-texinfo-classes
  '(("info"
     "\\input texinfo    @c -*- texinfo -*-"
     ("@chapter %s" . "@unnumbered %s")
     ("@section %s" . "@unnumberedsec %s")
     ("@subsection %s" . "@unnumberedsubsec %s")
     ("@subsubsection %s" . "@unnumberedsubsubsec %s")))
  "Alist of Texinfo classes and associated header and structure.
If #+Texinfo_CLASS is set in the buffer, use its value and the
associated information.  Here is the structure of each cell:

  \(class-name
    header-string
    \(numbered-section . unnumbered-section\)
    ...\)

The sectioning structure
------------------------

The sectioning structure of the class is given by the elements
following the header string.  For each sectioning level, a number
of strings is specified.  A %s formatter is mandatory in each
section string and will be replaced by the title of the section.

Instead of a cons cell \(numbered . unnumbered\), you can also
provide a list of 2 or 4 elements,

  \(numbered-open numbered-close\)

or

  \(numbered-open numbered-close unnumbered-open unnumbered-close\)

providing opening and closing strings for a Texinfo environment
that should represent the document section.  The opening clause
should have a %s to represent the section title.

Instead of a list of sectioning commands, you can also specify
a function name.  That function will be called with two
parameters, the \(reduced) level of the headline, and a predicate
non-nil when the headline should be numbered.  It must return
a format string in which the section title will be added."
  :group 'org-export-e-texinfo
  :type '(repeat
	  (list (string :tag "Texinfo class")
		(string :tag "Texinfo header")
		(repeat :tag "Levels" :inline t
			(choice
			 (cons :tag "Heading"
			       (string :tag "  numbered")
			       (string :tag "unnumbered"))
			 (list :tag "Environment"
			       (string :tag "Opening   (numbered)")
			       (string :tag "Closing   (numbered)")
			       (string :tag "Opening (unnumbered)")
			       (string :tag "Closing (unnumbered)"))
			 (function :tag "Hook computing sectioning"))))))


;;;; Headline

(defcustom org-e-texinfo-format-headline-function nil
  "Function to format headline text.

This function will be called with 5 arguments:
TODO      the todo keyword (string or nil).
TODO-TYPE the type of todo (symbol: `todo', `done', nil)
PRIORITY  the priority of the headline (integer or nil)
TEXT      the main headline text (string).
TAGS      the tags as a list of strings (list of strings or nil).

The function result will be used in the section format string.

As an example, one could set the variable to the following, in
order to reproduce the default set-up:

\(defun org-e-texinfo-format-headline (todo todo-type priority text tags)
  \"Default format function for an headline.\"
  \(concat (when todo
            \(format \"\\\\textbf{\\\\textsc{\\\\textsf{%s}}} \" todo))
	  \(when priority
            \(format \"\\\\framebox{\\\\#%c} \" priority))
	  text
	  \(when tags
            \(format \"\\\\hfill{}\\\\textsc{%s}\"
              \(mapconcat 'identity tags \":\"))))"
  :group 'org-export-e-texinfo
  :type 'function)


;;;; Footnotes
;;
;; Footnotes are inserted directly

;;;; Timestamps

(defcustom org-e-texinfo-active-timestamp-format "@emph{%s}"
  "A printf format string to be applied to active timestamps."
  :group 'org-export-e-texinfo
  :type 'string)

(defcustom org-e-texinfo-inactive-timestamp-format "@emph{%s}"
  "A printf format string to be applied to inactive timestamps."
  :group 'org-export-e-texinfo
  :type 'string)

(defcustom org-e-texinfo-diary-timestamp-format "@emph{%s}"
  "A printf format string to be applied to diary timestamps."
  :group 'org-export-e-texinfo
  :type 'string)

;;;; Links

(defcustom org-e-texinfo-link-with-unknown-path-format "@indicateurl{%s}"
  "Format string for links with unknown path type."
  :group 'org-export-e-texinfo
  :type 'string)


;;;; Tables

(defcustom org-e-texinfo-tables-verbatim nil
  "When non-nil, tables are exported verbatim."
  :group 'org-export-e-texinfo
  :type 'boolean)

(defcustom org-e-texinfo-table-scientific-notation "%s\\,(%s)"
  "Format string to display numbers in scientific notation.
The format should have \"%s\" twice, for mantissa and exponent
\(i.e. \"%s\\\\times10^{%s}\").

When nil, no transformation is made."
  :group 'org-export-e-texinfo
  :type '(choice
	  (string :tag "Format string")
	  (const :tag "No formatting")))

(defcustom org-e-texinfo-def-table-markup "@samp"
  "Default setting for @table environments.")

;;;; Text markup

(defcustom org-e-texinfo-text-markup-alist '((bold . "@strong{%s}")
					   (code . code)
					   (italic . "@emph{%s}")
					   (verbatim . verb)
					   (comment . "@c %s"))
  "Alist of Texinfo expressions to convert text markup.

The key must be a symbol among `bold', `code', `italic',
`strike-through', `underline' and `verbatim'.  The value is
a formatting string to wrap fontified text with.

Value can also be set to the following symbols: `verb' and
`protectedtexttt'.  For the former, Org will use \"\\verb\" to
create a format string and select a delimiter character that
isn't in the string.  For the latter, Org will use \"\\texttt\"
to typeset and try to protect special characters.

If no association can be found for a given markup, text will be
returned as-is."
  :group 'org-export-e-texinfo
  :type 'alist
  :options '(bold code italic verbatim comment))


;;;; Drawers

(defcustom org-e-texinfo-format-drawer-function nil
  "Function called to format a drawer in Texinfo code.

The function must accept two parameters:
  NAME      the drawer name, like \"LOGBOOK\"
  CONTENTS  the contents of the drawer.

The function should return the string to be exported.

For example, the variable could be set to the following function
in order to mimic default behaviour:

\(defun org-e-texinfo-format-drawer-default \(name contents\)
  \"Format a drawer element for Texinfo export.\"
  contents\)"
  :group 'org-export-e-texinfo
  :type 'function)


;;;; Inlinetasks

(defcustom org-e-texinfo-format-inlinetask-function nil
  "Function called to format an inlinetask in Texinfo code.

The function must accept six parameters:
  TODO      the todo keyword, as a string
  TODO-TYPE the todo type, a symbol among `todo', `done' and nil.
  PRIORITY  the inlinetask priority, as a string
  NAME      the inlinetask name, as a string.
  TAGS      the inlinetask tags, as a list of strings.
  CONTENTS  the contents of the inlinetask, as a string.

The function should return the string to be exported.

For example, the variable could be set to the following function
in order to mimic default behaviour:

\(defun org-e-texinfo-format-inlinetask \(todo type priority name tags contents\)
\"Format an inline task element for Texinfo export.\"
  \(let ((full-title
	 \(concat
	  \(when todo
            \(format \"\\\\textbf{\\\\textsf{\\\\textsc{%s}}} \" todo))
	  \(when priority (format \"\\\\framebox{\\\\#%c} \" priority))
	  title
	  \(when tags
            \(format \"\\\\hfill{}\\\\textsc{:%s:}\"
                    \(mapconcat 'identity tags \":\")))))
    \(format (concat \"\\\\begin{center}\\n\"
		    \"\\\\fbox{\\n\"
		    \"\\\\begin{minipage}[c]{.6\\\\textwidth}\\n\"
		    \"%s\\n\\n\"
		    \"\\\\rule[.8em]{\\\\textwidth}{2pt}\\n\\n\"
		    \"%s\"
		    \"\\\\end{minipage}}\"
		    \"\\\\end{center}\")
	    full-title contents))"
  :group 'org-export-e-texinfo
  :type 'function)


;;;; Src blocks
;;
;; Src Blocks are example blocks, except for LISP

;;;; Plain text

(defcustom org-e-texinfo-quotes
  '(("quotes"
     ("\\(\\s-\\|[[(]\\|^\\)\"" . "``")
     ("\\(\\S-\\)\"" . "''")
     ("\\(\\s-\\|(\\|^\\)'" . "`")))
  "Alist for quotes to use when converting english double-quotes.

The CAR of each item in this alist is the language code.
The CDR of each item in this alist is a list of three CONS:
- the first CONS defines the opening quote;
- the second CONS defines the closing quote;
- the last CONS defines single quotes.

For each item in a CONS, the first string is a regexp
for allowed characters before/after the quote, the second
string defines the replacement string for this quote."
  :group 'org-export-e-texinfo
  :type '(list
	  (cons :tag "Opening quote"
		(string :tag "Regexp for char before")
		(string :tag "Replacement quote     "))
	  (cons :tag "Closing quote"
		(string :tag "Regexp for char after ")
		(string :tag "Replacement quote     "))
	  (cons :tag "Single quote"
		(string :tag "Regexp for char before")
		(string :tag "Replacement quote     "))))


;;;; Compilation

(defcustom org-e-texinfo-info-process
  '("makeinfo %f")
  "Commands to process a texinfo file to an INFO file.
This is list of strings, each of them will be given to the shell
as a command.  %f in the command will be replaced by the full
file name, %b by the file base name \(i.e without extension) and
%o by the base directory of the file."
  :group 'org-export-texinfo
  :type '(repeat :tag "Shell command sequence"
		 (string :tag "Shell command")))

\f
;;; Internal Functions

(defun org-e-texinfo--find-copying (info)
  ""
  (let (copying)
    (org-element-map (plist-get info :parse-tree) 'headline
		     (lambda (ref)
		       (when (org-element-property :copying ref)
			 (push ref copying))) info 't)
    ;; Retrieve the single entry
    (car copying)))

(defun org-e-texinfo--find-verb-separator (s)
  "Return a character not used in string S.
This is used to choose a separator for constructs like \\verb."
  (let ((ll "~,./?;':\"|!@#%^&-_=+abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ<>()[]{}"))
    (loop for c across ll
	  when (not (string-match (regexp-quote (char-to-string c)) s))
	  return (char-to-string c))))

(defun org-e-texinfo--make-option-string (options)
  "Return a comma separated string of keywords and values.
OPTIONS is an alist where the key is the options keyword as
a string, and the value a list containing the keyword value, or
nil."
  (mapconcat (lambda (pair)
	       (concat (first pair)
		       (when (> (length (second pair)) 0)
			 (concat "=" (second pair)))))
	     options
	     ","))

(defun org-e-texinfo--quotation-marks (text info)
  "Export quotation marks using ` and ' as the markers.
TEXT is a string containing quotation marks to be replaced.  INFO
is a plist used as a communication channel."
  (mapc (lambda(l)
	  (let ((start 0))
	    (while (setq start (string-match (car l) text start))
	      (let ((new-quote (concat (match-string 1 text) (cdr l))))
		(setq text (replace-match new-quote  t t text))))))
	(cdr org-e-texinfo-quotes))
  text)

(defun org-e-texinfo--text-markup (text markup)
  "Format TEXT depending on MARKUP text markup.
See `org-e-texinfo-text-markup-alist' for details."
  (let ((fmt (cdr (assq markup org-e-texinfo-text-markup-alist))))
    (cond
     ;; No format string: Return raw text.
     ((not fmt) text)
     ((eq 'verb fmt)
      (let ((separator (org-e-texinfo--find-verb-separator text)))
	(concat "@verb{" separator text separator "}")))
     ((eq 'code fmt)
      (let ((start 0)
	    (rtn "")
	    char)
	(while (string-match "[@{}]" text)
	  (setq char (match-string 0 text))
	  (if (> (match-beginning 0) 0)
	      (setq rtn (concat rtn (substring text 0 (match-beginning 0)))))
	  (setq text (substring text (1+ (match-beginning 0))))
	  (setq char (concat "@" char)
		rtn (concat rtn char)))
	(setq text (concat rtn text)
	      fmt "@code{%s}")
	(format fmt text)))
     ;; Else use format string.
     (t (format fmt text)))))

;;;; Menu creation

(defun org-e-texinfo--build-menu (tree level info &optional detailed)
  ""
  (let ((menu (org-e-texinfo--generate-menu-list tree level info)))
    (cond
     (detailed
      ;; Looping is done separately
      (setq text-menu (org-e-texinfo--generate-detailed menu level info)))
     (t
      (setq text-menu (org-e-texinfo--generate-menu-items menu info))))
    (when text-menu
      (setq output (org-e-texinfo--format-menu text-menu))
      (mapconcat 'identity output "\n"))))

(defun org-e-texinfo--generate-detailed (menu level info)
  ""
  ;; Export class definition has 2 descriptive lines, this omits them
  ;; then calculates how many levels of headlines are used for TOC/Menu.
  (setq max-depth (plist-get info :headline-levels))
  (when (> max-depth level)
    (loop for headline in menu append
	  (let* ((title (org-e-texinfo--menu-headlines headline info))
		 (sublist (org-e-texinfo--generate-menu-list
			   headline (1+ level) info))
		 (submenu (if (org-e-texinfo--generate-menu-items sublist info)
			      (append (list title)
				      (org-e-texinfo--generate-menu-items sublist info))
			    'nil))
		 ;; Recursion
		 (recursion (org-e-texinfo--generate-detailed sublist (1+ level) info))
		 )
	    (setq recursion (append submenu recursion))
	    recursion))))

(defun org-e-texinfo--generate-menu-list (tree level info)
  "Generate the list of headlines that are within a given level
of the tree for further formatting.

TREE is the parse-tree containing the headlines.  LEVEL is the
headline level to generate a list of.  INFO is a plist holding
contextual information."
  (let (seq)
    (org-element-map
     tree 'headline
     (lambda (ref)
       (when (org-element-property :level ref)
	 (if (and (eq level (org-element-property :level ref))
		  ;; Do not take note of footnotes or copying headlines
		  (not (org-element-property :copying ref))
		  (not (org-element-property :footnote-section-p ref)))
	     (push ref seq)))))
    ;; Return the list of headlines (reverse to have in actual order)
    (reverse seq)))

(defun org-e-texinfo--generate-menu-items (menu info)
  ""
  
  (loop for headline in menu collect
	(let* ((title (org-export-data
		       (org-element-property :title headline) info))
	       (descr (org-export-data
		       (org-element-property :description headline) info))
	       (len (length title))
	       (output (list len title descr)))
	  output)))

(defun org-e-texinfo--menu-headlines (menu info)
  ""
  (setq title (org-export-data
               (org-element-property :title headline) info))
  (list 0 title 'nil))

(defun org-e-texinfo--format-menu (text-menu)
  ""
  ;; Format should be a list of menu entries
  ;; (length title description).  For headlines they should be
  ;; (nil title nil).  This permits proper spacing settings
  (let* ((lengths (mapcar 'car text-menu))
         (max-length (apply 'max lengths)))
    (setq output
          (mapcar (lambda (name)
                    (let* ((title (nth 1 name))
                           (desc (nth 2 name))
                           (length (nth 0 name)))
                      (if (> length 0)
                          (concat "* " title ":: "
                                  (make-string (- (+ 3 max-length) length)
                                               ?\s)
                                  (if desc
                                      (concat desc)))
                        (concat "\n" title "\n"))))
		  text-menu))
    output))



;;; Template

(defun org-e-texinfo-template (contents info)
  "Return complete document string after Texinfo conversion.
CONTENTS is the transcoded contents string.  INFO is a plist
holding export options."
  (let* ((title (org-export-data (plist-get info :title) info))
	 (info-filename (or (plist-get info :texinfo-filename)
			    (file-name-nondirectory
			     (org-export-output-file-name ".info"))))
	 (author (org-export-data (plist-get info :author) info))
	 (texinfo-header (plist-get info :texinfo-header))
	 (subtitle (plist-get info :subtitle))
	 (subauthor (plist-get info :subauthor))
	 (class (plist-get info :texinfo-class))
	 (header (nth 1 (assoc class org-e-texinfo-classes)))
	 (copying (org-e-texinfo--find-copying info)))
    (concat
     ;; Header
     header "\n"
     "@c %**start of header\n"
     ;; Filename and Title
     "@setfilename " info-filename "\n"
     "@settitle " title "\n"
     "\n\n"
     "@c Version and Contact Info\n"
     "@set AUTHOR " author "\n"

     ;; Additional Header Options set by `#+TEXINFO_HEADER
     (if texinfo-header
	 (concat "\n"
		 texinfo-header
		 "\n"))
     
     "@c %**end of header\n"
     "@finalout\n"
     "\n\n"

     ;; Copying
     "@copying\n"
     ;; Only export the content of the headline, do not need the
     ;; initial headline.
     (org-export-data (nth 2 copying) info)
     "@end copying\n"
     "\n\n"

     ;; Title
     "@titlepage\n"
     "@title " title "\n\n"
     (if subtitle
	 (concat "@subtitle " subtitle "\n"))
     "@author " author "\n"
     (if subauthor
	 (concat subauthor "\n"))
     "\n"
     "@c The following two commands start the copyright page.\n"
     "@page\n"
     "@vskip 0pt plus 1filll\n"
     "@insertcopying\n"
     "@end titlepage\n\n"
     "@c Output the table of contents at the beginning.\n"
     "@contents\n\n"

     ;; Configure Top Node when not for Tex
     "@ifnottex\n"
     "@node Top\n"
     "@top " title " Manual\n"
     "@insertcopying\n"
     "@end ifnottex\n\n"
     
     ;; Menu
     "@menu\n"
     (org-e-texinfo-make-menu info 'main)
     "\n\n"
     ;; Detailed Menu
     "@detailmenu\n"
     " --- The Detailed Node Listing ---\n"
     (org-e-texinfo-make-menu info 'detailed)
     "\n\n"
     "@end detailmenu\n"
     "@end menu\n"
     "\n\n"
     
     ;; Document's body.
     contents
     "\n"
     ;; Creator.
     (let ((creator-info (plist-get info :with-creator)))
       (cond
	((not creator-info) "")
	((eq creator-info 'comment)
	 (format "@c %s\n" (plist-get info :creator)))
	(t (concat (plist-get info :creator) "\n"))))
     ;; Document end.
     "\n@bye")))


\f
;;; Transcode Functions

;;;; Babel Call
;;
;; Babel Calls are ignored.


;;;; Bold

(defun org-e-texinfo-bold (bold contents info)
  "Transcode BOLD from Org to Texinfo.
CONTENTS is the text with bold markup.  INFO is a plist holding
contextual information."
  (org-e-texinfo--text-markup contents 'bold))


;;;; Center Block
;;
;; Center blocks are ignored


;;;; Clock

(defun org-e-texinfo-clock (clock contents info)
  "Transcode a CLOCK element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  (concat
   "@noindent"
   (format "@strong{%s} " org-clock-string)
   (format org-e-texinfo-inactive-timestamp-format
	   (concat (org-translate-time (org-element-property :value clock))
		   (let ((time (org-element-property :time clock)))
		     (and time (format " (%s)" time)))))
   "@*"))


;;;; Code

(defun org-e-texinfo-code (code contents info)
  "Transcode a CODE object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist used as a communication
channel."
  (org-e-texinfo--text-markup (org-element-property :value code) 'code))

;;;; Comment

(defun org-e-texinfo-comment (comment contents info)
  "Transcode a COMMENT object from Org to Texinfo.
CONTENTS is the text in the comment.  INFO is a plist holding
contextual information."
  (org-e-texinfo--text-markup (org-element-property :value comment) 'comment))

;;;; Comment Block

(defun org-e-texinfo-comment-block (comment-block contents info)
  "Transcode a COMMENT-BLOCK object from Org to Texinfo.
CONTENTS is the text within the block.  INFO is a plist holding
contextual information."
  (format "@ignore\n%s@end ignore" (org-element-property :value comment-block)))

;;;; Drawer

(defun org-e-texinfo-drawer (drawer contents info)
  "Transcode a DRAWER element from Org to Texinfo.
CONTENTS holds the contents of the block.  INFO is a plist
holding contextual information."
  (let* ((name (org-element-property :drawer-name drawer))
	 (output (if (functionp org-e-texinfo-format-drawer-function)
		     (funcall org-e-texinfo-format-drawer-function
			      name contents)
		   ;; If there's no user defined function: simply
		   ;; display contents of the drawer.
		   contents)))
    output))


;;;; Dynamic Block

(defun org-e-texinfo-dynamic-block (dynamic-block contents info)
  "Transcode a DYNAMIC-BLOCK element from Org to Texinfo.
CONTENTS holds the contents of the block.  INFO is a plist
holding contextual information.  See `org-export-data'."
  contents)


;;;; Entity

(defun org-e-texinfo-entity (entity contents info)
  "Transcode an ENTITY object from Org to Texinfo.
CONTENTS are the definition itself.  INFO is a plist holding
contextual information."
  (let ((ent (org-element-property :latex entity)))
    (if (org-element-property :latex-math-p entity) (format "@math{%s}" ent) ent)))


;;;; Example Block

(defun org-e-texinfo-example-block (example-block contents info)
  "Transcode an EXAMPLE-BLOCK element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  (format "@verbatim\n%s@end verbatim"
	  (org-export-format-code-default example-block info)))


;;;; Export Block

(defun org-e-texinfo-export-block (export-block contents info)
  "Transcode a EXPORT-BLOCK element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (when (string= (org-element-property :type export-block) "LATEX")
    (org-remove-indentation (org-element-property :value export-block))))


;;;; Export Snippet

(defun org-e-texinfo-export-snippet (export-snippet contents info)
  "Transcode a EXPORT-SNIPPET object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (when (eq (org-export-snippet-backend export-snippet) 'e-texinfo)
    (org-element-property :value export-snippet)))


;;;; Fixed Width

(defun org-e-texinfo-fixed-width (fixed-width contents info)
  "Transcode a FIXED-WIDTH element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (format "@example\n%s\n@end example"
	  (org-remove-indentation
	   (org-element-property :value fixed-width))))


;;;; Footnote Definition
;;
;; Footnote Definitions are ignored.


;;;; Footnote Reference
;;

(defun org-e-texinfo-footnote-reference (footnote contents info)
  ""
  (let ((def (org-export-get-footnote-definition footnote info)))
    (format "@footnote{%s}"
	    (org-trim (org-export-data def info)))))

;;;; Headline

(defun org-e-texinfo-headline (headline contents info)
  "Transcode an HEADLINE element from Org to Texinfo.
CONTENTS holds the contents of the headline.  INFO is a plist
holding contextual information."
  (let* ((class (plist-get info :texinfo-class))
	 (level (org-export-get-relative-level headline info))
	 (numberedp (org-export-numbered-headline-p headline info))
	 (class-sectionning (assoc class org-e-texinfo-classes))
	 ;; Create node info, to insert it before section formatting.
	 (node (format "@node %s\n"
		       (org-export-data (org-element-property :title headline) info)))
	 ;; Menus must be generated with first child, otherwise they
	 ;; will not nest properly
	 (menu (let* ((first (org-export-first-sibling-p headline))
		      (parent (org-export-get-parent-headline headline))
		      (title (org-export-data (org-element-property :title parent) info))
		      heading
		      (tree (plist-get info :parse-tree)))
		 (if first
		     (org-element-map
		      (plist-get info :parse-tree) 'headline
		      (lambda (ref)
			(if (member title (org-element-property :title ref))
			    (push ref heading)))
		      info 't))
		 (setq listing (org-e-texinfo--build-menu (car heading) level info))
	 	 (if listing
	 	     (setq listing (format "\n@menu\n%s\n@end menu\n\n" listing))
	 	   'nil)
		 ))
	 ;; Section formatting will set two placeholders: one for the
	 ;; title and the other for the contents.
	 (section-fmt
	  (let ((sec (if (and (symbolp (nth 2 class-sectionning))
			      (fboundp (nth 2 class-sectionning)))
			 (funcall (nth 2 class-sectionning) level numberedp)
		       (nth (1+ level) class-sectionning))))
	    (cond
	     ;; No section available for that LEVEL.
	     ((not sec) nil)
	     ;; Section format directly returned by a function.
	     ((stringp sec) sec)
	     ;; (numbered-section . unnumbered-section)
	     ((not (consp (cdr sec)))
	      (concat menu node (funcall (if numberedp #'car #'cdr) sec) "\n%s"))
	     ;; (numbered-open numbered-close)
	     ((= (length sec) 2)
	      (when numberedp (concat menu node (car sec) "\n%s" (nth 1 sec))))
	     ;; (num-in num-out no-num-in no-num-out)
	     ((= (length sec) 4)
	      (if numberedp (concat (car sec) "\n%s" (nth 1 sec))
		(concat menu node (nth 2 sec) "\n%s" (nth 3 sec)))))))
	 (text (org-export-data (org-element-property :title headline) info))
	 (todo
	  (and (plist-get info :with-todo-keywords)
	       (let ((todo (org-element-property :todo-keyword headline)))
		 (and todo (org-export-data todo info)))))
	 (todo-type (and todo (org-element-property :todo-type headline)))
	 (tags (and (plist-get info :with-tags)
		    (org-export-get-tags headline info)))
	 (priority (and (plist-get info :with-priority)
			(org-element-property :priority headline)))
	 ;; Create the headline text along with a no-tag version.  The
	 ;; latter is required to remove tags from table of contents.
	 (full-text (if (functionp org-e-texinfo-format-headline-function)
			;; User-defined formatting function.
			(funcall org-e-texinfo-format-headline-function
				 todo todo-type priority text tags)
		      ;; Default formatting.
		      (concat
		       (when todo
			 (format "@strong{%s} " todo))
		       (when priority (format "@emph{#%s} " priority))
		       text
		       (when tags
			 (format ":%s:"
				 (mapconcat 'identity tags ":"))))))
	 (full-text-no-tag
	  (if (functionp org-e-texinfo-format-headline-function)
	      ;; User-defined formatting function.
	      (funcall org-e-texinfo-format-headline-function
		       todo todo-type priority text nil)
	    ;; Default formatting.
	    (concat
	     (when todo (format "@strong{%s} " todo))
	     (when priority (format "@emph{#%c} " priority))
	     text)))
	 (pre-blanks
	  (make-string (org-element-property :pre-blank headline) 10))
	 )
    (cond
     ;; Case 1: This is a footnote section: ignore it.
     ((org-element-property :footnote-section-p headline) nil)
     ;; Case 2: This is the `copying' section: ignore it
     ;;         This is used elsewhere.
     ((org-element-property :copying headline) nil)
     ;; Case 3: This is a deep sub-tree: export it as a list item.
     ;;         Also export as items headlines for which no section
     ;;         format has been found.
     ((or (not section-fmt) (org-export-low-level-p headline info))
      ;; Build the real contents of the sub-tree.
      (let ((low-level-body
	     (concat
	      ;; If the headline is the first sibling, start a list.
	      (when (org-export-first-sibling-p headline)
		(format "@%s\n" (if numberedp 'enumerate 'itemize)))
	      ;; Itemize headline
	      "@item\n" full-text "\n" pre-blanks contents)))
	;; If headline is not the last sibling simply return
	;; LOW-LEVEL-BODY.  Otherwise, also close the list, before any
	;; blank line.
	(if (not (org-export-last-sibling-p headline)) low-level-body
	  (replace-regexp-in-string
	   "[ \t\n]*\\'"
	   (format "\n@end %s" (if numberedp 'enumerate 'itemize))
	   low-level-body))))
     ;; Case 4: Standard headline.  Export it as a section.
     (t
      (cond
       ((not (and tags (eq (plist-get info :with-tags) 'not-in-toc)))
	;; Regular section.  Use specified format string.
	(format (replace-regexp-in-string "%]" "%%]" section-fmt) full-text
		(concat pre-blanks contents "\n")))
       ((string-match "\\`@\\(.*?\\){" section-fmt)
	;; If tags should be removed from table of contents, insert
	;; title without tags as an alternative heading in sectioning
	;; command.
	(format (replace-match (concat (match-string 1 section-fmt) "[%s]")
			       nil nil section-fmt 1)
		;; Replace square brackets with parenthesis since
		;; square brackets are not supported in optional
		;; arguments.
		(replace-regexp-in-string
		 "\\[" "("
		 (replace-regexp-in-string
		  "\\]" ")"
		  full-text-no-tag))
		full-text
		(concat pre-blanks contents "\n")))
       (t
	;; Impossible to add an alternative heading.  Fallback to
	;; regular sectioning format string.
	(format (replace-regexp-in-string "%]" "%%]" section-fmt) full-text
		(concat pre-blanks contents "\n"))))))))


;;;; Horizontal Rule
;;
;; Horizontal rules are ignored

;;;; Inline Babel Call
;;
;; Inline Babel Calls are ignored.


;;;; Inline Src Block

(defun org-e-texinfo-inline-src-block (inline-src-block contents info)
  "Transcode an INLINE-SRC-BLOCK element from Org to Texinfo.
CONTENTS holds the contents of the item.  INFO is a plist holding
contextual information."
  (let* ((code (org-element-property :value inline-src-block))
	 (separator (org-e-texinfo--find-verb-separator code)))
    (cond
     ;; Do not use a special package: transcode it verbatim.
     ((not org-e-texinfo-listings)
      (concat "\\verb" separator code separator))
     ;; Use minted package.
     ((eq org-e-texinfo-listings 'minted)
      (let* ((org-lang (org-element-property :language inline-src-block))
	     (mint-lang (or (cadr (assq (intern org-lang)
					org-e-texinfo-minted-langs))
			    org-lang))
	     (options (org-e-texinfo--make-option-string
		       org-e-texinfo-minted-options)))
	(concat (format "\\mint%s{%s}"
			(if (string= options "") "" (format "[%s]" options))
			mint-lang)
		separator code separator)))
     ;; Use listings package.
     (t
      ;; Maybe translate language's name.
      (let* ((org-lang (org-element-property :language inline-src-block))
	     (lst-lang (or (cadr (assq (intern org-lang)
				       org-e-texinfo-listings-langs))
			   org-lang))
	     (options (org-e-texinfo--make-option-string
		       (append org-e-texinfo-listings-options
			       `(("language" ,lst-lang))))))
	(concat (format "\\lstinline[%s]" options)
		separator code separator))))))


;;;; Inlinetask

(defun org-e-texinfo-inlinetask (inlinetask contents info)
  "Transcode an INLINETASK element from Org to Texinfo.
CONTENTS holds the contents of the block.  INFO is a plist
holding contextual information."
  (let ((title (org-export-data (org-element-property :title inlinetask) info))
	(todo (and (plist-get info :with-todo-keywords)
		   (let ((todo (org-element-property :todo-keyword inlinetask)))
		     (and todo (org-export-data todo info)))))
	(todo-type (org-element-property :todo-type inlinetask))
	(tags (and (plist-get info :with-tags)
		   (org-export-get-tags inlinetask info)))
	(priority (and (plist-get info :with-priority)
		       (org-element-property :priority inlinetask))))
    ;; If `org-e-texinfo-format-inlinetask-function' is provided, call it
    ;; with appropriate arguments.
    (if (functionp org-e-texinfo-format-inlinetask-function)
	(funcall org-e-texinfo-format-inlinetask-function
		 todo todo-type priority title tags contents)
      ;; Otherwise, use a default template.
      (let ((full-title
	     (concat
	      (when todo (format "@strong{%s} " todo))
	      (when priority (format "%c " priority))
	      title
	      (when tags (format ":%s:"
				 (mapconcat 'identity tags ":"))))))
	(format (concat "@center %s\n\n"
			"%s"
			"\n")
		full-title contents)))))


;;;; Italic

(defun org-e-texinfo-italic (italic contents info)
  "Transcode ITALIC from Org to Texinfo.
CONTENTS is the text with italic markup.  INFO is a plist holding
contextual information."
  (org-e-texinfo--text-markup contents 'italic))

;;;; Item

(defun org-e-texinfo-item (item contents info)
  "Transcode an ITEM element from Org to Texinfo.
CONTENTS holds the contents of the item.  INFO is a plist holding
contextual information."
  (concat "\n@item\n"
	    (org-trim contents) "\n"))


;;;; Keyword

(defun org-e-texinfo-keyword (keyword contents info)
  "Transcode a KEYWORD element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (let ((key (org-element-property :key keyword))
	(value (org-element-property :value keyword)))
    (cond
     ((string= key "LATEX") value)
     ((string= key "INDEX") (format "\\index{%s}" value))
     ;; Invisible targets.
     ((string= key "TARGET") nil)
     ((string= key "TOC")
      (let ((value (downcase value)))
	(cond
	 ((string-match "\\<headlines\\>" value)
	  (let ((depth (or (and (string-match "[0-9]+" value)
				(string-to-number (match-string 0 value)))
			   (plist-get info :with-toc))))
	    (concat
	     (when (wholenump depth)
	       (format "\\setcounter{tocdepth}{%s}\n" depth))
	     "\\tableofcontents")))
	 ((string= "tables" value) "\\listoftables")
	 ((string= "figures" value) "\\listoffigures")
	 ((string= "listings" value)
	  (cond
	   ((eq org-e-texinfo-listings 'minted) "\\listoflistings")
	   (org-e-texinfo-listings "\\lstlistoflistings")
	   ;; At the moment, src blocks with a caption are wrapped
	   ;; into a figure environment.
	   (t "\\listoffigures")))))))))


;;;; Latex Environment

(defun org-e-texinfo-latex-environment (latex-environment contents info)
  "Transcode a LATEX-ENVIRONMENT element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (let ((label (org-element-property :name latex-environment))
	(value (org-remove-indentation
		(org-element-property :value latex-environment))))
    (if (not (org-string-nw-p label)) value
      ;; Environment is labelled: label must be within the environment
      ;; (otherwise, a reference pointing to that element will count
      ;; the section instead).
      (with-temp-buffer
	(insert value)
	(goto-char (point-min))
	(forward-line)
	(insert (format "\\label{%s}\n" label))
	(buffer-string)))))


;;;; Latex Fragment

(defun org-e-texinfo-latex-fragment (latex-fragment contents info)
  "Transcode a LATEX-FRAGMENT object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (org-element-property :value latex-fragment))


;;;; Line Break

(defun org-e-texinfo-line-break (line-break contents info)
  "Transcode a LINE-BREAK object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  "@*")


;;;; Link

(defun org-e-texinfo-link (link desc info)
  "Transcode a LINK object from Org to Texinfo.

DESC is the description part of the link, or the empty string.
INFO is a plist holding contextual information.  See
`org-export-data'."
  (let* ((type (org-element-property :type link))
	 (raw-path (org-element-property :path link))
	 ;; Ensure DESC really exists, or set it to nil.
	 (desc (and (not (string= desc "")) desc))
	 (path (cond
		((member type '("http" "https" "ftp"))
		 (concat type ":" raw-path))
		((string= type "file")
		 (when (string-match "\\(.+\\)::.+" raw-path)
		   (setq raw-path (match-string 1 raw-path)))
		 (if (file-name-absolute-p raw-path)
		     (concat "file://" (expand-file-name raw-path))
		   (concat "file://" raw-path)))
		(t raw-path)))
	 (email (if (string= type "mailto")
		    (let ((text (replace-regexp-in-string
				 "@" "@@" raw-path)))
		     (concat text (if desc (concat "," desc))))))
	 protocol)
    (cond
     ;; Links pointing to an headline: Find destination and build
     ;; appropriate referencing command.
     ((member type '("custom-id" "fuzzy" "id"))
      (let ((destination (org-export-resolve-id-link link info)))
	(case (org-element-type destination)
	  ;; Id link points to an external file.
	  (plain-text
	   (if desc (format "@uref{file://%s,%s}" destination desc)
	     (format "@uref{file://%s}" destination)))
	  ;; LINK points to an headline.  Use the headline as the NODE target
	  (headline
	   (format "@ref{%s}"
		   (org-export-data
		    (org-element-property :title destination) info)))
	  (t))))
     ;; Special case for email addresses
     (email
      (format "@email{%s}" email))
     ;; External link with a description part.
     ((and path desc) (format "@uref{%s,%s}" path desc))
     ;; External link without a description part.
     (path (format "@uref{%s}" path))
     ;; No path, only description.  Try to do something useful.
     (t (format org-e-texinfo-link-with-unknown-path-format desc)))))


;;;; Macro

(defun org-e-texinfo-macro (macro contents info)
  "Transcode a MACRO element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  ;; Use available tools.
  (org-export-expand-macro macro info))


;;;; Menu

(defun org-e-texinfo-make-menu (tree level &optional info)
  "Create the menu for inclusion in the texifo document.
INFO is the parsed buffer that contains the headlines.  LEVEL
determines whether to make the main menu, or the detailed menu."
  (let* ((info (if info
		   info
		 tree))
	 (parse (plist-get tree :parse-tree))
	 ;; Top determines level to build menu from, it finds the
	 ;; level of the first headline in the export.
	 (top (org-element-map
	       parse 'headline
	       (lambda (headline)
		 (org-element-property :level headline)) info 't))
	 menu menu-title)
    (cond
     ;; Generate the main menu
     ((eq level 'main)
      (org-e-texinfo--build-menu parse top info))
     ;; Generate the detailed (recursive) menu
     ((eq level 'detailed)
      ;; Requires recursion
      ;;(org-e-texinfo--build-detailed-menu parse top info)
      (or (org-e-texinfo--build-menu parse top info 'detailed)
	  "detailed")
      )
     ;; If an integer, create specific menu for that level
     ((integerp level)
      (org-e-texinfo--build-menu parse level info))
     ;; Otherwise do nothing
     (t
      ))))


;;;; Paragraph

(defun org-e-texinfo-paragraph (paragraph contents info)
  "Transcode a PARAGRAPH element from Org to Texinfo.
CONTENTS is the contents of the paragraph, as a string.  INFO is
the plist used as a communication channel."
  contents)


;;;; Plain List

(defun org-e-texinfo-plain-list (plain-list contents info)
  "Transcode a PLAIN-LIST element from Org to Texinfo.
CONTENTS is the contents of the list.  INFO is a plist holding
contextual information."
  (let* ((type (org-element-property :type plain-list))
	 (list-type (cond
		     ((eq type 'ordered) "enumerate")
		     ((eq type 'unordered) "itemize")
		     ((eq type 'descriptive) "table"))))
    (format "@%s%s\n@end %s"
	    (if (eq type 'descriptive)
		(concat list-type " " org-e-texinfo-def-table-markup)
	     list-type)
	    contents
	    list-type)))


;;;; Plain Text

(defun org-e-texinfo-plain-text (text info)
  "Transcode a TEXT string from Org to Texinfo.
TEXT is the string to transcode.  INFO is a plist holding
contextual information."
  ;; Protect @ { and }.
  (while (string-match "\\([^\\]\\|^\\)\\([@{}]\\)" text)
    (setq text
	  (replace-match (format "\\%s" (match-string 2 text)) nil t text 2)))
  ;; Handle quotation marks
  (setq text (org-e-texinfo--quotation-marks text info))
  ;; Convert special strings.
  (when (plist-get info :with-special-strings)
    (while (string-match (regexp-quote "...") text)
      (setq text (replace-match "@dots{}" nil t text))))
  ;; Handle break preservation if required.
  (when (plist-get info :preserve-breaks)
    (setq text (replace-regexp-in-string "\\(\\\\\\\\\\)?[ \t]*\n" " @*\n"
					 text)))
  ;; Return value.
  text)


;;;; Planning

(defun org-e-texinfo-planning (planning contents info)
  "Transcode a PLANNING element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  (concat
   "@noindent"
   (mapconcat
    'identity
    (delq nil
	  (list
	   (let ((closed (org-element-property :closed planning)))
	     (when closed
	       (concat
		(format "@strong%s} " org-closed-string)
		(format org-e-texinfo-inactive-timestamp-format
			(org-translate-time closed)))))
	   (let ((deadline (org-element-property :deadline planning)))
	     (when deadline
	       (concat
		(format "@strong{%s} " org-deadline-string)
		(format org-e-texinfo-active-timestamp-format
			(org-translate-time deadline)))))
	   (let ((scheduled (org-element-property :scheduled planning)))
	     (when scheduled
	       (concat
		(format "@strong{%s} " org-scheduled-string)
		(format org-e-texinfo-active-timestamp-format
			(org-translate-time scheduled)))))))
    " ")
   "@*"))


;;;; Property Drawer

(defun org-e-texinfo-property-drawer (property-drawer contents info)
  "Transcode a PROPERTY-DRAWER element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  ;; The property drawer isn't exported but we want separating blank
  ;; lines nonetheless.
  "")


;;;; Quote Block



(defun org-e-texinfo-quote-block (quote-block contents info)
  "Transcode a QUOTE-BLOCK element from Org to Texinfo.
CONTENTS holds the contents of the block.  INFO is a plist
holding contextual information."
  
  (let* ((title (org-element-property :name quote-block))
	 (start-quote (concat "@quotation"

			      (if title
				 (format " %s" title)))))
    
    (format "%s\n%s@end quotation" start-quote contents)))



;;;; Quote Section

(defun org-e-texinfo-quote-section (quote-section contents info)
  "Transcode a QUOTE-SECTION element from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (let ((value (org-remove-indentation
		(org-element-property :value quote-section))))
    (when value (format "@verbatim\n%s@end verbatim" value))))


;;;; Radio Target
;;
;; Radio targets are not exported at the moment


;;;; Section

(defun org-e-texinfo-section (section contents info)
  "Transcode a SECTION element from Org to Texinfo.
CONTENTS holds the contents of the section.  INFO is a plist
holding contextual information."
  contents)


;;;; Special Block
;;
;; Are ignored at the moment

;;;; Src Block

(defun org-e-texinfo-src-block (src-block contents info)
  "Transcode a SRC-BLOCK element from Org to Texinfo.
CONTENTS holds the contents of the item.  INFO is a plist holding
contextual information."
  (let* ((lang (org-element-property :language src-block))
	 (lisp-p (string-match-p "lisp" lang)))
    (cond
     ;; Case 1.  Lisp Block
     (lisp-p
      (format "@lisp\n%s\n@end lisp" contents))
     ;; Case 2.  Other blocks
     (t
      (format "@example\n%s\n@end example" contents)))))


;;;; Statistics Cookie

(defun org-e-texinfo-statistics-cookie (statistics-cookie contents info)
  "Transcode a STATISTICS-COOKIE object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual information."
  (org-element-property :value statistics-cookie))


;;;; Strike-Through
;;
;; Strikethrough is ignored


;;;; Subscript

(defun org-e-texinfo-subscript (subscript contents info)
  "Transcode a SUBSCRIPT object from Org to Texinfo.
CONTENTS is the contents of the object.  INFO is a plist holding
contextual information."
  (format (if (= (length contents) 1) "$_%s$" "$_{\\mathrm{%s}}$") contents))


;;;; Superscript

(defun org-e-texinfo-superscript (superscript contents info)
  "Transcode a SUPERSCRIPT object from Org to Texinfo.
CONTENTS is the contents of the object.  INFO is a plist holding
contextual information."
  (format (if (= (length contents) 1) "$^%s$" "$^{\\mathrm{%s}}$") contents))


;;;; Table
;;
;; `org-e-texinfo-table' is the entry point for table transcoding.  It
;; takes care of tables with a "verbatim" attribute.  Otherwise, it
;; delegates the job to either `org-e-texinfo-table--table.el-table' or
;; `org-e-texinfo-table--org-table' functions, depending of the type of
;; the table.
;;
;; `org-e-texinfo-table--align-string' is a subroutine used to build
;; alignment string for Org tables.

(defun org-e-texinfo-table (table contents info)
  "Transcode a TABLE element from Org to Texinfo.
CONTENTS is the contents of the table.  INFO is a plist holding
contextual information."
  (cond
   ;; Case 1: verbatim table.
   ((or org-e-texinfo-tables-verbatim
	(let ((attr (mapconcat 'identity
			       (org-element-property :attr_latex table)
			       " ")))
	  (and attr (string-match "\\<verbatim\\>" attr))))
    (format "@verbatim \n%s\n@end verbatim"
	    ;; Re-create table, without affiliated keywords.
	    (org-trim
	     (org-element-interpret-data
	      `(table nil ,@(org-element-contents table))))))
   ;; Case 2: table.el table.  Convert it using appropriate tools.
   ((eq (org-element-property :type table) 'table.el)
    (org-e-texinfo-table--table.el-table table contents info))
   ;; Case 3: Standard table.
   (t (org-e-texinfo-table--org-table table contents info))))

(defun org-e-texinfo-table-column-widths (table info)
  "Determine the largest table cell in each column to process alignment.

TABLE is the table element to transcode.  INFO is a plist used as
a communication channel."
  (let* ((rows (org-element-map table 'table-row 'identity info))
	 (collected (loop for row in rows collect
			  (org-element-map
			   row 'table-cell 'identity info)))
	 (number-cells (length (car collected)))
	 cells counts)
    (loop for row in collected do
	  (push (mapcar (lambda (ref)
		     (let* ((start (org-element-property :contents-begin ref))
			    (end (org-element-property :contents-end ref))
			    (length (- end start)))
		       length)) row) cells))
    (setq cells (remove-if #'null cells))
    (push (loop for count from 0 to (- number-cells 1) collect
		   (loop for item in cells collect
			 (nth count item))) counts)
    (mapconcat '(lambda (size)
		  (make-string size ?a)) (mapcar (lambda (ref)
				   (apply 'max `,@ref)) (car counts))
	       "} {")
  ))

(defun org-e-texinfo-table--org-table (table contents info)
  "Return appropriate Texinfo code for an Org table.

TABLE is the table type element to transcode.  CONTENTS is its
contents, as a string.  INFO is a plist used as a communication
channel.

This function assumes TABLE has `org' as its `:type' attribute."
  (let* (
	 (columns (org-e-texinfo-table-column-widths table info))
	 )
    ;; Prepare the final format string for the table.
    (cond
     ;; Longtable.
     ;; Others.
     (t (concat
	 (format "@multitable {%s}\n%s@end multitable"
		 columns
		 contents))))))

(defun org-e-texinfo-table--table.el-table (table contents info)
  "Return appropriate Texinfo code for a table.el table.

TABLE is the table type element to transcode.  CONTENTS is its
contents, as a string.  INFO is a plist used as a communication
channel.

This function assumes TABLE has `table.el' as its `:type'
attribute."
  (require 'table)
  ;; Ensure "*org-export-table*" buffer is empty.
  (with-current-buffer (get-buffer-create "*org-export-table*")
    (erase-buffer))
  (let ((output (with-temp-buffer
		  (insert (org-element-property :value table))
		  (goto-char 1)
		  (re-search-forward "^[ \t]*|[^|]" nil t)
		  (table-generate-source 'latex "*org-export-table*")
		  (with-current-buffer "*org-export-table*"
		    (org-trim (buffer-string))))))
    (kill-buffer (get-buffer "*org-export-table*"))
    ;; Remove left out comments.
    (while (string-match "^%.*\n" output)
      (setq output (replace-match "" t t output)))
    ;; When the "rmlines" attribute is provided, remove all hlines but
    ;; the the one separating heading from the table body.
    (let ((attr (mapconcat 'identity
			   (org-element-property :attr_latex table)
			   " ")))
      (when (and attr (string-match "\\<rmlines\\>" attr))
	(let ((n 0) (pos 0))
	  (while (and (< (length output) pos)
		      (setq pos (string-match "^\\\\hline\n?" output pos)))
	    (incf n)
	    (unless (= n 2)
	      (setq output (replace-match "" nil nil output)))))))
    (if (not org-e-texinfo-tables-centered) output
      (format "\\begin{center}\n%s\n\\end{center}" output))))


;;;; Table Cell

(defun org-e-texinfo-table-cell (table-cell contents info)
  "Transcode a TABLE-CELL element from Org to Texinfo.
CONTENTS is the cell contents.  INFO is a plist used as
a communication channel."
  (concat (if (and contents
		   org-e-texinfo-table-scientific-notation
		   (string-match orgtbl-exp-regexp contents))
	      ;; Use appropriate format string for scientific
	      ;; notation.
	      (format org-e-texinfo-table-scientific-notation
		      (match-string 1 contents)
		      (match-string 2 contents))
	    contents)
	  (when (org-export-get-next-element table-cell) "\n@tab ")))


;;;; Table Row

(defun org-e-texinfo-table-row (table-row contents info)
  "Transcode a TABLE-ROW element from Org to Texinfo.
CONTENTS is the contents of the row.  INFO is a plist used as
a communication channel."
  ;; Rules are ignored since table separators are deduced from
  ;; borders of the current row.
  (when (eq (org-element-property :type table-row) 'standard) 
    (concat "@item " contents "\n")))


;;;; Target

(defun org-e-texinfo-target (target contents info)
  "Transcode a TARGET object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  (format "\\label{%s}"
	  (org-export-solidify-link-text (org-element-property :value target))))


;;;; Timestamp

(defun org-e-texinfo-timestamp (timestamp contents info)
  "Transcode a TIMESTAMP object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist holding contextual
information."
  (let ((value (org-translate-time (org-element-property :value timestamp)))
	(type (org-element-property :type timestamp)))
    (cond ((memq type '(active active-range))
	   (format org-e-texinfo-active-timestamp-format value))
	  ((memq type '(inactive inactive-range))
	   (format org-e-texinfo-inactive-timestamp-format value))
	  (t (format org-e-texinfo-diary-timestamp-format value)))))


;;;; Underline
;;
;; Underline is ignored


;;;; Verbatim

(defun org-e-texinfo-verbatim (verbatim contents info)
  "Transcode a VERBATIM object from Org to Texinfo.
CONTENTS is nil.  INFO is a plist used as a communication
channel."
  (org-e-texinfo--text-markup (org-element-property :value verbatim) 'verbatim))


;;;; Verse Block

(defun org-e-texinfo-verse-block (verse-block contents info)
  "Transcode a VERSE-BLOCK element from Org to Texinfo.
CONTENTS is verse block contents. INFO is a plist holding
contextual information."
  ;; In a verse environment, add a line break to each newline
  ;; character and change each white space at beginning of a line
  ;; into a space of 1 em.  Also change each blank line with
  ;; a vertical space of 1 em.
  (progn
    (setq contents (replace-regexp-in-string
		    "^ *\\\\\\\\$" "\\\\vspace*{1em}"
		    (replace-regexp-in-string
		     "\\(\\\\\\\\\\)?[ \t]*\n" " \\\\\\\\\n" contents)))
    (while (string-match "^[ \t]+" contents)
      (let ((new-str (format "\\hspace*{%dem}"
			     (length (match-string 0 contents)))))
	(setq contents (replace-match new-str nil t contents))))
    (format "\\begin{verse}\n%s\\end{verse}" contents)))


\f
;;; Interactive functions

(defun org-e-texinfo-export-to-texinfo
  (&optional subtreep visible-only body-only ext-plist pub-dir)
  "Export current buffer to a Texinfo file.

If narrowing is active in the current buffer, only export its
narrowed part.

If a region is active, export that region.

When optional argument SUBTREEP is non-nil, export the sub-tree
at point, extracting information from the headline properties
first.

When optional argument VISIBLE-ONLY is non-nil, don't export
contents of hidden elements.

When optional argument BODY-ONLY is non-nil, only write code
between \"\\begin{document}\" and \"\\end{document}\".

EXT-PLIST, when provided, is a property list with external
parameters overriding Org default settings, but still inferior to
file-local settings.

When optional argument PUB-DIR is set, use it as the publishing
directory.

Return output file's name."
  (interactive)
  (let ((outfile (org-export-output-file-name ".texi" subtreep pub-dir)))
    (org-export-to-file
     'e-texinfo outfile subtreep visible-only body-only ext-plist)))

(defun org-e-texinfo-export-to-info
  (&optional subtreep visible-only body-only ext-plist pub-dir)
  "Export current buffer to Texinfo then process through to INFO.

If narrowing is active in the current buffer, only export its
narrowed part.

If a region is active, export that region.

When optional argument SUBTREEP is non-nil, export the sub-tree
at point, extracting information from the headline properties
first.

When optional argument VISIBLE-ONLY is non-nil, don't export
contents of hidden elements.

When optional argument BODY-ONLY is non-nil, only write code
between \"\\begin{document}\" and \"\\end{document}\".

EXT-PLIST, when provided, is a property list with external
parameters overriding Org default settings, but still inferior to
file-local settings.

When optional argument PUB-DIR is set, use it as the publishing
directory.

Return INFO file's name."
  (interactive)
  (org-e-texinfo-compile
   (org-e-texinfo-export-to-texinfo
    subtreep visible-only body-only ext-plist pub-dir)))

(defun org-e-texinfo-compile (texifile)
  "Compile a texinfo file.

TEXIFILE is the name of the file being compiled.  Processing is
done through the command specified in `org-e-texinfo-info-process'.

Return INFO file name or an error if it couldn't be produced."
  (let* ((wconfig (current-window-configuration))
	 (texifile (file-truename texifile))
	 (base (file-name-sans-extension texifile))
	 errors)
    (message (format "Processing Texinfo file %s ..." texifile))
    (unwind-protect
	(progn
	  (cond
	   ;; A function is provided: Apply it.
	   ((functionp org-e-texinfo-info-process)
	    (funcall org-e-texinfo-info-process (shell-quote-argument texifile)))
	   ;; A list is provided: Replace %b, %f and %o with appropriate
	   ;; values in each command before applying it.  Output is
	   ;; redirected to "*Org INFO Texinfo Output*" buffer.
	   ((consp org-e-texinfo-info-process)
	    (let* ((out-dir (or (file-name-directory texifile) "./"))
		   (outbuf (get-buffer-create "*Org Info Texinfo Output*")))
	      (mapc
	       (lambda (command)
		 (shell-command
		  (replace-regexp-in-string
		   "%b" (shell-quote-argument base)
		   (replace-regexp-in-string
		    "%f" (shell-quote-argument texifile)
		    (replace-regexp-in-string
		     "%o" (shell-quote-argument out-dir) command t t) t t) t t)
		  outbuf))
	       org-e-texinfo-info-process)
	      ;; Collect standard errors from output buffer.
	      (setq errors (org-e-texinfo-collect-errors outbuf))))
	   (t (error "No valid command to process to Info")))
	  (let ((infofile (concat base ".info")))
	    ;; Check for process failure.  Provide collected errors if
	    ;; possible.
	    (if (not (file-exists-p infofile))
		(error (concat (format "INFO file %s wasn't produced" infofile)
			       (when errors (concat ": " errors))))
	      ;; Else remove log files, when specified, and signal end of
	      ;; process to user, along with any error encountered.
	      (message (concat "Process completed"
			       (if (not errors) "."
				 (concat " with errors: " errors)))))
	    ;; Return output file name.
	    infofile))
      (set-window-configuration wconfig))))

(defun org-e-texinfo-collect-errors (buffer)
  "Collect some kind of errors from \"pdflatex\" command output.

BUFFER is the buffer containing output.

Return collected error types as a string, or nil if there was
none."
  (with-current-buffer buffer
    (save-excursion
      (goto-char (point-max))
      ;; Find final "makeinfo" run.
      (when (re-search-backward "^[ \t]*This is pdf.*?TeX.*?Version" nil t)
	(let ((case-fold-search t)
	      (errors ""))
	  (when (save-excursion
		  (re-search-forward "Reference.*?undefined" nil t))
	    (setq errors (concat errors " [undefined reference]")))
	  (when (save-excursion
		  (re-search-forward "Citation.*?undefined" nil t))
	    (setq errors (concat errors " [undefined citation]")))
	  (when (save-excursion
		  (re-search-forward "Undefined control sequence" nil t))
	    (setq errors (concat errors " [undefined control sequence]")))
	  (when (save-excursion
		  (re-search-forward "^! LaTeX.*?Error" nil t))
	    (setq errors (concat errors " [LaTeX error]")))
	  (when (save-excursion
		  (re-search-forward "^! Package.*?Error" nil t))
	    (setq errors (concat errors " [package error]")))
	  (and (org-string-nw-p errors) (org-trim errors)))))))


(provide 'org-e-texinfo)
;;; org-e-texinfo.el ends here

^ permalink raw reply	[relevance 1%]

* Re: listings and the new LaTeX exporter
  @ 2012-05-24 20:58  7%   ` Andreas Leha
  0 siblings, 0 replies; 59+ results
From: Andreas Leha @ 2012-05-24 20:58 UTC (permalink / raw)
  To: emacs-orgmode

Hi Jambunathan,

> M-x customize-group RET org-export-e-latex RET
>
> (Hint: Search for listing)

Thanks for looking into this.  This variable is set to "t".

Sorry, that I did not give a more complete workflow of how I do *not* get
listings with the new LaTeX exporter.
This now follows.


Here is the .emacs.org
,----
| (add-to-list 'load-path (expand-file-name "~/local/emacs/org-mode-install/lisp"))
| (add-to-list 'auto-mode-alist '("\\.\\(org\\  |org_archive\\|txt\\)$" . org-mode))
| (require 'org-install)
| (require 'org-habit)
| 
| (add-to-list 'load-path (expand-file-name "~/local/emacs/org-mode/contrib/lisp"))
| (require 'org-export)
| 
| (global-set-key "\C-cl" 'org-store-link)
| (global-set-key "\C-ca" 'org-agenda)
| (global-set-key "\C-cb" 'org-iswitchb)
`----

I do emacs -Q -l .emacs.org, set the 'org-export-latex-listings to t and
run the org-export-dispatch "L" on this file:
,----
| #+TITLE: Test the listings
| 
| 
| * Some listing
| #+begin_src R
|   bh <- basehaz(coxmodel.cont.64)
| #+end_src
| 
| * Options							   :noexport:
| #+LaTeX_CLASS_OPTIONS: [11pt]
| #+LATEX_HEADER: \setlength{\parindent}{0pt}
| #+LATEX_HEADER: \setlength{\parskip}{1ex}
| #+LATEX_HEADER: \usepackage{listings}
| #+LATEX_HEADER: \usepackage{color}
| #+LATEX_HEADER: \definecolor{mylstback}{RGB}{200,200,200} % light gray
| #+LATEX_HEADER: \lstloadlanguages{R}
| #+LATEX_HEADER: \lstdefinelanguage{Renhanced}[]{R}{%
| #+LATEX_HEADER:   morekeywords={acf,ar,arima,arima.sim,colMeans,colSums,is.na,is.null,%
| #+LATEX_HEADER:                 mapply,ms,na.rm,nlmin,replicate,row.names,rowMeans,rowSums,seasonal,%
| #+LATEX_HEADER:                 sys.time,system.time,ts.plot,which.max,which.min},
| #+LATEX_HEADER:   deletekeywords={c},%
| #+LATEX_HEADER:   alsoletter={._\%},%
| #+LATEX_HEADER:   alsoother={:\$}}
| #+LATEX_HEADER: \lstset{%
| #+LATEX_HEADER:     extendedchars=true,%
| #+LATEX_HEADER:     basicstyle=\ttfamily\scriptsize, % the font that is used for the code
| #+LATEX_HEADER:     tabsize=4, % sets default tabsize to 4 spaces
| #+LATEX_HEADER:     numbers=left, % where to put the line numbers
| #+LATEX_HEADER:     numberstyle=\tiny, % line number font size
| #+LATEX_HEADER:     stepnumber=4, % step between two line numbers
| #+LATEX_HEADER:     breaklines=false, %!! don't break long lines of code
| #+LATEX_HEADER:     showtabs=false, % show tabs within strings adding particular underscores
| #+LATEX_HEADER:     showspaces=false, % show spaces adding particular underscores
| #+LATEX_HEADER:     showstringspaces=false, % underline spaces within strings
| #+LATEX_HEADER:     frame=tb,%
| #+LATEX_HEADER:     keywordstyle=\color{blue},
| #+LATEX_HEADER:     identifierstyle=\color{black},
| #+LATEX_HEADER:     stringstyle=\color{green},
| #+LATEX_HEADER:     commentstyle={\color{red}\ttfamily\itshape},
| #+LATEX_HEADER:     backgroundcolor=\color{mylstback}, % sets the background color
| #+LATEX_HEADER:     captionpos=t, % sets the caption position to `bottom'
| #+LATEX_HEADER:     extendedchars=false %!?? workaround for when the listed file is in UTF-8
| #+LATEX_HEADER: }
`----

The result is this:
,----
| % Created 2012-05-24 Do 22:52
| \documentclass[11pt]{article}
| \usepackage[utf8]{inputenc}
| \usepackage[T1]{fontenc}
| \usepackage{fixltx2e}
| \usepackage{graphicx}
| \usepackage{longtable}
| \usepackage{float}
| \usepackage{wrapfig}
| \usepackage{soul}
| \usepackage{textcomp}
| \usepackage{marvosym}
| \usepackage{wasysym}
| \usepackage{latexsym}
| \usepackage{amssymb}
| \usepackage{hyperref}
| \tolerance=1000
| \usepackage{color}
| \usepackage{listings}
| \setlength{\parindent}{0pt}
| \setlength{\parskip}{1ex}
| \usepackage{listings}
| \usepackage{color}
| \definecolor{mylstback}{RGB}{200,200,200} % light gray
| \lstloadlanguages{R}
| \lstdefinelanguage{Renhanced}[]{R}{%
| morekeywords={acf,ar,arima,arima.sim,colMeans,colSums,is.na,is.null,%
| mapply,ms,na.rm,nlmin,replicate,row.names,rowMeans,rowSums,seasonal,%
| sys.time,system.time,ts.plot,which.max,which.min},
| deletekeywords={c},%
| alsoletter={._\%},%
| alsoother={:\$}}
| \lstset{%
| extendedchars=true,%
| basicstyle=\ttfamily\scriptsize, % the font that is used for the code
| tabsize=4, % sets default tabsize to 4 spaces
| numbers=left, % where to put the line numbers
| numberstyle=\tiny, % line number font size
| stepnumber=4, % step between two line numbers
| breaklines=false, %!! don't break long lines of code
| showtabs=false, % show tabs within strings adding particular underscores
| showspaces=false, % show spaces adding particular underscores
| showstringspaces=false, % underline spaces within strings
| frame=tb,%
| keywordstyle=\color{blue},
| identifierstyle=\color{black},
| stringstyle=\color{green},
| commentstyle={\color{red}\ttfamily\itshape},
| backgroundcolor=\color{mylstback}, % sets the background color
| captionpos=t, % sets the caption position to `bottom'
| extendedchars=false %!?? workaround for when the listed file is in UTF-8
| }
| \providecommand{\alert}[1]{\textbf{#1}}
| \author{Andreas Leha}
| \date{\today}
| \title{Test the listings}
| \hypersetup{
|   pdfkeywords={},
|   pdfsubject={},
|   pdfcreator={Generated by Org mode 7.8.10 in Emacs 24.1.50.1.}}
| \begin{document}
| 
| \maketitle
| \tableofcontents
| \vspace*{1cm}
| 
| 
| 
| \section{Some listing}
| \label{sec-1}
| \begin{verbatim}
| bh <- basehaz(coxmodel.cont.64)
| \end{verbatim}
| % Generated by Org mode 7.8.10 in Emacs 24.1.50.1.
| \end{document}
`----

emacs-version: GNU Emacs 24.1.50.1 (x86_64-pc-linux-gnu, GTK+ Version 3.4.2) of 2012-05-22 on zelenka, modified by Debian
org-version: Org-mode version 7.8.10 (release_7.8.10-573-g7b33d9 @ /home/andreas/local/emacs/org-mode-install/lisp/)


Any other idea, what I am doing wrong here?

Cheers,
Andreas

^ permalink raw reply	[relevance 7%]

* Re: spot the LaTeX error
  2012-03-02  4:26  6% spot the LaTeX error Peter Salazar
  2012-03-02  4:34  0% ` Peter Salazar
@ 2012-03-02  9:33  0% ` Peter Salazar
  1 sibling, 0 replies; 59+ results
From: Peter Salazar @ 2012-03-02  9:33 UTC (permalink / raw)
  To: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 3592 bytes --]

With some help I was able to fix the problem. If anyone is interested in
the template, let me know and I can supply the corrected code.


On Thu, Mar 1, 2012 at 11:26 PM, Peter Salazar <cycleofsong@gmail.com>wrote:

> Not sure if this is the right forum for this question, so feel free to
> direct me elsewhere...
>
> I'm trying to quit Markdown and switch to org-mode completely. To do that,
> I need to get my LaTeX template working with org-mode.
>
> I had a LaTeX template I cobbled together and successfully used with
> Pandoc for Markdown -> LaTeX -> PDF.
>
> I tried to convert my template to work with org-mode, but I haven't had
> any success. The .tex file it generates looks valid as far as I can tell,
> but when I do org-export to LaTeX and open resulting PDF, it crashes Emacs.
>
> Here's what I added to my .emacs file. Can anyone see what I've done
> wrong? As may be apparent, I don't really know what I'm doing.
>
>
> (add-to-list 'org-export-latex-classes
>   '("salazar"
> "\\documentclass[12pt]{article}
> \\usepackage{float}
> \\usepackage{hyperref}
> \\usepackage{algorithm}
> \\usepackage{amsmath}
> \\usepackage{ifxetex}
> \\ifxetex
>   \\usepackage{fontspec,xltxtra,xunicode}
>   \\defaultfontfeatures{Mapping=tex-text,Scale=MatchLowercase}
>   \\setromanfont{Adobe Garamond Pro}
>   \\setsansfont{Arial}
>   \\setmonofont{Courier}
> \\else
>   \\usepackage[mathletters]{ucs}
>   \\usepackage[utf8x]{inputenc}
> \\fi
> \\usepackage{microtype}
> \\usepackage{fancyhdr}
> \\pagestyle{fancy}
> \\pagenumbering{arabic}
> \\lhead{\\href{mailto:cycleofsong@gmail.com}{Peter Salazar}}
> \\chead{\itshape}
> \\rhead{\\itshape{\\nouppercase{\\@title}: {\\nouppercase\\leftmark}}}
> \\lfoot{}
> \\cfoot{\\thepage}
> \\rfoot{}
> \\usepackage{listings}
>
> \\lstnewenvironment{code}{\\lstset{language=Haskell,basicstyle=\\small\\ttfamily}}{}
> \\setlength{\\parindent}{0pt}
> \\setlength{\\parskip}{12pt plus 2pt minus 1pt}
> \\usepackage{fancyvrb}
> \\usepackage{enumerate}
> \\usepackage{ctable}
> \\setlength{\\paperwidth}{8.5in}
> \\setlength{\\paperheight}{11in}
>  \\usepackage[margin=1.5in,hmargin=1.5in,vmargin=1.5in]{geometry}
>   \\tolerance=1000
> \\usepackage{tocloft}
> \\renewcommand{\\cftsecleader}{\\cftdotfill{\\cftdotsep}}
> \\usepackage[normalem]{ulem}
> \\newcommand{\\textsubscr}[1]{\\ensuremath{_{\\scriptsize\\textrm{#1}}}}
>
>
> \\usepackage[breaklinks=true,linktocpage,pdftitle={\\@title},pdfauthor={\\@author},xetex]{hyperref}
>
> \\usepackage{url}
> \\usepackage{graphicx}
> \\hypersetup{ colorlinks,
> citecolor=black,filecolor=black,linkcolor=black,urlcolor=blue}
> \\makeatletter
> \\def\\maketitle{
>   \\thispagestyle{empty}
>     \\vfill
>   \\begin{raggedright}
>   \\leavevmode
>     \\vskip 1cm
>     \{\\fontsize{50}{60}\\selectfont \\@title\\par}
>     \\vskip 1cm
>     \\normalfont
>     \{\\huge {\\@author\\par}}
>   \\vfill
>         \{\\Large Peter Salazar}
>     \\newline
>           \{\\Large \\href{mailto:cycleofsong@gmail.com}{
> cycleofsong@gmail.com}}
>         \\newline
>     \{\\Large \\@date\\par}
>    \\end{raggedright}
>   \\null
>   \\cleardoublepage
> \}
>       [NO-DEFAULT-PACKAGES]
>       [NO-PACKAGES]"
>      ("\\section{%s}" . "\\section*{%s}")
>      ("\\subsection{%s}" . "\\subsection*{%s}")
>      ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
>      ("\\paragraph{%s}" . "\\paragraph*{%s}")
>      ("\\subparagraph{%s}" . "\\subparagraph*{%s}")))
>
>
> (setq org-latex-to-pdf-process
>   '("xelatex -interaction nonstopmode %f"
>      "xelatex -interaction nonstopmode %f")) ;; for multiple passes
>
>

[-- Attachment #2: Type: text/html, Size: 5056 bytes --]

^ permalink raw reply	[relevance 0%]

* Re: spot the LaTeX error
  2012-03-02  4:26  6% spot the LaTeX error Peter Salazar
@ 2012-03-02  4:34  0% ` Peter Salazar
  2012-03-02  9:33  0% ` Peter Salazar
  1 sibling, 0 replies; 59+ results
From: Peter Salazar @ 2012-03-02  4:34 UTC (permalink / raw)
  To: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 3852 bytes --]

Correction: The setup below is no longer crashing my Emacs, but it does
produce a PDF with the following errors:

1. There's stray text at the top of the title page:
",23titletitle,,23authorauthor,"

2. In the top right header, the document title doesn't show up as I hoped
it would. Instead it shows the text: "title : 3"  --- and it's in in a
different font.

Any help appreciated. Thank you.



On Thu, Mar 1, 2012 at 11:26 PM, Peter Salazar <cycleofsong@gmail.com>wrote:

> Not sure if this is the right forum for this question, so feel free to
> direct me elsewhere...
>
> I'm trying to quit Markdown and switch to org-mode completely. To do that,
> I need to get my LaTeX template working with org-mode.
>
> I had a LaTeX template I cobbled together and successfully used with
> Pandoc for Markdown -> LaTeX -> PDF.
>
> I tried to convert my template to work with org-mode, but I haven't had
> any success. The .tex file it generates looks valid as far as I can tell,
> but when I do org-export to LaTeX and open resulting PDF, it crashes Emacs.
>
> Here's what I added to my .emacs file. Can anyone see what I've done
> wrong? As may be apparent, I don't really know what I'm doing.
>
>
> (add-to-list 'org-export-latex-classes
>   '("salazar"
> "\\documentclass[12pt]{article}
> \\usepackage{float}
> \\usepackage{hyperref}
> \\usepackage{algorithm}
> \\usepackage{amsmath}
> \\usepackage{ifxetex}
> \\ifxetex
>   \\usepackage{fontspec,xltxtra,xunicode}
>   \\defaultfontfeatures{Mapping=tex-text,Scale=MatchLowercase}
>   \\setromanfont{Adobe Garamond Pro}
>   \\setsansfont{Arial}
>   \\setmonofont{Courier}
> \\else
>   \\usepackage[mathletters]{ucs}
>   \\usepackage[utf8x]{inputenc}
> \\fi
> \\usepackage{microtype}
> \\usepackage{fancyhdr}
> \\pagestyle{fancy}
> \\pagenumbering{arabic}
> \\lhead{\\href{mailto:cycleofsong@gmail.com}{Peter Salazar}}
> \\chead{\itshape}
> \\rhead{\\itshape{\\nouppercase{\\@title}: {\\nouppercase\\leftmark}}}
> \\lfoot{}
> \\cfoot{\\thepage}
> \\rfoot{}
> \\usepackage{listings}
>
> \\lstnewenvironment{code}{\\lstset{language=Haskell,basicstyle=\\small\\ttfamily}}{}
> \\setlength{\\parindent}{0pt}
> \\setlength{\\parskip}{12pt plus 2pt minus 1pt}
> \\usepackage{fancyvrb}
> \\usepackage{enumerate}
> \\usepackage{ctable}
> \\setlength{\\paperwidth}{8.5in}
> \\setlength{\\paperheight}{11in}
>  \\usepackage[margin=1.5in,hmargin=1.5in,vmargin=1.5in]{geometry}
>   \\tolerance=1000
> \\usepackage{tocloft}
> \\renewcommand{\\cftsecleader}{\\cftdotfill{\\cftdotsep}}
> \\usepackage[normalem]{ulem}
> \\newcommand{\\textsubscr}[1]{\\ensuremath{_{\\scriptsize\\textrm{#1}}}}
>
>
> \\usepackage[breaklinks=true,linktocpage,pdftitle={\\@title},pdfauthor={\\@author},xetex]{hyperref}
>
> \\usepackage{url}
> \\usepackage{graphicx}
> \\hypersetup{ colorlinks,
> citecolor=black,filecolor=black,linkcolor=black,urlcolor=blue}
> \\makeatletter
> \\def\\maketitle{
>   \\thispagestyle{empty}
>     \\vfill
>   \\begin{raggedright}
>   \\leavevmode
>     \\vskip 1cm
>     \{\\fontsize{50}{60}\\selectfont \\@title\\par}
>     \\vskip 1cm
>     \\normalfont
>     \{\\huge {\\@author\\par}}
>   \\vfill
>         \{\\Large Peter Salazar}
>     \\newline
>           \{\\Large \\href{mailto:cycleofsong@gmail.com}{
> cycleofsong@gmail.com}}
>         \\newline
>     \{\\Large \\@date\\par}
>    \\end{raggedright}
>   \\null
>   \\cleardoublepage
> \}
>       [NO-DEFAULT-PACKAGES]
>       [NO-PACKAGES]"
>      ("\\section{%s}" . "\\section*{%s}")
>      ("\\subsection{%s}" . "\\subsection*{%s}")
>      ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
>      ("\\paragraph{%s}" . "\\paragraph*{%s}")
>      ("\\subparagraph{%s}" . "\\subparagraph*{%s}")))
>
>
> (setq org-latex-to-pdf-process
>   '("xelatex -interaction nonstopmode %f"
>      "xelatex -interaction nonstopmode %f")) ;; for multiple passes
>
>

[-- Attachment #2: Type: text/html, Size: 5445 bytes --]

^ permalink raw reply	[relevance 0%]

* spot the LaTeX error
@ 2012-03-02  4:26  6% Peter Salazar
  2012-03-02  4:34  0% ` Peter Salazar
  2012-03-02  9:33  0% ` Peter Salazar
  0 siblings, 2 replies; 59+ results
From: Peter Salazar @ 2012-03-02  4:26 UTC (permalink / raw)
  To: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 3176 bytes --]

Not sure if this is the right forum for this question, so feel free to
direct me elsewhere...

I'm trying to quit Markdown and switch to org-mode completely. To do that,
I need to get my LaTeX template working with org-mode.

I had a LaTeX template I cobbled together and successfully used with Pandoc
for Markdown -> LaTeX -> PDF.

I tried to convert my template to work with org-mode, but I haven't had any
success. The .tex file it generates looks valid as far as I can tell, but
when I do org-export to LaTeX and open resulting PDF, it crashes Emacs.

Here's what I added to my .emacs file. Can anyone see what I've done wrong?
As may be apparent, I don't really know what I'm doing.


(add-to-list 'org-export-latex-classes
  '("salazar"
"\\documentclass[12pt]{article}
\\usepackage{float}
\\usepackage{hyperref}
\\usepackage{algorithm}
\\usepackage{amsmath}
\\usepackage{ifxetex}
\\ifxetex
  \\usepackage{fontspec,xltxtra,xunicode}
  \\defaultfontfeatures{Mapping=tex-text,Scale=MatchLowercase}
  \\setromanfont{Adobe Garamond Pro}
  \\setsansfont{Arial}
  \\setmonofont{Courier}
\\else
  \\usepackage[mathletters]{ucs}
  \\usepackage[utf8x]{inputenc}
\\fi
\\usepackage{microtype}
\\usepackage{fancyhdr}
\\pagestyle{fancy}
\\pagenumbering{arabic}
\\lhead{\\href{mailto:cycleofsong@gmail.com}{Peter Salazar}}
\\chead{\itshape}
\\rhead{\\itshape{\\nouppercase{\\@title}: {\\nouppercase\\leftmark}}}
\\lfoot{}
\\cfoot{\\thepage}
\\rfoot{}
\\usepackage{listings}
\\lstnewenvironment{code}{\\lstset{language=Haskell,basicstyle=\\small\\ttfamily}}{}
\\setlength{\\parindent}{0pt}
\\setlength{\\parskip}{12pt plus 2pt minus 1pt}
\\usepackage{fancyvrb}
\\usepackage{enumerate}
\\usepackage{ctable}
\\setlength{\\paperwidth}{8.5in}
\\setlength{\\paperheight}{11in}
 \\usepackage[margin=1.5in,hmargin=1.5in,vmargin=1.5in]{geometry}
  \\tolerance=1000
\\usepackage{tocloft}
\\renewcommand{\\cftsecleader}{\\cftdotfill{\\cftdotsep}}
\\usepackage[normalem]{ulem}
\\newcommand{\\textsubscr}[1]{\\ensuremath{_{\\scriptsize\\textrm{#1}}}}

\\usepackage[breaklinks=true,linktocpage,pdftitle={\\@title},pdfauthor={\\@author},xetex]{hyperref}

\\usepackage{url}
\\usepackage{graphicx}
\\hypersetup{ colorlinks,
citecolor=black,filecolor=black,linkcolor=black,urlcolor=blue}
\\makeatletter
\\def\\maketitle{
  \\thispagestyle{empty}
    \\vfill
  \\begin{raggedright}
  \\leavevmode
    \\vskip 1cm
    \{\\fontsize{50}{60}\\selectfont \\@title\\par}
    \\vskip 1cm
    \\normalfont
    \{\\huge {\\@author\\par}}
  \\vfill
        \{\\Large Peter Salazar}
    \\newline
          \{\\Large \\href{mailto:cycleofsong@gmail.com}{
cycleofsong@gmail.com}}
        \\newline
    \{\\Large \\@date\\par}
   \\end{raggedright}
  \\null
  \\cleardoublepage
\}
      [NO-DEFAULT-PACKAGES]
      [NO-PACKAGES]"
     ("\\section{%s}" . "\\section*{%s}")
     ("\\subsection{%s}" . "\\subsection*{%s}")
     ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
     ("\\paragraph{%s}" . "\\paragraph*{%s}")
     ("\\subparagraph{%s}" . "\\subparagraph*{%s}")))


(setq org-latex-to-pdf-process
  '("xelatex -interaction nonstopmode %f"
     "xelatex -interaction nonstopmode %f")) ;; for multiple passes

[-- Attachment #2: Type: text/html, Size: 4513 bytes --]

^ permalink raw reply	[relevance 6%]

* Re: Refresh of http://orgmode.org
  @ 2011-12-15  4:11  9%         ` Eric Schulte
  0 siblings, 0 replies; 59+ results
From: Eric Schulte @ 2011-12-15  4:11 UTC (permalink / raw)
  To: Bastien; +Cc: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 1071 bytes --]

>>
>> Mh.. your screen seems quite small.  If you can fix the .css to display
>> the website better on your screen, please do, I don't have time at hand
>> now to do it myself.
>>

The attached three patches to the orgweb repository change the CSS for
smarter rendering on narrow screens (they don't address screen height).

The changes include...
- scale down images on narrow screens
- decrease the width of the left link bar on narrow screens
- decrease the padding around the title on narrow screens
- shrink the paypal link on smaller screens -- I would like to move this
  button on really small screens, but somehow that doesn't seem possible
- remove the Org-mode image on really small screens
- remove the twitter feed on narrow screens -- for some reason I was
  unable to change the size of this widget, so I just hide it on a tiny
  screen

These changes make the new website work on my system, and should improve
the reading experience for everyone who keeps their browser screens less
than 1400 pixels wide.

If these look good please apply them.

Thanks,


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-ignoring-exported-html-indices.patch --]
[-- Type: text/x-patch, Size: 460 bytes --]

From 9bb86f8c206e2b749c9c49c4ad33f11e07e4f3fc Mon Sep 17 00:00:00 2001
From: Eric Schulte <eric.schulte@gmx.com>
Date: Wed, 14 Dec 2011 20:30:02 -0700
Subject: [PATCH 1/3] ignoring exported html indices

---
 .gitignore |    1 +
 1 files changed, 1 insertions(+), 0 deletions(-)
 create mode 100644 .gitignore

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..dcaf716
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+index.html
-- 
1.7.8


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #3: 0002-shrink-links-and-remove-twitter-on-narrow-screens.patch --]
[-- Type: text/x-patch, Size: 3880 bytes --]

From e262903d6d21173d786c15d4e4db155d466c8407 Mon Sep 17 00:00:00 2001
From: Eric Schulte <eric.schulte@gmx.com>
Date: Wed, 14 Dec 2011 20:30:28 -0700
Subject: [PATCH 2/3] shrink links and remove twitter on narrow screens

---
 org.css |  147 +++++++++++++++++++++++++++++++++++----------------------------
 1 files changed, 82 insertions(+), 65 deletions(-)

diff --git a/org.css b/org.css
index cce24dd..ad6785e 100644
--- a/org.css
+++ b/org.css
@@ -96,50 +96,87 @@ h1.title {
     font-family: Courier New;

 }

 

-#linklist 

-{

-    position: fixed;

-    font-size: 13pt;

-    font-family: Courier New; 

-    padding-top: 0px;

-    padding-right: 0px;

-    top: 107px;

-    left: 0px;

-    margin-top: 0px;

-    width: 180px;

-    background-color: #fff;

-    color: black;

-    box-shadow: 8px 8px 12px #ccc;

-    -webkit-border-bottom-right-radius: 10px;

-    -moz-border-radius-bottomright: 10px;

-    z-index: 100;

-}

-

-#linklist a {

-    color: black;

-    font-weight: normal; 

-    text-decoration: none;

-    display:block;

-    padding: 7pt;

-}

-

-#linklist ul {

-    margin: 0;

-    padding: 0;

-}

-

-#linklist li {

-    text-align: right;

-    margin: 0;

-}

-

-.timestamp {

-    font-family: Courier New;

-    color: #888888;

-}

-

-#linklist li:hover {

-    border-left: 7px solid #537d7b;

+@media all {

+    #linklist 

+    {

+        position: fixed;

+        font-size: 13pt;

+        font-family: Courier New; 

+        padding-top: 0px;

+        padding-right: 0px;

+        top: 107px;

+        left: 0px;

+        margin-top: 0px;

+        width: 180px;

+        background-color: #fff;

+        color: black;

+        box-shadow: 8px 8px 12px #ccc;

+        -webkit-border-bottom-right-radius: 10px;

+        -moz-border-radius-bottomright: 10px;

+        z-index: 100;

+    }

+

+    #linklist a {

+        color: black;

+        font-weight: normal; 

+        text-decoration: none;

+        display:block;

+        padding: 7pt;

+    }

+

+    #linklist ul {

+        margin: 0;

+        padding: 0;

+    }

+

+    #linklist li {

+        text-align: right;

+        margin: 0;

+    }

+

+    .timestamp {

+        font-family: Courier New;

+        color: #888888;

+    }

+

+    #linklist li:hover {

+        border-left: 7px solid #537d7b;

+    }

+

+    #twit {

+        /* -moz-opacity:.2; */

+        /* opacity: .2; */

+        /* filter:alpha(opacity=20); */

+        position: fixed;

+        top: 362px;

+        box-shadow: 8px 8px 12px #ccc;

+        -webkit-border-bottom-right-radius: 10px;

+        -moz-border-radius-bottomright: 10px;

+        z-index: 100;

+    }

+

+    .outline-2 {

+        position: relative;

+        top: 105px;

+        left: 215px;

+        width: 75%;

+        padding-bottom: 5pt;

+    }

+}

+

+@media all and (max-width: 700px){

+    #linklist{

+        width: 130px;

+    }

+    #linklist a{

+        font-size: 10pt;

+    }

+    #twit{

+        display: none;

+    }

+    .outline-2 {

+        left: 145px;

+    }

 }

 

 pre {

@@ -176,26 +213,6 @@ pre {
     filter:alpha(opacity=100);

 }

 

-.outline-2 {

-    position: relative;

-    left: 215px;

-    top: 105px;

-    width: 75%;

-    padding-bottom: 5pt;

-}

-

-#twit {

-    /* -moz-opacity:.2; */

-    /* opacity: .2; */

-    /* filter:alpha(opacity=20); */

-    position: fixed;

-    top: 362px;

-    box-shadow: 8px 8px 12px #ccc;

-    -webkit-border-bottom-right-radius: 10px;

-    -moz-border-radius-bottomright: 10px;

-    z-index: 100;

-}

-

 /* #twit:hover { */

 /*     -moz-opacity:1; */

 /*     opacity: 1; */

@@ -314,7 +331,7 @@ li {
 }

 

 img.random {

-    max-width: 750px;

+    max-width: 75%;

     max-height: 380px;

     margin-bottom: 10pt;

     border: 1px solid black;

-- 
1.7.8


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #4: 0003-title-width-adjusts-appropriately-given-window-width.patch --]
[-- Type: text/x-patch, Size: 2483 bytes --]

From 67762c50047bbbfb71d87245b791c02cc9dcf234 Mon Sep 17 00:00:00 2001
From: Eric Schulte <eric.schulte@gmx.com>
Date: Wed, 14 Dec 2011 21:02:28 -0700
Subject: [PATCH 3/3] title width adjusts appropriately given window width

---
 org.css |   69 ++++++++++++++++++++++++++++++++++++++++++++++----------------
 1 files changed, 51 insertions(+), 18 deletions(-)

diff --git a/org.css b/org.css
index ad6785e..8cbe0c3 100644
--- a/org.css
+++ b/org.css
@@ -13,7 +13,6 @@ body {
 }

 

 .title {

-    background: url(http://orgmode.org/org-mode-unicorn.png) no-repeat 12px 5px;

     position: fixed;

     display: inline;

     left: 0px;

@@ -41,14 +40,6 @@ body {
     z-index: 98;

 }

 

-#paypal {

-    position:fixed;

-    right: 10px;

-    top: 15px;

-    z-index: 100;

-    text-align: center;

-}

-

 #paypal a {

     font-family: Courier new;

     cursor: pointer;

@@ -88,15 +79,23 @@ body {
     padding-top: 15px;

 }

 

-h1.title {

-    text-shadow: 2px 2px 4px #999;

-    padding-top: 23px;

-    padding-left: 70pt;

-    font-size: 23pt;

-    font-family: Courier New;

-}

-

 @media all {

+    #paypal {

+        position:fixed;

+        right: 10px;

+        top: 15px;

+        z-index: 100;

+        text-align: center;

+    }

+

+    h1.title {

+        text-shadow: 2px 2px 4px #999;

+        padding-top: 23px;

+        padding-left: 0pt;

+        font-size: 23pt;

+        font-family: Courier New;

+    }

+

     #linklist 

     {

         position: fixed;

@@ -164,7 +163,36 @@ h1.title {
     }

 }

 

+@media all and (min-width: 1400px){

+    padding-left: 75pt;

+}

+

+@media all and (min-width: 650px){

+    .title{

+        background: url(http://orgmode.org/org-mode-unicorn.png) no-repeat 12px 5px;

+    }

+}

+

+@media all and (max-width: 750px){

+    #paypal{

+        position: absolute;

+        top: 2px;

+        right: 2px;

+    }

+    #paypal a{

+        width: 60px;

+        font-size: 8pt;

+    }

+    #paypal a:hover {

+        width: 60px; 

+        font-size: 8pt;

+    }

+}

+

 @media all and (max-width: 700px){

+    h1.title{

+        padding-left: 0pt;

+    }

     #linklist{

         width: 130px;

     }

@@ -174,9 +202,14 @@ h1.title {
     #twit{

         display: none;

     }

-    .outline-2 {

+    .outline-2{

         left: 145px;

     }

+    #paypal{

+        position:fixed;

+        left: 0px;

+        top: 362px;

+    }

 }

 

 pre {

-- 
1.7.8


[-- Attachment #5: Type: text/plain, Size: 47 bytes --]


-- 
Eric Schulte
http://cs.unm.edu/~eschulte/

^ permalink raw reply related	[relevance 9%]

* Re: how to do footers
  2011-10-19 15:35 10% ` John Hendy
@ 2011-10-19 15:38  0%   ` Mehul Sanghvi
  0 siblings, 0 replies; 59+ results
From: Mehul Sanghvi @ 2011-10-19 15:38 UTC (permalink / raw)
  To: John Hendy; +Cc: emacs-orgmode

On Wed, Oct 19, 2011 at 11:35, John Hendy <jw.hendy@gmail.com> wrote:
> On Wed, Oct 19, 2011 at 10:27 AM, Mehul Sanghvi <mehul.sanghvi@gmail.com> wrote:
>> I know that Org can do foot notes using fn:xxx but what I wanted to do
>> was put a
>> footer to every page that is created.  It would be the same thing on each page.
>>
>> How would I do that ?  Either I missed it in the manual or it is not there.
>
> If this for LaTeX, you get into that realm vs. org-specific, in my
> opinion (though some may suggest tailoring the org export innards).
> Check out the following:
> -- http://texblog.wordpress.com/2007/11/07/headerfooter-in-latex-with-fancyhdr/
> -- http://en.wikibooks.org/wiki/LaTeX/Page_Layout#Customising_with_fancyhdr
>
> Here's an example from a recent paper for work. I have this below my
> #+options lines and before the first headline:
> -----
> #+begin_latex
> \pagestyle{fancy}
> \setlength{\headheight}{0pt}
> \setlength{\footskip}{40pt}
> \renewcommand{\headrulewidth}{0pt}
> \fancyhf{}
> \cfoot{\thepage}
> \rfoot{\includegraphics[height=7.4pt]{/path/to/company-logo.jpg} Confidential}
> \newpage
> #+end_latex
> -----
>

Actually its going to be for Org -> ODT -> {PDF, DOC, RTF}


> John
>
>>
>>
>>
>>
>> --
>> Mehul N. Sanghvi
>> email: mehul.sanghvi@gmail.com
>>
>>
>



-- 
Mehul N. Sanghvi
email: mehul.sanghvi@gmail.com

^ permalink raw reply	[relevance 0%]

* Re: how to do footers
  @ 2011-10-19 15:35 10% ` John Hendy
  2011-10-19 15:38  0%   ` Mehul Sanghvi
  0 siblings, 1 reply; 59+ results
From: John Hendy @ 2011-10-19 15:35 UTC (permalink / raw)
  To: Mehul Sanghvi; +Cc: emacs-orgmode

On Wed, Oct 19, 2011 at 10:27 AM, Mehul Sanghvi <mehul.sanghvi@gmail.com> wrote:
> I know that Org can do foot notes using fn:xxx but what I wanted to do
> was put a
> footer to every page that is created.  It would be the same thing on each page.
>
> How would I do that ?  Either I missed it in the manual or it is not there.

If this for LaTeX, you get into that realm vs. org-specific, in my
opinion (though some may suggest tailoring the org export innards).
Check out the following:
-- http://texblog.wordpress.com/2007/11/07/headerfooter-in-latex-with-fancyhdr/
-- http://en.wikibooks.org/wiki/LaTeX/Page_Layout#Customising_with_fancyhdr

Here's an example from a recent paper for work. I have this below my
#+options lines and before the first headline:
-----
#+begin_latex
\pagestyle{fancy}
\setlength{\headheight}{0pt}
\setlength{\footskip}{40pt}
\renewcommand{\headrulewidth}{0pt}
\fancyhf{}
\cfoot{\thepage}
\rfoot{\includegraphics[height=7.4pt]{/path/to/company-logo.jpg} Confidential}
\newpage
#+end_latex
-----

John

>
>
>
>
> --
> Mehul N. Sanghvi
> email: mehul.sanghvi@gmail.com
>
>

^ permalink raw reply	[relevance 10%]

* Bug: File Links [6.33x]
@ 2011-09-22 13:27  7% Edward N. Lewis
  0 siblings, 0 replies; 59+ results
From: Edward N. Lewis @ 2011-09-22 13:27 UTC (permalink / raw)
  To: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 4991 bytes --]

To: emacs-orgmode@gnu.org
Subject: Bug: File Links [6.33x]
From: ed.lewis@enlewis.com (Edward N. Lewis)
--text follows this line--
 

Remember to cover the basics, that is, what you expected to happen and
what in fact did happen.  You don't know how to make a good report?  See
 
      <http://orgmode.org/manual/Feedback.html#Feedback>
http://orgmode.org/manual/Feedback.html#Feedback
 
Your bug report will be posted to the Org-mode mailing list.
------------------------------------------------------------------------
 
Links to external pdf files do not work in org-mode. Links do not export
properly
into PDF files. Links to web addresses and other file types such as text
files work fine, however.
 
To reproduce: create a link in your org file in any form,
e.g. [[file:/full_path/whatever.pdf]],
[[file:/full_path/whatever.pdf][Label for file]], file:whatever.pdf.
 
1) The link will not work from within org-mode.
2) The link will not be properly formatted when viewed in a PDF viewer
such as Adobe Acrobat Professional. To make the link work, the link's
properties have to be manually edited from within Adobe Acrobat/
 
Emacs  : GNU Emacs 23.2.1 (i386-redhat-linux-gnu, GTK+ Version 2.24.4)
 of 2011-05-23 on x86-05.phx2.fedoraproject.org
Package: Org-mode version 6.33x
 
current state:
==============
(setq
 org-export-with-sub-superscripts '{}
 org-export-latex-date-format "%B %d, %Y"
 org-after-todo-state-change-hook '(org-clock-out-if-current)
 org-export-preprocess-hook '(org-export-blocks-preprocess)
 org-tab-first-hook '(org-hide-block-toggle-maybe)
 org-src-mode-hook '(org-src-mode-configure-edit-buffer)
 org-confirm-shell-link-function 'yes-or-no-p
 org-agenda-before-write-hook '(org-agenda-add-entry-text)
 org-cycle-hook '(org-cycle-hide-archived-subtrees org-cycle-hide-drawers
    org-cycle-show-empty-lines
    org-optimize-window-after-visibility-change)
 org-export-latex-classes '(("article"
        "
<file://\\documentclass[12pt]{article}\n\\setlength{\\parindent}{0pt}\n\\ren
ewcommand{\\familydefault}{\\sfdefault>
\\documentclass[12pt]{article}\n\\setlength{\\parindent}{0pt}\n\\renewcomman
d{\\familydefault}{\\sfdefault}"
        (" <file://\\section{%s> \\section{%s}" . " <file://\\section*{%s>
\\section*{%s}")
        (" <file://\\subsection{%s> \\subsection{%s}" . "
<file://\\subsection*{%s> \\subsection*{%s}")
        (" <file://\\subsubsection{%s> \\subsubsection{%s}" . "
<file://\\subsubsection*{%s> \\subsubsection*{%s}")
        (" <file://\\paragraph{%s> \\paragraph{%s}" . "
<file://\\paragraph*{%s> \\paragraph*{%s}")
        (" <file://\\subparagraph{%s> \\subparagraph{%s}" . "
<file://\\subparagraph*{%s> \\subparagraph*{%s}"))
       ("report"
        "
<file://\\documentclass[11pt]{report}\n\\usepackage[utf8]{inputenc}\n\\usepa
ckage[T1]{fontenc}\n\\usepackage{graphicx}\n\\usepackage{longtable}\n\\usepa
ckage{hyperref>
\\documentclass[11pt]{report}\n\\usepackage[utf8]{inputenc}\n\\usepackage[T1
]{fontenc}\n\\usepackage{graphicx}\n\\usepackage{longtable}\n\\usepackage{hy
perref}"
        (" <file://\\part{%s> \\part{%s}" . " <file://\\part*{%s>
\\part*{%s}")
        (" <file://\\chapter{%s> \\chapter{%s}" . " <file://\\chapter*{%s>
\\chapter*{%s}")
        (" <file://\\section{%s> \\section{%s}" . " <file://\\section*{%s>
\\section*{%s}")
        (" <file://\\subsection{%s> \\subsection{%s}" . "
<file://\\subsection*{%s> \\subsection*{%s}")
        (" <file://\\subsubsection{%s> \\subsubsection{%s}" . "
<file://\\subsubsection*{%s> \\subsubsection*{%s}"))
       ("book"
        "
<file://\\documentclass[11pt]{book}\n\\usepackage[utf8]{inputenc}\n\\usepack
age[T1]{fontenc}\n\\usepackage{graphicx}\n\\usepackage{longtable}\n\\usepack
age{hyperref>
\\documentclass[11pt]{book}\n\\usepackage[utf8]{inputenc}\n\\usepackage[T1]{
fontenc}\n\\usepackage{graphicx}\n\\usepackage{longtable}\n\\usepackage{hype
rref}"
        (" <file://\\part{%s> \\part{%s}" . " <file://\\part*{%s>
\\part*{%s}")
        (" <file://\\chapter{%s> \\chapter{%s}" . " <file://\\chapter*{%s>
\\chapter*{%s}")
        (" <file://\\section{%s> \\section{%s}" . " <file://\\section*{%s>
\\section*{%s}")
        (" <file://\\subsection{%s> \\subsection{%s}" . "
<file://\\subsection*{%s> \\subsection*{%s}")
        (" <file://\\subsubsection{%s> \\subsubsection{%s}" . "
<file://\\subsubsection*{%s> \\subsubsection*{%s}"))
       )
 org-mode-hook '(#[nil "\300\301\302\303\304$\207"
     [org-add-hook change-major-mode-hook org-show-block-all
      append local]
     5]
   )
 org-confirm-elisp-link-function 'yes-or-no-p
 org-occur-hook '(org-first-headline-recenter)
 )
-- 
Edward N. Lewis, PE
PO Box 611
Worthington, MA  01098-0611
USA
+1 413-238-0109
 <mailto:ed.lewis@enlewis.com> ed.lewis@enlewis.com

 
Edward N. Lewis, PE
PO Box 611
Worthington, MA  01098-0611
USA
+1 413-238-0109
ed.lewis@enlewis.com
 
 

[-- Attachment #2: Type: text/html, Size: 10306 bytes --]

^ permalink raw reply	[relevance 7%]

* Re: Using orgmode to take "inline notes" for research
  2011-04-17 23:36  8%                     ` Rasmus
@ 2011-04-20 17:46  0%                       ` Eric S Fraga
  0 siblings, 0 replies; 59+ results
From: Eric S Fraga @ 2011-04-20 17:46 UTC (permalink / raw)
  To: Rasmus; +Cc: emacs-orgmode

Rasmus <rasmus.pank@gmail.com> writes:

>> It is cool but doesn't play well with margins, as you have seen.  I've
>> given up on cool and use the following instead:
>
> I agree on the cool not being cool. However, I do wonder why you would
> want to use /ordinary/ footnotes rather than something easily removable
> such as fixmenotes, e.g. \fxnote[footnote]. The great thing is they are
> removed in the `final' print (i.e. when `draft' is not specified).

Sure, this would be a good thing for many to use.  I don't require this
because the documents I create have (or should have) no footnotes in the
final version so any footnotes that are present are things I have to
deal with!  But thanks for pointing me to this alternative.

>>> - Some of my notes are multi paragraphs, which I prefer non-indented
>>> and separated by a line break rather than no line break and indented.
>>> But when exported, multiple paragraphs just "stack up" with no line
>>> break. Can I add this to your format?
>
> I use the following for empty lines. It is quite easy to adopt it
> document wide and probably even inside certain environments.
>
>    \newcommand*{\tomlinje}[0]{\\[\baselineskip] \setlength{\parskip}{0pt}}
>
> I didn't get whether you are asking for footnotes specifically, but if
> this is the case you might be able to play around with
> \setlength{\footparindent}{} and friends?

Will do.  Did not know about \footparindent and my searches did not find
any reference to such!  Thanks.

-- 
: Eric S Fraga (GnuPG: 0xC89193D8FFFCF67D) in Emacs 24.0.50.1
: using Org-mode version 7.5 (release_7.5.183.g1997)

^ permalink raw reply	[relevance 0%]

* Re: Using orgmode to take "inline notes" for research
  @ 2011-04-17 23:36  8%                     ` Rasmus
  2011-04-20 17:46  0%                       ` Eric S Fraga
  0 siblings, 1 reply; 59+ results
From: Rasmus @ 2011-04-17 23:36 UTC (permalink / raw)
  To: emacs-orgmode


> It is cool but doesn't play well with margins, as you have seen.  I've
> given up on cool and use the following instead:

I agree on the cool not being cool. However, I do wonder why you would
want to use /ordinary/ footnotes rather than something easily removable
such as fixmenotes, e.g. \fxnote[footnote]. The great thing is they are
removed in the `final' print (i.e. when `draft' is not specified).

>> - Some of my notes are multi paragraphs, which I prefer non-indented
>> and separated by a line break rather than no line break and indented.
>> But when exported, multiple paragraphs just "stack up" with no line
>> break. Can I add this to your format?

I use the following for empty lines. It is quite easy to adopt it
document wide and probably even inside certain environments.

   \newcommand*{\tomlinje}[0]{\\[\baselineskip] \setlength{\parskip}{0pt}}

I didn't get whether you are asking for footnotes specifically, but if
this is the case you might be able to play around with
\setlength{\footparindent}{} and friends?

Cheers,
Rasmus

-- 
Sent from my Emacs

^ permalink raw reply	[relevance 8%]

* Re: Professional PDF LaTeX templates?
  @ 2011-03-17 12:06  6%   ` Russell Adams
  0 siblings, 0 replies; 59+ results
From: Russell Adams @ 2011-03-17 12:06 UTC (permalink / raw)
  To: emacs-orgmode

On Wed, Mar 16, 2011 at 10:54:18AM -0400, Nick Dokos wrote:
> 'Mash <mashdot@toshine.net> wrote:
>
> >
> > I suppose by "professional" I really meant "polished", and so it is
> > LaTeX styling I have having trouble with, it may also be laziness on
> > my part. I have tried searching for LaTeX styling which I can
> > translate into a few org-mode header declarations but still can't work
> > out what is or is not compatible with org-mode (LaTeX classes) or how
> > to implement styling correctly.
> >

I understand completely! So here's a few tricks I use.

First, my org-class for latex is "none". This lets me manage my
documentclass and other features in the org export header.

(setq org-export-latex-classes (cons '("none"
									   "[NO-DEFAULT-PACKAGES][NO-PACKAGES]"
									   ("\\section{%s}" . "\\section*{%s}")
									   ("\\subsection{%s}" . "\\subsection*{%s}")
									   ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
									   ("\\paragraph{%s}" . "\\paragraph*{%s}")
									   ("\\subparagraph{%s}" . "\\subparagraph*{%s}"))
									 org-export-latex-classes))

Then, my documents start like this:

----------------------------------------------------------------------
#+OPTIONS:   H:3 num:nil toc:t \n:t @:t ::t |:t ^:nil -:t f:t *:t TeX:t LaTeX:nil skip:nil d:nil tags:not-in-toc
#+BIND: org-export-latex-title-command ""
#+LaTeX_CLASS: none
#+LATEX_HEADER: \documentclass[10pt,letterpaper]{article}
#+LATEX_HEADER: \usepackage[letterpaper,includeheadfoot,top=0.5in,bottom=0.5in,left=0.75in,right=0.75in]{geometry}
#+LATEX_HEADER: \usepackage[utf8]{inputenc}
#+LATEX_HEADER: \usepackage[T1]{fontenc}
#+LATEX_HEADER: \usepackage{lastpage}
#+LATEX_HEADER: \usepackage{fancyhdr}
#+LATEX_HEADER: \pagestyle{fancy}
#+LATEX_HEADER: \usepackage{hyperref}
#+LATEX_HEADER: \hypersetup{colorlinks,linkcolor=blue}
#+LATEX_HEADER: \renewcommand{\headrulewidth}{1pt}
#+LATEX_HEADER: \renewcommand{\footrulewidth}{0.5pt}
#+LATEX_HEADER: \usepackage{graphicx}
#+LATEX_HEADER: \usepackage{multicol}
#+LATEX_HEADER: \geometry{headheight=47pt}
#+LATEX_HEADER:
#+LATEX_HEADER: \def\ORGTITLE      {Latex Example}
#+LATEX_HEADER: \def\ORGAUTHOR     {Russell Adams}
#+LATEX_HEADER:
#+LATEX_HEADER: % Header
#+LATEX_HEADER: \fancyhead[L]{\LARGE \ORGTITLE  }
#+LATEX_HEADER: \fancyhead[R]{\bf    \ORGAUTHOR }
#+LATEX_HEADER:
#+LATEX_HEADER: % Footer
#+LATEX_HEADER: \fancyfoot[L]{\small \ORGTITLE\\ \today}
#+LATEX_HEADER: \fancyfoot[C]{\small Revision: \Revision \\ Page \thepage\ of \pageref{LastPage}}
#+LATEX_HEADER: \fancyfoot[R]{\small \ORGAUTHOR }

----------------------------------------------------------------------


That way I can control all of the output in the Org file. I intend to
make a custom class eventually for letterhead, but haven't yet.

Other ones to experiment with are:

\setlength{\parindent}{0pt}   - Don't indent each paragraph (pet peeve)
\setlength{\parskip}{10pt}    - Add a small indent between paragraps

Better fonts:

\usepackage[scaled]{helvet}
\renewcommand*\familydefault{\sfdefault}

I also don't export from inside emacs. I use a makefile and call a
separate emacs instance in batch mode.

> > There are a huge amount of LaTeX examples on the web, but they are
> > full documents with inline elements, I wanted to know if anyone has
> > already setup classes that work, with notes on LaTeX dependencies (and
> > how and where to download them from) which they use day to day to
> > produce reports, articles, contracts or client proposals from simple
> > .org files?

I know there are many pre-made classes available for Latex,
unfortunately I haven't found any good "galleries" of sample
output. That makes it difficult to know where to start.

Let me know if you find one!

> Both Eric Fraga and John Hendy have given valid answers to how one goes
> about it: you settle down to *one* kind of document that you want to
> produce (take the simplest one and leave the rest for later), then
> either learn enough LaTeX to be able to produce it or cajole/beg/hire
> somebody to do it for you, and *then* figure out how to use org to produce
> the LaTeX needed to produce that kind of document.
>
> The trouble is that neither org nor LaTeX are black boxes whose insides
> you can afford to ignore. With the approach outlined above, at the end
> of the process, you *will* have a (blackbox-like) almost automatic way of
> going from org to "professional" output, but it is fragile in the sense
> that if you want to change something, you will need to implement the
> change in LaTeX first, and once you are satisfied with the output, you
> will need to go back and tweak the org mechanisms to produce that.
> Then you can shut your eyes again and pretend that it's a black box.
>
> So learn some LaTeX: once you get past the initial hump (the mechanics
> of producing output), then it's not only fairly easy, it also starts
> making sense. Having a desired output (keep it simple!) is going to make
> that an enjoyable journey too. And once you touch down on LaTeX island,
> and become comfortable, you'll either never leave or you'll want to
> visit again and again!

I agree, learn some Latex too. Org's another layer, but much more
convenient.

Good luck!

------------------------------------------------------------------
Russell Adams                            RLAdams@AdamsInfoServ.com

PGP Key ID:     0x1160DCB3           http://www.adamsinfoserv.com/

Fingerprint:    1723 D8CA 4280 1EC9 557F  66E8 1154 E018 1160 DCB3

^ permalink raw reply	[relevance 6%]

* Re: conditional export based on target
  @ 2010-11-02 19:41 10%   ` Ezequiel Birman
  0 siblings, 0 replies; 59+ results
From: Ezequiel Birman @ 2010-11-02 19:41 UTC (permalink / raw)
  To: emacs-orgmode

>>>>> "JP" == Juan Pechiar <juan@pechiar.com> writes:

    > On Thu, Oct 07, 2010 at 01:24:28AM -0300, Ezequiel Birman wrote:
    >> Is there something like conditional export? I'd like to use tikz
    >> when exporting to latex but my own hand-made ascii drawing when
    >> exporting to ascii/latin1/utf8.

    > Hi,

    > I've been thinking on your request, and today this appeared on the
    > list which is quite similar:

    > http://lists.gnu.org/archive/html/emacs-orgmode/2010-10/msg01106.html

    > It seems as if block settings can be lisp function calls rather
    > than a fixed string.

    > So, for example:

    > //------------------------------------------------------------ **
    > Test conditional export

    > #+source: test_output #+begin_src octave :results value vector
    > :exports (if (and (boundp 'htmlp) htmlp) "none" "results" )
    > rand(2) #+end_src

    > #+results: test_output | 0.3982018019389448 | 0.3879818701032038 |
    > | 0.8053847746148466 | 0.3333630867175288
    > | ------------------------------------------------------------

    > Will export nothing to HTML, and the resulting output to other
    > formats.

    > Values for 'exports' can be 'both', 'none', 'code' or 'results';
    > and there are export flags latexp, htmlp, asciip, docbookp.

    > I tested the above example, and it "mostly" works. Sometimes not,
    > and I don't yet know why.

Thank you Juan. This seems to work *always*. I had to remove the
'results: ...' portion but I don't understand why...

#+source: tree1_latex
#+BEGIN_SRC latex :exports (if (and (boundp 'latexp) latexp) "results" "none")
  \begin{tikzpicture}
    [every node/.style={draw,fill=white,circle,inner sep=0pt,minimum size=1em},
     level distance=3em,
     level 1/.style={sibling distance=8em},
     level 2/.style={sibling distance=4em},
     level 3/.style={sibling distance=2em}]
    \node [level distance=0pt,style={draw=none,minimum size=0pt}] {}
      child {node {} edge from parent [draw=none]
        child {node {} 
          child {node {} }
          child {node [style={fill=black}] {}}}
        child {node [style={fill=black}] {}
          child {node {} }
          child {node [style={fill=black}] {} }}}
      child {node [style={fill=black}] {} edge from parent [draw=none]
        child {node {}
          child {node {} }
          child {node [style={fill=black}] {} }}
        child {node [style={fill=black}] {}
          child {node {}}
          child {node [draw=none,style={shade}] {} edge from parent [dashed]}}};
    \end{tikzpicture}
#+end_src

#+source: tree1_ascii
#+BEGIN_SRC emacs-lisp :exports (if (and (boundp 'asciip) asciip) "results" "none")
"        B               N\\\\
      /   \\           /   \\\\\\
    B       N       B       N\\\\
   / \\     / \\     / \\     / \\\\\\
  B   N   B   N   B   N   B  (N)"
#+END_SRC

I still don't know how to export the TikZ code to latex but a png or svg
(generated by TikZ) to html.

Also, if anyone can think of a better or different approach I'll be
thankful.

-- 
Ezequiel Birman

^ permalink raw reply	[relevance 10%]

* horiontal alignment of tables in latex export?
@ 2010-09-03 16:08  5% Matt Price
  0 siblings, 0 replies; 59+ results
From: Matt Price @ 2010-09-03 16:08 UTC (permalink / raw)
  To: emacs-orgmode


[-- Attachment #1.1: Type: text/plain, Size: 439 bytes --]

Are tables always aligned in the center of the page when exported to latex?
I have a simple table that I want to put on the left hand side of the page
instead.  The html output is just what I want, but the pdf generated via
latex puts the table in the (horizontal) center of the page.  file attached
-- it's the same file I've been having other issues with in other posts.
thanks thanks thanks again, after many questions this week.

matt

[-- Attachment #1.2: Type: text/html, Size: 462 bytes --]

[-- Attachment #2: His495Outline.org --]
[-- Type: application/octet-stream, Size: 13052 bytes --]

#+POSTID: 10
#+AUTHOR:    Matt Price
#+EMAIL:     matt.price@utoronto.ca
#+TITLE:     History 495Y: Hacking History
#+DATE:      2010-06-06 Sun
#+DESCRIPTION: 
#+KEYWORDS: 
#+LANGUAGE:  en
#+OPTIONS:   H:3 num:nil toc:nil \n:nil @:t ::t |:t ^:t -:t f:t *:t <:t
#+OPTIONS:   TeX:t LaTeX:nil skip:nil d:nil todo:t pri:nil tags:not-in-toc
#+INFOJS_OPT: view:nil toc:nil ltoc:t mouse:underline buttons:0 path:http://orgmode.org/org-info.js
#+EXPORT_SELECT_TAGS: export
#+EXPORT_EXCLUDE_TAGS: noexport
#+LINK_UP:   
#+LINK_HOME: 
#+LATEX_HEADER: \usepackage[letterpaper]{geometry}
#+LATEX_HEADER: \geometry{verbose,tmargin=2.5cm,bmargin=2.5cm,lmargin=2cm,rmargin=2cm}%
#+LATEX_HEADER: \usepackage{paralist}
#+LATEX_HEADER: \let\itemize\compactitem
#+LATEX_HEADER: \let\description\compactdesc
#+LATEX_HEADER: \let\enumerate\compactenum
#+LATEX_HEADER: \usepackage[small,compact,calcwidth]{titlesec}
#+LATEX_HEADER: \titlespacing{\section}{0pt}{*1}{*0.2}
#+LATEX_HEADER: \titlespacing{\subsection}{5}{*0}{*0}
#+LATEX_HEADER: \titlespacing{\subsubsection}{10pt}{*0}{*0}
# #+LATEX_HEADER: \usepackage{enumitem}
# #+LaTeX: \setitemize{nolistsep}
# #+LaTeX: \setitemize{noitemsep}
# #+latex-header: % this makes list spacing much better.
# #+latex-header: %
# #+latex-header: \newenvironment{my_enumerate}{
# #+latex-header: \begin{enumerate}
# #+latex-header:   \setlength{\itemsep}{1pt}
# #+latex-header:   \setlength{\parskip}{0pt}
# #+latex-header:   \setlength{\parsep}{0pt}}{\end{enumerate}
# #+latex-header: }

"In what ways can digital media and digital networks allow us to do our work as historians better?" -- Cohen & Rosenzweig
* _Introduction_ 
This year-long course examines the relationships among academic history, digital media, and community formation using a variety of texts and methods; it culminates in an intensive semester-long digital storytelling project focused on community engagement.  The intellectual focus of the first semester is two-fold: first, on the history of the public sphere and second, on the politics of "engaged" scholarship.  At the same time, students will be exposed to techniques of multimedia and nonlinear storytelling.  The second semester revolves around a group project undertaken in concert with a community organization.  Working closely with their community partners, students will build a digital archive or storytelling framework using multimedia and/or social networking technologies.  The fundamental aim of the course is to expand the reach of historical scholarship outside of the academy, and to develop modes of historical research compatible with community engagement.
* _Course Structure_
** First Semester
In the first semester we will meet on a weekly basis to discuss the week's readings ("Readings" in the [[Outline: Semester 1][outline]]) and work together on a technical or interpretative task that will be defined in advance ("Lab" in the [[outline1][outline]]).  In advance of the class meeting students will generally be expected to produce written responses to the readings in the form of blog postings, and to respond to the postings of at least two other students.  In certain weeks there are other types of assignments; these are noted in the outline and referred to in the course requirements.  In general the aim is to foster an atmosphere of collaborative and self-directed learning in which all work is focused on building the analytic resources, technical skills, and confidence to create really great projects in the second semester.  Though the assignment structure is fixed, readings may change based on student interests.
** Second Semester
In the second semester it is expected that students will spend most of their time working directly on their project with the partnering organization.  We will meet as needed, probably about twice a week, to discuss specific technical questions raised by the projects themselves.  However, it is still expected that students will make regular postings about their progress, and comment on each other's writing.  In general, it is expected that the second-semester projects will also be collaborations.  
* _<<<Course Requirements>>>_
The emphasis will be on steady, consistent work.  Students are required to make weekly contributions to the online postings to the class website, and to comment on other postings.  There are also weekly technical assignments, which serve as the basis for the lab portion of the course.The second semester is largely taken up by the final project, which counts for 50% of the grade and in the course of which blog postings will continue to be required.  Grade distribution:
- online commentary 20%
- lab assignments 20%
- in-class participation 10%
- Final Project (including ancillary assignments) 50%
** Project Timetable
Sept. 16: Detailed assignment handed out with preliminary partner suggestions
Oct. 28: Presentation of preliminary project proposal.  
Dec. 2: Presentation of Final Proposal
Jan 10: Internship begins (approximate)
Feb 24: Intermediate Status Report
Apr. 7: Project Open House

** Grading of Posts and Labs
Posts and labs will be graded in the old-fashioned 0-4 system, where 0 represents and F and 4 an A.  The assignments will be summed and averaged, then converted to a UofT-style numerical grade.  
# <<texts>>
* Texts
All texts for this course are online, either in the public web or as pdfs.  Most of them are publicly available. You may want physical copies of come books;  these are available at amazon or by special order from any sizable bookstore. 
- Cohen & Rosenzweig, /Digital History/ (http://chnm.gmu.edu/digitalhistory/)
- C. Kelty, /Two Bits/ (http://twobits.net/read/)
- P. Gralla, /How The Internet Works/ (7th or 8th Edition)
A sizable collection of links is also provided on the course website and reproduced via [[http://www.deli.cio.us][deli.cio.us]].  The course bibliography is maintained at http://www.zotero.org/.  
#<<outline1>>
* _Outline: Semester 1_
** 1. What is History For? (2010-09-16) 
Why we should write history, why everyone should do it, and why that means we need the Web.  Hacker cultures, collaborative learning, knowledge sharing, non-expert culture.  
Background: [[http://www.journalofamericanhistory.org/issues/952/interchange/index.html][JAH - The Promise of Digital History]]
*** Lab:  Introduction to Wordpress & the course site.  Blogging & social media review. Preliminary listing of potential NGO partners. 
** 2. <2010-09-23 Thu> [[file:HackingHistory/HistoryAndPublicSphere.org::*History%20and%20the%20Public%20Sphere][History and the Public Sphere]]
On our notion of "public sphere", where it comes from and how it's changing.  
*** Readings:
- J. Habermas, "The Public Sphere: Encyclopedia Article" (http://www.sociol.unimi.it/docenti/barisione/documenti/File/2008-09/Habermas%20(1964)%20-%20The%20Public%20Sphere.pdf) 
- Mark Poster, "Cyberdemocracy" (http://www.hnet.uci.edu/mposter/writings/democ.html) 
- Wikileaks Afghan War Diary (http://wikileaks.org/wiki/Afghan_War_Diary,_2004-2010) 
- Wikileaks Collateral Murder video (http://www.wikileaks.org/wiki/Collateral_Murder,_5_Apr_2010)
*** Lab: The Wikileaks Episode
- how does Wikileaks work?  What does it say about the impact of the web on politics and analysis?  
** 3. <2010-09-30 Thu> [[file:HackingHistory/LanguageOfTheWeb.org::*The%20Language%20of%20the%20Web][The Language of the Web]]
How the Internet works, and what that means for historical narrative.
*** Readings
- Vannevar Bush, "As We May Think" (http://www.theatlantic.com/magazine/archive/1969/12/as-we-may-think/3881/)
- Tim Berners'Lee, /Weaving the Web/ Ch. 2,4.  
- Tim Berners'Lee, "[[http://www.scientificamerican.com/article.cfm?id=the-semantic-web][The Semantic Web]]" 
- Edward L. Ayers, "[[http://www.vcdh.virginia.edu/Ayers.OAH.html][History in Hypertext]]"
- Rus Shuler, "[[http://www.theshulers.com/whitepapers/internet_whitepaper/index.html][How Does the Internet Work?]]
*** Lab: HTML:  the language of the web 
** 4. <2010-10-07 Thu> Recursive Publics
the significance of free software; the recursive relation and its possible significance for other disciplines
*** Readings:
- Richard Stallman, "[[http://www.gnu.org/gnu/manifesto.html][The GNU Manifesto]]" and "[[http://www.gnu.org/philosophy/free-sw.html][The Free Software Definition]]"
- Eric Raymond, "[[http://catb.org/esr/writings/homesteading/cathedral-bazaar/][The Cathedral and the Bazaar]]"
- Kelty, Ch. 1 & 9.
- Creative Commons Licences: http://creativecommons.org/licenses/
- Dan Cohen, "[[http://www.dancohen.org/2009/05/12/idealism-and-pragmatism-in-the-free-culture-movement/][Idealism and Pragmatism in the Free Culture Movement]]"
*** Lab: Markup, Data and Metadata
the transformations your text makes between you, your audience, and your machine readers.  Background: [[http://digitalhumanities.org/dhq/vol/3/3/000064/000064.html][XML, Interoperability and the Social Construction of Markup Languages: The Library Example]]
** 5. <2010-10-14 Thu> Abundant Information and the Digitial Divide
How does the generalized availability of massive amounts of information abundance change the role of the historian?
*** Readings:
- Dan Cohen and Roy Rosenzweig, "Becoming digital" ch. 6 in /Digital History/
- Katie Hafner, "History, Digital (and Abridged)" (http://www.nytimes.com/2007/03/10/business/yourmoney/11archive.html?pagewanted=all)
- Philip and Harpold, "Of Bugs and Rats" (http://pmc.iath.virginia.edu/text-only/issue.900/11.1harpoldphilip.txt)
- Geoff Bowker, "Classification and Large-Scale Infrastructure", /Sorting Things Out/ 
- Geoff bowker, "The Local Knowledge of a Globalizing Ethnos" /Memory Practices in the Sciences/, ch. 5.
*** Lab: Search Tools
Using google scholar, zotero, and private search indexes. Background: [[http://digitalhistoryhacks.blogspot.com/2005/12/teaching-young-historians-to-search.html][Teaching Young Historians to Search, Spider and Scrape]]
** 6. <2010-10-21 Thu> Crowdsourcing 
The new kinds of collaboration that the web makes possible, and the intelletual challenges they create.
*** Readings:
- R. Rosenzweig, "Can History be Open Source?" (http://chnm.gmu.edu/essays-on-history-new-media/essays/?essayid=42)
- Dan Cohen, "The Spider and the Web" (http://www.dancohen.org/2009/04/16/the-spider-and-the-web-a-crowdsourcing-experiment/)
- Steven Friess, "50000 Join Distributed Search for Steve Fossett", /Wired/ 09.11.07 (http://www.wired.com/software/webservices/news/2007/09/distributed_search)
- Nawvieskie, "[[http://digitalhistory.wikispot.org/H9808A_2009_05_Social][Collex]]"
- Wyman et al, "[[http://www.archimuse.com/mw2006/papers/wyman/wyman.html][Steve.museum: An Ongoing Experiment in Social Tagging, Folksonomy, and Museums]]"
*** Lab:  Wikipedia Tracking Assignment
A look at the inner workings of the world's biggest crowdsourcing project.  
** 7. <2010-10-28 Thu> Project Presentation iteration 1 
First presentation of project ideas for constructive criticism. No Readings.
*** Lab: Critique and Improvement of colleagues' project proposals.
** 8. Engaged History    
what does it mean to be an 'engaged' scholar?  Virtues and vices.
*** Readings:
- Massey, Doreen. “Places and Their Pasts.” History Workshop Journal 39 (Spring 1995): 182-192
- Novick, Robert "The Defense of the West," ch. 6 of /That Noble Dream/ 
- Said, Edward W. “Invention, Memory, and Place.” Critical Inquiry 26 (Winter 2000): 175-192
-  William L. Niemi and David J. Plante, "Democratic Movements, Self-Education, and Economic Democracy: Chartists, Populists, and Wobblies" /Radical History Review/ 2008(102): 185-200
*** Lab: Setting up Wordpress:  A Trial Run
Set up mockups -- install plugins -- create users.     
** 9. Oral History
One remarkable possibility opened up by the web is abundant oral history.
*** Readings: 
- "The Voice of the Past", "What Makes Oral History Different" and "Learning to Listen in /The Oral History Reader/
*** Lab:Oral History Exercise
    Topic TBA    
** 10. Working with Communities    
The ethics of working with laypeople, and the promises & pitfalls of collaborating with non-academics.
*** Readings:
TBA
*** Lab: Collaborative Goal Definition
** 11. Great History Websites    
A look at some excellent history websites
*** Readings:  
TBA (Websites only!)
*** Lab: Website dissection

** 12. Project Presentation iteration 2    
Presentation of proposals, including plans, mockups, etc. No readings.
# <<outline2>>    
* _Outline Semester 2_
In the second semester we will meet only every second week, to help make time for you to work with your community partner.  You will still be required to post weekly updates to the /course/ blog, while collecting materials and building the infrastructure for your final projects.  Topics discussed in class meetings will be defined by your needs, but a tentative list of topics includes:
- Defining your project goals
- Data Capture and Metadata
- Copyright Issues
- Video on the Web
- Audio Post-Processing
- Website look and Feel
- Basic Scripting
- Project Open House    
    

[-- Attachment #3: His495Outline.tex --]
[-- Type: application/x-tex, Size: 15291 bytes --]

[-- Attachment #4: Type: text/plain, Size: 201 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Please use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 5%]

* Re: possible tex export bug?
  2010-09-03 14:18  5% possible tex export bug? Matt Price
@ 2010-09-03 14:21  2% ` Matt Price
  0 siblings, 0 replies; 59+ results
From: Matt Price @ 2010-09-03 14:21 UTC (permalink / raw)
  To: emacs-orgmode


[-- Attachment #1.1: Type: text/plain, Size: 13613 bytes --]

On Fri, Sep 3, 2010 at 10:18 AM, Matt Price <moptop99@gmail.com> wrote:

> Sorry for the barrage of help requests.  I don't know much about tex but
> it's possible the tex output from one file I am working on is buggy, as
> mk4ht refuses to read it.  The .org and .tex files are attached, as is the
> initial error output of mk4ht oolatex His495Ouline.tex.  This is perhaps the
> wrong list to be asking on, but I am sort of working from the assumption
> that there's an issue with the tex code that org produces -- mk4ht seems to
> work fine with simpler documents.  I';m using a pretty recent org-mode (7.01
> from not that long ago).
>
> Thanks much!
>
> matt
>
>
failed ot include the error output:
$ mk4ht oolatex His495Outline.tex
mk4ht (2008-06-28-19:09)
(mk4ht cfg)
/usr/share/tex4ht/htlatex His495Outline.tex "xhtml,ooffice" "ooffice/!
-cmozhtf" "-cooxtpipes -coo"
This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009/Debian)
 restricted \write18 enabled.
entering extended mode
LaTeX2e <2009/09/24>
Babel <v3.8l> and hyphenation patterns for english, usenglishmax, dumylang,
noh
yphenation, loaded.
(./His495Outline.tex (/usr/share/texmf-texlive/tex/latex/base/article.cls
Document Class: article 2007/10/19 v1.4h Standard LaTeX document class
(/usr/share/texmf-texlive/tex/latex/base/size11.clo))
(/usr/share/texmf/tex/generic/tex4ht/tex4ht.sty)
(/usr/share/texmf/tex/generic/tex4ht/usepackage.4ht)
(/usr/share/texmf-texlive/tex/latex/base/inputenc.sty
(/usr/share/texmf-texlive/tex/latex/base/utf8.def
(/usr/share/texmf-texlive/tex/latex/base/t1enc.dfu)
(/usr/share/texmf-texlive/tex/latex/base/ot1enc.dfu)
(/usr/share/texmf-texlive/tex/latex/base/omsenc.dfu)))
(/usr/share/texmf-texlive/tex/latex/base/fontenc.sty
(/usr/share/texmf-texlive/tex/latex/base/t1enc.def))
(/usr/share/texmf-texlive/tex/latex/base/fixltx2e.sty)
(/usr/share/texmf-texlive/tex/latex/graphics/graphicx.sty
(/usr/share/texmf-texlive/tex/latex/graphics/keyval.sty)
(/usr/share/texmf-texlive/tex/latex/graphics/graphics.sty
(/usr/share/texmf-texlive/tex/latex/graphics/trig.sty)
(/etc/texmf/tex/latex/config/graphics.cfg)
(/usr/share/texmf-texlive/tex/latex/graphics/dvips.def)))
(/usr/share/texmf-texlive/tex/latex/tools/longtable.sty)
(/usr/share/texmf-texlive/tex/latex/float/float.sty)
(/usr/share/texmf-texlive/tex/latex/wrapfig/wrapfig.sty)
(/usr/share/texmf-texlive/tex/latex/soul/soul.sty)
(/usr/share/texmf-texlive/tex/latex/base/t1enc.sty)
(/usr/share/texmf-texlive/tex/latex/base/textcomp.sty
(/usr/share/texmf-texlive/tex/latex/base/ts1enc.def
(/usr/share/texmf-texlive/tex/latex/base/ts1enc.dfu)))
(/usr/share/texmf-texlive/tex/latex/marvosym/marvosym.sty)
(/usr/share/texmf-texlive/tex/latex/wasysym/wasysym.sty)
(/usr/share/texmf-texlive/tex/latex/base/latexsym.sty)
(/usr/share/texmf-texlive/tex/latex/amsfonts/amssymb.sty
(/usr/share/texmf-texlive/tex/latex/amsfonts/amsfonts.sty))
(/usr/share/texmf-texlive/tex/latex/hyperref/hyperref.sty
(/usr/share/texmf-texlive/tex/generic/oberdiek/ifpdf.sty)
(/usr/share/texmf-texlive/tex/generic/oberdiek/ifvtex.sty)
(/usr/share/texmf-texlive/tex/generic/ifxetex/ifxetex.sty)
(/usr/share/texmf-texlive/tex/latex/oberdiek/hycolor.sty
(/usr/share/texmf-texlive/tex/latex/oberdiek/xcolor-patch.sty))
(/usr/share/texmf-texlive/tex/latex/hyperref/pd1enc.def)
(/usr/share/texmf-texlive/tex/generic/oberdiek/etexcmds.sty
(/usr/share/texmf-texlive/tex/generic/oberdiek/infwarerr.sty))
(/usr/share/texmf-texlive/tex/latex/latexconfig/hyperref.cfg)
(/usr/share/texmf-texlive/tex/latex/oberdiek/kvoptions.sty
(/usr/share/texmf-texlive/tex/generic/oberdiek/kvsetkeys.sty))
Implicit mode ON; LaTeX internals redefined
(/usr/share/texmf-texlive/tex/latex/ltxmisc/url.sty)
(/usr/share/texmf-texlive/tex/generic/oberdiek/bitset.sty
(/usr/share/texmf-texlive/tex/generic/oberdiek/intcalc.sty)
(/usr/share/texmf-texlive/tex/generic/oberdiek/bigintcalc.sty
(/usr/share/texmf-texlive/tex/generic/oberdiek/pdftexcmds.sty
(/usr/share/texmf-texlive/tex/generic/oberdiek/ifluatex.sty)
(/usr/share/texmf-texlive/tex/generic/oberdiek/ltxcmds.sty))))
(/usr/share/texmf-texlive/tex/generic/oberdiek/atbegshi.sty)
Hyperref stopped early
)
*hyperref using driver htex4ht*
(/usr/share/texmf-texlive/tex/latex/hyperref/htex4ht.def
hyperref tex4ht: tex4ht already loaded
) (/usr/share/texmf-texlive/tex/latex/savetrees/savetrees.sty
(/usr/share/texmf-texlive/tex/latex/titlesec/titlesec.sty)
(/usr/share/texmf-texlive/tex/latex/geometry/geometry.sty)
(/usr/share/texmf-texlive/tex/latex/tools/calc.sty))
(/usr/share/texmf/tex/generic/tex4ht/tex4ht.4ht
::::::::::::::::::::::::::::::::::::::::::
 TeX4ht info is available in the log file
::::::::::::::::::::::::::::::::::::::::::
) (/usr/share/texmf/tex/generic/tex4ht/tex4ht.sty
(/usr/share/texmf-texlive/tex/latex/graphics/color.sty
(/etc/texmf/tex/latex/config/color.cfg)
(/usr/share/texmf-texlive/tex/latex/graphics/dvipsnam.def))
l.804 --- TeX4ht warning --- nonprimitive \everypar ---
--- needs --- tex4ht His495Outline ---
(./His495Outline.tmp) (./His495Outline.xref)
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/latex.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/fontmath.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht [1]
(/usr/share/texmf-texlive/tex/latex/wasysym/uwasy.fd)

LaTeX Font Warning: Font shape `U/wasy/b/n' in size <8> not available
(Font)              Font shape `U/wasy/m/n' tried instead on input line
1375.


LaTeX Font Warning: Font shape `U/wasy/b/n' in size <6> not available
(Font)              Font shape `U/wasy/m/n' tried instead on input line
1375.

(/usr/share/texmf-texlive/tex/latex/base/ulasy.fd)
(/usr/share/texmf-texlive/tex/latex/amsfonts/umsa.fd)
(/usr/share/texmf-texlive/tex/latex/amsfonts/umsb.fd) [2] [3] [4] [5] [6]
[7] [8] [9] [10] [11] [12] [13] [14] [15] [16] [17] [18] [19] [20] [21]
[22] [23] [24] [25] [26] [27] [28] [29] [30] [31] [32] [33] [34] [35] [36]
[37] [38] [39] [40] [41] [42] [43] [44] [45] [46] [47] [48] [49] [50] [51]
[52] [53]) (/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/article.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/inputenc.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/utf8.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/graphicx.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/graphics.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/dvips.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/longtable.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/float.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/wrapfig.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/soul.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/amssymb.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht [54] [55] [56] [57] [58]
[59] [60] [61] [62] [63] [64] [65] [66] [67] [68] [69] [70] [71] [72] [73]
[74] [75] [76] [77] [78] [79] [80] [81] [82] [83] [84] [85] [86] [87] [88]
[89] [90] [91] [92] [93] [94] [95] [96] [97] [98] [99] [100] [101] [102]
[103] [104] [105] [106] [107] [108] [109] [110] [111] [112] [113] [114]
[115] [116] [117] [118] [119] [120] [121] [122] [123] [124] [125] [126]
[127] [128] [129] [130] [131] [132] [133] [134] [135] [136] [137] [138]
[139] [140] [141] [142] [143] [144] [145] [146] [147] [148] [149] [150]
[151] [152] [153] [154] [155] [156] [157] [158] [159] [160] [161] [162]
[163] [164] [165] [166] [167] [168] [169] [170] [171] [172] [173] [174]
[175] [176] [177] [178] [179] [180] [181] [182] [183] [184] [185] [186]
[187] [188] [189] [190] [191] [192] [193] [194] [195] [196] [197] [198]
[199] [200] [201] [202] [203] [204] [205] [206] [207] [208] [209] [210]
[211] [212] [213] [214] [215] [216] [217] [218] [219] [220] [221] [222]
[223] [224] [225] [226] [227] [228] [229] [230] [231] [232] [233] [234]
[235] [236] [237] [238] [239] [240] [241] [242] [243] [244] [245] [246]
[247] [248] [249] [250] [251] [252] [253] [254] [255] [256] [257])
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/amsfonts.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/hyperref.4ht
(/usr/share/texmf-texlive/tex/latex/hyperref/nameref.sty
(/usr/share/texmf-texlive/tex/latex/oberdiek/refcount.sty))
(/usr/share/texmf/tex/generic/tex4ht/nameref.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/pd1enc.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/url.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/titlesec.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/color.4ht
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/dvipsnam.4ht
(/usr/share/texmf-texlive/tex/latex/graphics/dvipsnam.def)
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht))
(/usr/share/texmf/tex/generic/tex4ht/ooffice.4ht)
(/usr/share/texmf/tex/generic/tex4ht/unicode.4ht)
(/usr/share/texmf/tex/generic/tex4ht/mathml.4ht)
(/usr/share/texmf/tex/generic/tex4ht/ooffice-mml.4ht)) (./His495Outline.aux)
(/usr/share/texmf-texlive/tex/latex/base/ts1cmr.fd)
*geometry auto-detecting driver*
*geometry detected driver: dvips*
! You can't use `\relax' after \the.
\NoHtmlEnv ....0pt\ht:everypar {\the \ht:everypar
                                                  }
l.26 \begin{document}

?


--------------------------
m

[-- Attachment #1.2: Type: text/html, Size: 14888 bytes --]

[-- Attachment #2: Type: text/plain, Size: 201 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Please use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 2%]

* possible tex export bug?
@ 2010-09-03 14:18  5% Matt Price
  2010-09-03 14:21  2% ` Matt Price
  0 siblings, 1 reply; 59+ results
From: Matt Price @ 2010-09-03 14:18 UTC (permalink / raw)
  To: emacs-orgmode


[-- Attachment #1.1: Type: text/plain, Size: 568 bytes --]

Sorry for the barrage of help requests.  I don't know much about tex but
it's possible the tex output from one file I am working on is buggy, as
mk4ht refuses to read it.  The .org and .tex files are attached, as is the
initial error output of mk4ht oolatex His495Ouline.tex.  This is perhaps the
wrong list to be asking on, but I am sort of working from the assumption
that there's an issue with the tex code that org produces -- mk4ht seems to
work fine with simpler documents.  I';m using a pretty recent org-mode (7.01
from not that long ago).

Thanks much!

matt

[-- Attachment #1.2: Type: text/html, Size: 609 bytes --]

[-- Attachment #2: His495Outline.tex --]
[-- Type: application/x-tex, Size: 15259 bytes --]

[-- Attachment #3: His495Outline.org --]
[-- Type: application/octet-stream, Size: 13052 bytes --]

#+POSTID: 10
#+AUTHOR:    Matt Price
#+EMAIL:     matt.price@utoronto.ca
#+TITLE:     History 495Y: Hacking History
#+DATE:      2010-06-06 Sun
#+DESCRIPTION: 
#+KEYWORDS: 
#+LANGUAGE:  en
#+OPTIONS:   H:3 num:nil toc:nil \n:nil @:t ::t |:t ^:t -:t f:t *:t <:t
#+OPTIONS:   TeX:t LaTeX:nil skip:nil d:nil todo:t pri:nil tags:not-in-toc
#+INFOJS_OPT: view:nil toc:nil ltoc:t mouse:underline buttons:0 path:http://orgmode.org/org-info.js
#+EXPORT_SELECT_TAGS: export
#+EXPORT_EXCLUDE_TAGS: noexport
#+LINK_UP:   
#+LINK_HOME: 
#+LATEX_HEADER: \usepackage[letterpaper]{geometry}
#+LATEX_HEADER: \geometry{verbose,tmargin=2.5cm,bmargin=2.5cm,lmargin=2cm,rmargin=2cm}%
#+LATEX_HEADER: \usepackage{paralist}
#+LATEX_HEADER: \let\itemize\compactitem
#+LATEX_HEADER: \let\description\compactdesc
#+LATEX_HEADER: \let\enumerate\compactenum
#+LATEX_HEADER: \usepackage[small,compact,calcwidth]{titlesec}
#+LATEX_HEADER: \titlespacing{\section}{0pt}{*1}{*0.2}
#+LATEX_HEADER: \titlespacing{\subsection}{5}{*0}{*0}
#+LATEX_HEADER: \titlespacing{\subsubsection}{10pt}{*0}{*0}
# #+LATEX_HEADER: \usepackage{enumitem}
# #+LaTeX: \setitemize{nolistsep}
# #+LaTeX: \setitemize{noitemsep}
# #+latex-header: % this makes list spacing much better.
# #+latex-header: %
# #+latex-header: \newenvironment{my_enumerate}{
# #+latex-header: \begin{enumerate}
# #+latex-header:   \setlength{\itemsep}{1pt}
# #+latex-header:   \setlength{\parskip}{0pt}
# #+latex-header:   \setlength{\parsep}{0pt}}{\end{enumerate}
# #+latex-header: }

"In what ways can digital media and digital networks allow us to do our work as historians better?" -- Cohen & Rosenzweig
* _Introduction_ 
This year-long course examines the relationships among academic history, digital media, and community formation using a variety of texts and methods; it culminates in an intensive semester-long digital storytelling project focused on community engagement.  The intellectual focus of the first semester is two-fold: first, on the history of the public sphere and second, on the politics of "engaged" scholarship.  At the same time, students will be exposed to techniques of multimedia and nonlinear storytelling.  The second semester revolves around a group project undertaken in concert with a community organization.  Working closely with their community partners, students will build a digital archive or storytelling framework using multimedia and/or social networking technologies.  The fundamental aim of the course is to expand the reach of historical scholarship outside of the academy, and to develop modes of historical research compatible with community engagement.
* _Course Structure_
** First Semester
In the first semester we will meet on a weekly basis to discuss the week's readings ("Readings" in the [[Outline: Semester 1][outline]]) and work together on a technical or interpretative task that will be defined in advance ("Lab" in the [[outline1][outline]]).  In advance of the class meeting students will generally be expected to produce written responses to the readings in the form of blog postings, and to respond to the postings of at least two other students.  In certain weeks there are other types of assignments; these are noted in the outline and referred to in the course requirements.  In general the aim is to foster an atmosphere of collaborative and self-directed learning in which all work is focused on building the analytic resources, technical skills, and confidence to create really great projects in the second semester.  Though the assignment structure is fixed, readings may change based on student interests.
** Second Semester
In the second semester it is expected that students will spend most of their time working directly on their project with the partnering organization.  We will meet as needed, probably about twice a week, to discuss specific technical questions raised by the projects themselves.  However, it is still expected that students will make regular postings about their progress, and comment on each other's writing.  In general, it is expected that the second-semester projects will also be collaborations.  
* _<<<Course Requirements>>>_
The emphasis will be on steady, consistent work.  Students are required to make weekly contributions to the online postings to the class website, and to comment on other postings.  There are also weekly technical assignments, which serve as the basis for the lab portion of the course.The second semester is largely taken up by the final project, which counts for 50% of the grade and in the course of which blog postings will continue to be required.  Grade distribution:
- online commentary 20%
- lab assignments 20%
- in-class participation 10%
- Final Project (including ancillary assignments) 50%
** Project Timetable
Sept. 16: Detailed assignment handed out with preliminary partner suggestions
Oct. 28: Presentation of preliminary project proposal.  
Dec. 2: Presentation of Final Proposal
Jan 10: Internship begins (approximate)
Feb 24: Intermediate Status Report
Apr. 7: Project Open House

** Grading of Posts and Labs
Posts and labs will be graded in the old-fashioned 0-4 system, where 0 represents and F and 4 an A.  The assignments will be summed and averaged, then converted to a UofT-style numerical grade.  
# <<texts>>
* Texts
All texts for this course are online, either in the public web or as pdfs.  Most of them are publicly available. You may want physical copies of come books;  these are available at amazon or by special order from any sizable bookstore. 
- Cohen & Rosenzweig, /Digital History/ (http://chnm.gmu.edu/digitalhistory/)
- C. Kelty, /Two Bits/ (http://twobits.net/read/)
- P. Gralla, /How The Internet Works/ (7th or 8th Edition)
A sizable collection of links is also provided on the course website and reproduced via [[http://www.deli.cio.us][deli.cio.us]].  The course bibliography is maintained at http://www.zotero.org/.  
#<<outline1>>
* _Outline: Semester 1_
** 1. What is History For? (2010-09-16) 
Why we should write history, why everyone should do it, and why that means we need the Web.  Hacker cultures, collaborative learning, knowledge sharing, non-expert culture.  
Background: [[http://www.journalofamericanhistory.org/issues/952/interchange/index.html][JAH - The Promise of Digital History]]
*** Lab:  Introduction to Wordpress & the course site.  Blogging & social media review. Preliminary listing of potential NGO partners. 
** 2. <2010-09-23 Thu> [[file:HackingHistory/HistoryAndPublicSphere.org::*History%20and%20the%20Public%20Sphere][History and the Public Sphere]]
On our notion of "public sphere", where it comes from and how it's changing.  
*** Readings:
- J. Habermas, "The Public Sphere: Encyclopedia Article" (http://www.sociol.unimi.it/docenti/barisione/documenti/File/2008-09/Habermas%20(1964)%20-%20The%20Public%20Sphere.pdf) 
- Mark Poster, "Cyberdemocracy" (http://www.hnet.uci.edu/mposter/writings/democ.html) 
- Wikileaks Afghan War Diary (http://wikileaks.org/wiki/Afghan_War_Diary,_2004-2010) 
- Wikileaks Collateral Murder video (http://www.wikileaks.org/wiki/Collateral_Murder,_5_Apr_2010)
*** Lab: The Wikileaks Episode
- how does Wikileaks work?  What does it say about the impact of the web on politics and analysis?  
** 3. <2010-09-30 Thu> [[file:HackingHistory/LanguageOfTheWeb.org::*The%20Language%20of%20the%20Web][The Language of the Web]]
How the Internet works, and what that means for historical narrative.
*** Readings
- Vannevar Bush, "As We May Think" (http://www.theatlantic.com/magazine/archive/1969/12/as-we-may-think/3881/)
- Tim Berners'Lee, /Weaving the Web/ Ch. 2,4.  
- Tim Berners'Lee, "[[http://www.scientificamerican.com/article.cfm?id=the-semantic-web][The Semantic Web]]" 
- Edward L. Ayers, "[[http://www.vcdh.virginia.edu/Ayers.OAH.html][History in Hypertext]]"
- Rus Shuler, "[[http://www.theshulers.com/whitepapers/internet_whitepaper/index.html][How Does the Internet Work?]]
*** Lab: HTML:  the language of the web 
** 4. <2010-10-07 Thu> Recursive Publics
the significance of free software; the recursive relation and its possible significance for other disciplines
*** Readings:
- Richard Stallman, "[[http://www.gnu.org/gnu/manifesto.html][The GNU Manifesto]]" and "[[http://www.gnu.org/philosophy/free-sw.html][The Free Software Definition]]"
- Eric Raymond, "[[http://catb.org/esr/writings/homesteading/cathedral-bazaar/][The Cathedral and the Bazaar]]"
- Kelty, Ch. 1 & 9.
- Creative Commons Licences: http://creativecommons.org/licenses/
- Dan Cohen, "[[http://www.dancohen.org/2009/05/12/idealism-and-pragmatism-in-the-free-culture-movement/][Idealism and Pragmatism in the Free Culture Movement]]"
*** Lab: Markup, Data and Metadata
the transformations your text makes between you, your audience, and your machine readers.  Background: [[http://digitalhumanities.org/dhq/vol/3/3/000064/000064.html][XML, Interoperability and the Social Construction of Markup Languages: The Library Example]]
** 5. <2010-10-14 Thu> Abundant Information and the Digitial Divide
How does the generalized availability of massive amounts of information abundance change the role of the historian?
*** Readings:
- Dan Cohen and Roy Rosenzweig, "Becoming digital" ch. 6 in /Digital History/
- Katie Hafner, "History, Digital (and Abridged)" (http://www.nytimes.com/2007/03/10/business/yourmoney/11archive.html?pagewanted=all)
- Philip and Harpold, "Of Bugs and Rats" (http://pmc.iath.virginia.edu/text-only/issue.900/11.1harpoldphilip.txt)
- Geoff Bowker, "Classification and Large-Scale Infrastructure", /Sorting Things Out/ 
- Geoff bowker, "The Local Knowledge of a Globalizing Ethnos" /Memory Practices in the Sciences/, ch. 5.
*** Lab: Search Tools
Using google scholar, zotero, and private search indexes. Background: [[http://digitalhistoryhacks.blogspot.com/2005/12/teaching-young-historians-to-search.html][Teaching Young Historians to Search, Spider and Scrape]]
** 6. <2010-10-21 Thu> Crowdsourcing 
The new kinds of collaboration that the web makes possible, and the intelletual challenges they create.
*** Readings:
- R. Rosenzweig, "Can History be Open Source?" (http://chnm.gmu.edu/essays-on-history-new-media/essays/?essayid=42)
- Dan Cohen, "The Spider and the Web" (http://www.dancohen.org/2009/04/16/the-spider-and-the-web-a-crowdsourcing-experiment/)
- Steven Friess, "50000 Join Distributed Search for Steve Fossett", /Wired/ 09.11.07 (http://www.wired.com/software/webservices/news/2007/09/distributed_search)
- Nawvieskie, "[[http://digitalhistory.wikispot.org/H9808A_2009_05_Social][Collex]]"
- Wyman et al, "[[http://www.archimuse.com/mw2006/papers/wyman/wyman.html][Steve.museum: An Ongoing Experiment in Social Tagging, Folksonomy, and Museums]]"
*** Lab:  Wikipedia Tracking Assignment
A look at the inner workings of the world's biggest crowdsourcing project.  
** 7. <2010-10-28 Thu> Project Presentation iteration 1 
First presentation of project ideas for constructive criticism. No Readings.
*** Lab: Critique and Improvement of colleagues' project proposals.
** 8. Engaged History    
what does it mean to be an 'engaged' scholar?  Virtues and vices.
*** Readings:
- Massey, Doreen. “Places and Their Pasts.” History Workshop Journal 39 (Spring 1995): 182-192
- Novick, Robert "The Defense of the West," ch. 6 of /That Noble Dream/ 
- Said, Edward W. “Invention, Memory, and Place.” Critical Inquiry 26 (Winter 2000): 175-192
-  William L. Niemi and David J. Plante, "Democratic Movements, Self-Education, and Economic Democracy: Chartists, Populists, and Wobblies" /Radical History Review/ 2008(102): 185-200
*** Lab: Setting up Wordpress:  A Trial Run
Set up mockups -- install plugins -- create users.     
** 9. Oral History
One remarkable possibility opened up by the web is abundant oral history.
*** Readings: 
- "The Voice of the Past", "What Makes Oral History Different" and "Learning to Listen in /The Oral History Reader/
*** Lab:Oral History Exercise
    Topic TBA    
** 10. Working with Communities    
The ethics of working with laypeople, and the promises & pitfalls of collaborating with non-academics.
*** Readings:
TBA
*** Lab: Collaborative Goal Definition
** 11. Great History Websites    
A look at some excellent history websites
*** Readings:  
TBA (Websites only!)
*** Lab: Website dissection

** 12. Project Presentation iteration 2    
Presentation of proposals, including plans, mockups, etc. No readings.
# <<outline2>>    
* _Outline Semester 2_
In the second semester we will meet only every second week, to help make time for you to work with your community partner.  You will still be required to post weekly updates to the /course/ blog, while collecting materials and building the infrastructure for your final projects.  Topics discussed in class meetings will be defined by your needs, but a tentative list of topics includes:
- Defining your project goals
- Data Capture and Metadata
- Copyright Issues
- Video on the Web
- Audio Post-Processing
- Website look and Feel
- Basic Scripting
- Project Open House    
    

[-- Attachment #4: Type: text/plain, Size: 201 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Please use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 5%]

* Re: [PARTIALLY SOLVED] gnash crunch... latex whitespace defaults! + numbering in only some subheadings
  2010-09-02 15:12  7%     ` [PARTIALLY SOLVED] " Matt Price
@ 2010-09-02 22:24  0%       ` Shelagh Manton
  0 siblings, 0 replies; 59+ results
From: Shelagh Manton @ 2010-09-02 22:24 UTC (permalink / raw)
  To: emacs-orgmode

On Thu, 02 Sep 2010 11:12:58 -0400, Matt Price wrote:

> Thanks everyone for their suggestions.  I have settled for now on this:

Might also be worth looking at the savetrees package which is in texlive-
extras.

Shelagh
> 
> #+LATEX_HEADER: \usepackage[letterpaper]{geometry} #+LATEX_HEADER:
> \geometry{verbose,tmargin=2.5cm,bmargin=2.5cm,lmargin=2cm,rmargin=2cm}%
> #+LATEX_HEADER: \usepackage{paralist} #+LATEX_HEADER:
> \let\itemize\compactitem #+LATEX_HEADER: \let\description\compactdesc
> #+LATEX_HEADER: \let\enumerate\compactenum #+LATEX_HEADER:
> \usepackage[small,compact,calcwidth]{titlesec} #+LATEX_HEADER:
> \titlespacing{\section}{0pt}{*1}{*0.2} #+LATEX_HEADER:
> \titlespacing{\subsection}{5}{*0}{*0} #+LATEX_HEADER:
> \titlespacing{\subsubsection}{10pt}{*0}{*0} #+LATEX_HEADER:
> \usepackage{enumitem}
> 
> which does a pretty good job of compressing the whitespace overall.  I'd
> still love to do more finetuning of the formatting but I think that's a
> more complex project.  Unfortunately this seems to have broken mk4ht for
> me! which is a real drag as it's the only way I can reliably produce odt
> documents, which I need much ofthe time.
> 
> Does anyone know whether numbering can be turned on just in some
> subheadings?  That would help me quite a bit...
> 
> thanks thanks thanks for al lthe assistance, matt
> Thanks everyone for heir suggestions.  I have settled for now on this: 
> <br> <br>#+LATEX_HEADER:
> \usepackage[letterpaper]{geometry}<br>#+LATEX_HEADER:
> \geometry{verbose,tmargin=2.5cm,bmargin=2.5cm,lmargin=2cm,rmargin=2cm}%
<br>
> #+LATEX_HEADER: \usepackage{paralist}<br>#+LATEX_HEADER:
> \let\itemize\compactitem<br>#+LATEX_HEADER:
> \let\description\compactdesc<br>#+LATEX_HEADER:
> \let\enumerate\compactenum<br>#+LATEX_HEADER:
> \usepackage[small,compact,calcwidth]{titlesec}<br> #+LATEX_HEADER:
> \titlespacing{\section}{0pt}{*1}{*0.2}<br>#+LATEX_HEADER:
> \titlespacing{\subsection}{5}{*0}{*0}<br>#+LATEX_HEADER:
> \titlespacing{\subsubsection}{10pt}{*0}{*0}<br>#+LATEX_HEADER:
> \usepackage{enumitem}<br><br> which does a pretty good job of
> compressing the whitespace overall.  I&#39;d still love to do more
> finetuning of the formatting but I think that&#39;s a more complex
> project.  Unfortunately this seems to have broken mk4ht for me! which is
> a real drag as it&#39;s the only way I can reliably produce odt
> documents, which I need much ofthe time.  <br> <br>Does anyone know
> whether numbering can be turned on just in some subheadings?  That would
> help me quite a bit...  <br><br>thanks thanks thanks for al lthe
> assistance,<br>matt<br><br>
> _______________________________________________ Emacs-orgmode mailing
> list
> Please use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 0%]

* [PARTIALLY SOLVED] gnash crunch... latex whitespace defaults! + numbering in only some subheadings
  2010-09-02  5:18 11%   ` Nick Dokos
@ 2010-09-02 15:12  7%     ` Matt Price
  2010-09-02 22:24  0%       ` Shelagh Manton
  0 siblings, 1 reply; 59+ results
From: Matt Price @ 2010-09-02 15:12 UTC (permalink / raw)
  To: emacs-orgmode


[-- Attachment #1.1: Type: text/plain, Size: 1146 bytes --]

Thanks everyone for heir suggestions.  I have settled for now on this:

#+LATEX_HEADER: \usepackage[letterpaper]{geometry}
#+LATEX_HEADER:
\geometry{verbose,tmargin=2.5cm,bmargin=2.5cm,lmargin=2cm,rmargin=2cm}%
#+LATEX_HEADER: \usepackage{paralist}
#+LATEX_HEADER: \let\itemize\compactitem
#+LATEX_HEADER: \let\description\compactdesc
#+LATEX_HEADER: \let\enumerate\compactenum
#+LATEX_HEADER: \usepackage[small,compact,calcwidth]{titlesec}
#+LATEX_HEADER: \titlespacing{\section}{0pt}{*1}{*0.2}
#+LATEX_HEADER: \titlespacing{\subsection}{5}{*0}{*0}
#+LATEX_HEADER: \titlespacing{\subsubsection}{10pt}{*0}{*0}
#+LATEX_HEADER: \usepackage{enumitem}

which does a pretty good job of compressing the whitespace overall.  I'd
still love to do more finetuning of the formatting but I think that's a more
complex project.  Unfortunately this seems to have broken mk4ht for me!
which is a real drag as it's the only way I can reliably produce odt
documents, which I need much ofthe time.

Does anyone know whether numbering can be turned on just in some
subheadings?  That would help me quite a bit...

thanks thanks thanks for al lthe assistance,
matt

[-- Attachment #1.2: Type: text/html, Size: 1239 bytes --]

[-- Attachment #2: Type: text/plain, Size: 201 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Please use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 7%]

* Re: gnash crunch... latex whitespace defaults! + numbering in only some subheadings
  @ 2010-09-02  5:18 11%   ` Nick Dokos
  2010-09-02 15:12  7%     ` [PARTIALLY SOLVED] " Matt Price
  0 siblings, 1 reply; 59+ results
From: Nick Dokos @ 2010-09-02  5:18 UTC (permalink / raw)
  To: Matt Price; +Cc: nicholas.dokos, emacs-orgmode

Matt Price <moptop99@gmail.com> wrote:


> I'm pretty sure I had this answered once already but I can't find the
> reference!  sorry to ask again.  I have two issues right now as I try rather
> deperately to print something reasonable-looking for my course syllabus (the
> html version is lovely).
> 
> 1) what is te recommended or canonical way to reduce whitespace, not only in
> the margins, but especially between paragraphs?  In particular, I use a lot
> of lists and subheadings; latex puts enormous emounts of whatespace between
> items, and very quickly the syllabus becomes difficult to navigate.  It
> would be great for me if I could make these settings default, too -- I would
> much rather have my paper copies look more word-processor-ish, to ocnform
> iwth expectations in my discipline (history).

This can be done using the enumitem LaTeX package:

--8<---------------cut here---------------start------------->8---
#+LATEX_HEADER: \usepackage{enumitem}
#+LaTeX: \setitemize{itemsep=0pt, parsep=0pt}

* list
This is a list

  - a

  - b

  - c

  - d

  - e
--8<---------------cut here---------------end--------------->8---

The \setitemize above is equivalent to

#+LaTeX: \setitemize{noitemsep}

You might also try

#+LaTeX: \setitemize{nolistsep}

which eliminates all vertical space.

On Ubuntu/Debian, the enumitem package is part of texlive-latex-extra
and the documentation is in texline-latex-extra-docs.

> 2) is it possible to turn numbering off for most headings, but to turn them
> on wihtin a specific heading?  In my case, I would like to number _only_ the
> weeks in my course outline, but leave all other elements (course
> requirements, texts, introduction, etc) unnumbered.  I bet it's possible but
> it's not trivial to find this in the extensive manual.

You can turn off section numbering by using 

#+OPTIONS: num:nil

but I don't know if it's possible to then turn it back on within some sectioning
unit. But iiuc, you could do this and then use an enumerated list for the weeks -
something like this perhaps:

--8<---------------cut here---------------start------------->8---
#+OPTIONS: num:nil
#+LATEX_HEADER: \usepackage{enumitem}
#+LaTeX: \setitemize{nolistsep}
#+LaTeX: \setenumerate{label=Week \theenumi, itemsep=0pt, parsep=0pt}

* list
This is a list

  - a
  - b
  - c
  - d
  - e
  
* enumerated list
This is an enumerated list

  1. a
  2. b
  3. c
  4. d
  5. e
--8<---------------cut here---------------end--------------->8---

HTH,
Nick

^ permalink raw reply	[relevance 11%]

* Re: Re: keys and command name info
  2010-08-20  7:31  0%                                 ` Carsten Dominik
@ 2010-08-20  8:13  0%                                   ` Andreas Röhler
  0 siblings, 0 replies; 59+ results
From: Andreas Röhler @ 2010-08-20  8:13 UTC (permalink / raw)
  To: Carsten Dominik; +Cc: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 9338 bytes --]

Am 20.08.2010 09:31, schrieb Carsten Dominik:
> Hi Andreas,
>
> On Aug 20, 2010, at 8:27 AM, Andreas Röhler wrote:
>
>> Am 18.08.2010 10:38, schrieb Carsten Dominik:
>>> Hi Andreas,
>>>
>>> this already goes in the right direction.
>>>
>>> I have a better definition for the macro, which does now
>>> push the command name all the way to the right (in PDF output).
>>> I hated the look of the command name separated by a fixed
>>> number of spaces - this is a lot better.
>>> Does anyone know how to do this for HTML and info?
>>>
>>> @macro orgcmd{key,command}
>>> @iftex
>>> @kindex \key\
>>> @findex \command\
>>> @item @kbd{\key\} @hskip 0pt plus 1filll @code{\command\}
>>> @end iftex
>>> @ifnottex
>>> @kindex \key\
>>> @findex \command\
>>> @item @kbd{\key\} @tie{}@tie{}@tie{}@tie{}(@code{\command\})
>>> @end ifnottex
>>> @end macro
>>>
>>> Also, since the table is now an @asis table, lines which do not
>>> have a command name like
>>>
>>> @item C-u C-u C-u @key{TAB}
>>>
>>> will need an explicit formatting command, like this:
>>>
>>> @item @kbd{C-u C-u C-u @key{TAB}}
>>>
>>> Alternatively, we could have another macro
>>>
>>> @macro orgkey{key}
>>> @item @kbd{\key\}
>>> @end macro
>>>
>>> so that we could write keys for which we have no command name
>>> like this:
>>>
>>> @orgkey{C-u C-u C-u @key{TAB}}
>>>
>>> Hope this gets you on your way with a tideous task....
>>
>> Hmm,
>>
>> I'm afraid this starts walking the desert.
>> May be it helps keeping things apart for the beginning.
>>
>> 1) Introducing the command names
>> 2) Completing the formatting
>>
>> As views are different concerning the latter, thats a rather hard task
>> for me, as I can't see the progress...
>>
>> For me it's important seeing command names somewhere near its keys.
>> If beneath or at the right, doesn't matter that much IMHO.
>
> I am not sure what the problem is.
>


> For keys where you have a command name, you continue as you have been
> doing.
> For keys where you do not have the command names, just enclose the key
> after the @item into @kbd{...}
>
> This should get you very far.
>

Hi Carsten,

so let's proceed.

Patch attached.

Andreas



> I am not sure if I have the most recent patch - can you
> please send it again, so that I can check it?
>
> Thanks.
>
> - Carsten
>
>
>>
>>
>>
>>>
>>> One more thing: I do frequently small changes in the manual,
>>> so please make sure to update your patch to the most recent
>>> version of Org.
>>>
>>>
>>>> Please have a look at lines 1097 and 1379.
>>>> Looks like an erronius replacements.
>>>> As its done by a script, ...
>>>
>>> Well, hand checking will absolutely be necessary with this patch.
>>
>> Did that. Cancelled the warning already. Seems you didn't get the mail.
>>
>> What about checkin in the patch as it's done so far?
>>
>> Andreas
>>
>>
>>> Hope you can do as much as possible of that as well, maybe with
>>> comments in the text to get my attention to certain places.
>>>
>>> - Carsten
>>>
>>> On Aug 17, 2010, at 2:43 PM, Andreas Röhler wrote:
>>>
>>>> Am 16.08.2010 10:57, schrieb Carsten Dominik:
>>>>>
>>>>> On Aug 15, 2010, at 9:07 PM, Andreas Röhler wrote:
>>>>>
>>>>>> Am 15.08.2010 09:39, schrieb Carsten Dominik:
>>>>>>>
>>>>>>> On Aug 15, 2010, at 9:37 AM, Carsten Dominik wrote:
>>>>>>>
>>>>>>>>
>>>>>>>> On Aug 13, 2010, at 9:30 PM, Andreas Röhler wrote:
>>>>>>>>
>>>>>>>>> Am 11.08.2010 12:05, schrieb Carsten Dominik:
>>>>>>>>>>
>>>>>>>>>> On Aug 9, 2010, at 9:28 PM, Dan Davison wrote:
>>>>>>>>>>
>>>>>>>>>>> Dan Davison <davison@stats.ox.ac.uk> writes:
>>>>>>>>>>>
>>>>>>>>>>>> Gregor Zattler <telegraph@gmx.net> writes:
>>>>>>>>>>>>
>>>>>>>>>>>>> Hi Andreas, org-mode developers,
>>>>>>>>>>>>> * Andreas Burtzlaff <andy13@gmx.net> [09. Aug. 2010]:
>>>>>>>>>>>>>> Carsten Dominik <carsten.dominik@gmail.com> writes:
>>>>>>>>>>>>>>> I have put a version of the manual as modified by Andreas
>>>>>>>>>>>>>>> here:
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> http://orgmode.org/org-manual-with-command-names.pdf
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> Not all the command names are in there, but quite a few are.
>>>>>>>>>>>>>>> I'd like to hear from more people
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> - if they would like to have the names there (i.e. if it
>>>>>>>>>>>>>>> would
>>>>>>>>>>>>>>> help them finding a command)
>>>>>>>>>>>>
>>>>>>>>>>>> I would like the command names in the manual.
>>>>>>>>>>>>
>>>>>>>>>>>> - Emacs-lisp has a lovely tradition of naming functions *very*
>>>>>>>>>>>> descriptively and not being afraid to use long names in the
>>>>>>>>>>>> interests
>>>>>>>>>>>> of accuracy. It's a shame to lose all that by displaying
>>>>>>>>>>>> only key
>>>>>>>>>>>> sequences. It's a linguistic world of its own and I like being
>>>>>>>>>>>> exposed
>>>>>>>>>>>> to it.
>>>>>>>>>>>> - While one can do C-h k, that's not the same as the way one
>>>>>>>>>>>> learns the
>>>>>>>>>>>> function names by skimming the manual
>>>>>>>>>>>
>>>>>>>>>>> Also, it does not add length to the HTML version of the manual,
>>>>>>>>>>> because
>>>>>>>>>>> the key sequences are already on a line of their own. And the
>>>>>>>>>>> same is
>>>>>>>>>>> true for a certain proportion of the pdf entries (when the key
>>>>>>>>>>> sequence
>>>>>>>>>>> is long, then it seems to go on its own line).
>>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>>>
>>>>>>>>>>>>>>> - if the position (first thing in the command description)
>>>>>>>>>>>>>>> is right, or if it would be better to have it
>>>>>>>>>>>>>>> - last thing in the description
>>>>>>>>>>>>>>> - or after the first sentence, this is how the GNUS manual
>>>>>>>>>>>>>>> does it.
>>>>>>>>>>>>
>>>>>>>>>>>> I definitely would want them out on a line of their own with
>>>>>>>>>>>> the
>>>>>>>>>>>> key
>>>>>>>>>>>> sequence. I liked the right-aligned model.
>>>>>>>>>>>>
>>>>>>>>>>>> Or if not right-aligned, is it possible not to have the comma?
>>>>>>>>>>>> Maybe a
>>>>>>>>>>>> different font?
>>>>>>>>>>
>>>>>>>>>> I also like the position on the key line best. So if there is a
>>>>>>>>>> more-or-less
>>>>>>>>>> general agreement that we should get the names in, this would
>>>>>>>>>> be my
>>>>>>>>>> preferred
>>>>>>>>>> location as well. I knot that this is different from what the
>>>>>>>>>> emacs
>>>>>>>>>> and gnus manuals do - but I still think that a solution like this
>>>>>>>>>> would
>>>>>>>>>> be better.
>>>>>>>>>>
>>>>>>>>>> Andreas, can you be bothered to rework the patch?
>>>>>>>>>>
>>>>>>>>>> Unfortunately I have no idea if/how the right-aligned model
>>>>>>>>>> could be
>>>>>>>>>> made to
>>>>>>>>>> work. So I think the safest way to do this would be to introduce
>>>>>>>>>> the
>>>>>>>>>> macro,
>>>>>>>>>> and we can then work on the macro to get the formatting right,
>>>>>>>>>> and
>>>>>>>>>> also
>>>>>>>>>> to do the
>>>>>>>>>> key and function index stuff fully automatically.
>>>>>>>>>>
>>>>>>>>>> Here is my proposal for now:
>>>>>>>>>>
>>>>>>>>>> @macro orgcmd{key,command}
>>>>>>>>>> @kindex \key\
>>>>>>>>>> @findex \command\
>>>>>>>>>> @item \key\ @ @ @ @ @ @ @ @ @ @ @r{(}\command\@r{)}
>>>>>>>>>> @end macro
>>>>>>>>>>
>>>>>>>>>> And then define keys/commands like this:
>>>>>>>>>>
>>>>>>>>>> @table @kbd
>>>>>>>>>> .....
>>>>>>>>>> @orgcmd{@key{TAB}, org-cycle}
>>>>>>>>>> Here follows the description of the command
>>>>>>>>>> ....
>>>>>>>>>> @end table
>>>>>>>>>>
>>>>>>>>>> - Carsten
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>> [ ... ]
>>>>>>>>>
>>>>>>>>> Hi Carsten,
>>>>>>>>>
>>>>>>>>> attached a sreenshot, how it comes out for C-c C-b.
>>>>>>>>> Doesn't look ok for me, as back-tick and quote are uncommon that
>>>>>>>>> way.
>>>>>>>>
>>>>>>>> Hi Andreas, you are correct, this does not look right.
>>>>>>>> Seems like we will have to make the table ins @asis and
>>>>>>>> then have the macro apply the formatting. Sigh... :)
>>>>>>>
>>>>>>> If you do insert all the macro calls with the command names, I will
>>>>>>> take
>>>>>>> care of the formatting.
>>>>>>>
>>>>>>> - Carsten
>>>>>>>
>>>>>>
>>>>>> Hi,
>>>>>>
>>>>>> will do that.
>>>>>>
>>>>>> Let us check nonetheless a working example first.
>>>>>>
>>>>>> While trying to put @asis at the right place, I get error messages
>>>>>> and
>>>>>> it refuses to compile.
>>>>>>
>>>>>> Could you re-write the example for me?
>>>>>>
>>>>>> Sorry being that stupid :-)
>>>>>>
>>>>>> Andreas
>>>>>
>>>>> I mean it like this:
>>>>>
>>>>> @macro orgcmd{key,command}
>>>>> @kindex \key\
>>>>> @findex \command\
>>>>> @item @kbd{\key\} @ @ @ @ @ @ @ @ @ @ (@code{\command}\)
>>>>> @end macro
>>>>>
>>>>> And then define keys/commands like this:
>>>>>
>>>>> @table @asis
>>>>> .....
>>>>> @orgcmd{C-c C-x @key{TAB}, org-cycle}
>>>>> Here follows the description of the command
>>>>> ....
>>>>> @end table
>>>>>
>>>>>
>>>>> Does this work?
>>>>>
>>>>> - Carsten
>>>>
>>>>
>>>> Think so, thanks.
>>>> Patch relying upon attached.
>>>>
>>>>
>>>>
>>>> Andreas
>>>> <texi.patch>_______________________________________________
>>>> Emacs-orgmode mailing list
>>>> Please use `Reply All' to send replies to the list.
>>>> Emacs-orgmode@gnu.org
>>>> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
>>>
>>>
>>>
>>
>>
>> _______________________________________________
>> Emacs-orgmode mailing list
>> Please use `Reply All' to send replies to the list.
>> Emacs-orgmode@gnu.org
>> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
>
> - Carsten
>
>
>
>


[-- Attachment #2: org-texi.patch --]
[-- Type: text/x-patch, Size: 8865 bytes --]

diff --git a/doc/org.texi b/doc/org.texi
index 1624111..5cb1878 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -22,6 +22,11 @@
 @finalout
 
 @c Macro definitions
+@macro orgcmd{key,command}
+@kindex \key\
+@findex \command\
+@item \key\ @ @ @ @ @ @ @ @ @ @ @r{(}\command\@r{)}
+@end macro 
 @iftex
 @c @hyphenation{time-stamp time-stamps time-stamp-ing time-stamp-ed}
 @end iftex
@@ -898,9 +903,8 @@ Org uses just two commands, bound to @key{TAB} and
 @cindex folded, subtree visibility state
 @cindex children, subtree visibility state
 @cindex subtree, subtree visibility state
-@table @kbd
-@kindex @key{TAB}
-@item @key{TAB}
+@table @asis
+@orgcmd{@key{TAB}, org-cycle}
 @emph{Subtree cycling}: Rotate current subtree among the states
 
 @example
@@ -940,19 +944,16 @@ tables, @kbd{S-@key{TAB}} jumps to the previous field.
 @kindex C-u C-u C-u @key{TAB}
 @item C-u C-u C-u @key{TAB}
 Show all, including drawers.
-@kindex C-c C-r
-@item C-c C-r
+@orgcmd{C-c C-r, org-reveal}
 Reveal context around point, showing the current entry, the following heading
 and the hierarchy above.  Useful for working near a location that has been
 exposed by a sparse tree command (@pxref{Sparse trees}) or an agenda command
 (@pxref{Agenda commands}).  With a prefix argument show, on each
 level, all sibling headings.  With double prefix arg, also show the entire
 subtree of the parent.
-@kindex C-c C-k
-@item C-c C-k
+@orgcmd{C-c C-k, org-kill-note-or-show-branches}
 Expose all the headings of the subtree, CONTENT view for just one subtree.
-@kindex C-c C-x b
-@item C-c C-x b
+@orgcmd{C-c C-x b, org-tree-to-indirect-buffer}
 Show the current subtree in an indirect buffer@footnote{The indirect
 buffer
 @ifinfo
@@ -1009,24 +1010,18 @@ entries.
 @cindex headline navigation
 The following commands jump to other headlines in the buffer.
 
-@table @kbd
-@kindex C-c C-n
-@item C-c C-n
+@table @asis
+@orgcmd{C-c C-n, outline-next-visible-heading}
 Next heading.
-@kindex C-c C-p
-@item C-c C-p
+@orgcmd{C-c C-p, outline-previous-visible-heading}
 Previous heading.
-@kindex C-c C-f
-@item C-c C-f
+@orgcmd{C-c C-f, org-forward-same-level}
 Next heading same level.
-@kindex C-c C-b
-@item C-c C-b
+@orgcmd{C-c C-b, org-backward-same-level}
 Previous heading same level.
-@kindex C-c C-u
-@item C-c C-u
+@orgcmd{C-c C-u, outline-up-heading}
 Backward to higher level heading.
-@kindex C-c C-j
-@item C-c C-j
+@orgcmd{C-c C-j, org-goto}
 Jump to a different place without changing the current outline
 visibility.  Shows the document structure in a temporary buffer, where
 you can use the following keys to find your destination:
@@ -1061,9 +1056,8 @@ See also the variable @code{org-goto-interface}.
 @cindex sorting, of subtrees
 @cindex subtrees, cut and paste
 
-@table @kbd
-@kindex M-@key{RET}
-@item M-@key{RET}
+@table @asis
+@orgcmd{M-@key{RET}, org-insert-heading}
 @vindex org-M-RET-may-split-line
 Insert new heading with same level as current.  If the cursor is in a
 plain list item, a new item is created (@pxref{Plain lists}).  To force
@@ -1093,47 +1087,36 @@ variable @code{org-treat-insert-todo-heading-as-state-change}.
 Insert new TODO entry with same level as current heading.  Like
 @kbd{C-@key{RET}}, the new headline will be inserted after the current
 subtree.
-@kindex @key{TAB}
-@item @key{TAB} @r{in new, empty entry}
+@orgcmd{@key{TAB}, org-cycle}
 In a new entry with no text yet, the first @key{TAB} demotes the entry to
 become a child of the previous one.  The next @key{TAB} makes it a parent,
 and so on, all the way to top level.  Yet another @key{TAB}, and you are back
 to the initial level.
-@kindex M-@key{left}
-@item M-@key{left}
+@orgcmd{M-@key{left}, org-metaleft}
 Promote current heading by one level.
-@kindex M-@key{right}
-@item M-@key{right}
+@orgcmd{M-@key{right}, org-metaright}
 Demote current heading by one level.
-@kindex M-S-@key{left}
-@item M-S-@key{left}
+@orgcmd{M-S-@key{left}, org-shiftmetaleft}
 Promote the current subtree by one level.
-@kindex M-S-@key{right}
-@item M-S-@key{right}
+@orgcmd{M-S-@key{right}, org-shiftmetaright}
 Demote the current subtree by one level.
-@kindex M-S-@key{up}
-@item M-S-@key{up}
+@orgcmd{M-S-@key{up}, org-shiftmetaup}
 Move subtree up (swap with previous subtree of same
 level).
-@kindex M-S-@key{down}
-@item M-S-@key{down}
+@orgcmd{M-S-@key{down}, org-shiftmetadown}
 Move subtree down (swap with next subtree of same level).
-@kindex C-c C-x C-w
-@item C-c C-x C-w
+@orgcmd{C-c C-x C-w, org-cut-special}
 Kill subtree, i.e. remove it from buffer but save in kill ring.
 With a numeric prefix argument N, kill N sequential subtrees.
-@kindex C-c C-x M-w
-@item C-c C-x M-w
+@orgcmd{C-c C-x M-w, org-copy-special}
 Copy subtree to kill ring.  With a numeric prefix argument N, copy the N
 sequential subtrees.
-@kindex C-c C-x C-y
-@item C-c C-x C-y
+@orgcmd{C-c C-x C-y, org-paste-special}
 Yank subtree from kill ring.  This does modify the level of the subtree to
 make sure the tree fits in nicely at the yank position.  The yank level can
 also be specified with a numeric prefix argument, or by yanking after a
 headline marker like @samp{****}.
-@kindex C-y
-@item C-y
+@orgcmd{C-y, org-yank}
 @vindex org-yank-adjusted-subtrees
 @vindex org-yank-folded-subtrees
 Depending on the variables @code{org-yank-adjusted-subtrees} and
@@ -1146,19 +1129,16 @@ previously visible.  Any prefix argument to this command will force a normal
 force a normal yank is @kbd{C-u C-y}.  If you use @code{yank-pop} after a
 yank, it will yank previous kill items plainly, without adjustment and
 folding.
-@kindex C-c C-x c
-@item C-c C-x c
+@orgcmd{C-c C-x c, org-clone-subtree-with-time-shift}
 Clone a subtree by making a number of sibling copies of it.  You will be
 prompted for the number of copies to make, and you can also specify if any
 timestamps in the entry should be shifted.  This can be useful, for example,
 to create a number of tasks related to a series of lectures to prepare.  For
 more details, see the docstring of the command
 @code{org-clone-subtree-with-time-shift}.
-@kindex C-c C-w
-@item C-c C-w
+@orgcmd{C-c C-w, org-refile}
 Refile entry or region to a different location.  @xref{Refiling notes}.
-@kindex C-c ^
-@item C-c ^
+@orgcmd{C-c ^, org-sort}
 Sort same-level entries.  When there is an active region, all entries in the
 region will be sorted.  Otherwise the children of the current headline are
 sorted.  The command prompts for the sorting method, which can be
@@ -1175,8 +1155,7 @@ Narrow buffer to current subtree.
 @kindex C-x n w
 @item C-x n w
 Widen buffer to remove narrowing.
-@kindex C-c *
-@item C-c *
+@orgcmd{C-c *, org-ctrl-c-ctrl-c}
 Turn a normal line or plain list item into a headline (so that it becomes a
 subheading at its location).  Also turn a headline into a normal line by
 removing the stars.  If there is an active region, turn all lines in the
@@ -1220,9 +1199,8 @@ and you will see immediately how it works.
 Org-mode contains several commands creating such trees, all these
 commands can be accessed through a dispatcher:
 
-@table @kbd
-@kindex C-c /
-@item C-c /
+@table @asis
+@orgcmd{C-c /, org-sparse-tree}
 This prompts for an extra key to select a sparse-tree creating command.
 @kindex C-c / r
 @item C-c / r
@@ -1347,9 +1325,8 @@ the current list-level) improves readability, customize the variable
 The following commands act on items when the cursor is in the first line
 of an item (the line with the bullet or number).
 
-@table @kbd
-@kindex @key{TAB}
-@item @key{TAB}
+@table @asis
+@orgcmd{@key{TAB}, org-cycle}
 @vindex org-cycle-include-plain-lists
 Items can be folded just like headline levels.  Normally this works only if
 the cursor is on a plain list item.  For more details, see the variable
@@ -1360,8 +1337,7 @@ headlines, however; the hierarchies remain completely separated.
 
 If @code{org-cycle-include-plain-lists} has not been set, @key{TAB}
 fixes the indentation of the current line in a heuristic way.
-@kindex M-@key{RET}
-@item M-@key{RET}
+@orgcmd{M-@key{RET}, org-insert-heading}
 @vindex org-M-RET-may-split-line
 Insert new item at current level.  With a prefix argument, force a new
 heading (@pxref{Structure editing}).  If this command is used in the middle
@@ -1375,13 +1351,11 @@ bullet, a bullet is added to the current line.
 @kindex M-S-@key{RET}
 @item M-S-@key{RET}
 Insert a new item with a checkbox (@pxref{Checkboxes}).
-@kindex @key{TAB}
-@item @key{TAB} @r{in new, empty item}
+@orgcmd{@key{TAB}, org-cycle}
 In a new item with no text yet, the first @key{TAB} demotes the item to
 become a child of the previous one.  The next @key{TAB} makes it a parent,
 and so on, all the way to the left margin.  Yet another @key{TAB}, and you
 are back to the initial level.
-@kindex S-@key{up}
 @kindex S-@key{down}
 @item S-@key{up}
 @itemx S-@key{down}

[-- Attachment #3: Type: text/plain, Size: 201 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Please use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply related	[relevance 0%]

* Re: Re: keys and command name info
  2010-08-20  6:27  0%                               ` Andreas Röhler
@ 2010-08-20  7:31  0%                                 ` Carsten Dominik
  2010-08-20  8:13  0%                                   ` Andreas Röhler
  0 siblings, 1 reply; 59+ results
From: Carsten Dominik @ 2010-08-20  7:31 UTC (permalink / raw)
  To: Andreas Röhler; +Cc: emacs-orgmode

Hi Andreas,

On Aug 20, 2010, at 8:27 AM, Andreas Röhler wrote:

> Am 18.08.2010 10:38, schrieb Carsten Dominik:
>> Hi Andreas,
>>
>> this already goes in the right direction.
>>
>> I have a better definition for the macro, which does now
>> push the command name all the way to the right (in PDF output).
>> I hated the look of the command name separated by a fixed
>> number of spaces - this is a lot better.
>> Does anyone know how to do this for HTML and info?
>>
>> @macro orgcmd{key,command}
>> @iftex
>> @kindex \key\
>> @findex \command\
>> @item @kbd{\key\} @hskip 0pt plus 1filll @code{\command\}
>> @end iftex
>> @ifnottex
>> @kindex \key\
>> @findex \command\
>> @item @kbd{\key\} @tie{}@tie{}@tie{}@tie{}(@code{\command\})
>> @end ifnottex
>> @end macro
>>
>> Also, since the table is now an @asis table, lines which do not
>> have a command name like
>>
>> @item C-u C-u C-u @key{TAB}
>>
>> will need an explicit formatting command, like this:
>>
>> @item @kbd{C-u C-u C-u @key{TAB}}
>>
>> Alternatively, we could have another macro
>>
>> @macro orgkey{key}
>> @item @kbd{\key\}
>> @end macro
>>
>> so that we could write keys for which we have no command name
>> like this:
>>
>> @orgkey{C-u C-u C-u @key{TAB}}
>>
>> Hope this gets you on your way with a tideous task....
>
> Hmm,
>
> I'm afraid this starts walking the desert.
> May be it helps keeping things apart for the beginning.
>
> 1) Introducing the command names
> 2) Completing the formatting
>
> As views are different concerning the latter, thats a rather hard  
> task for me, as I can't see the progress...
>
> For me it's important seeing command names somewhere near its keys.
> If beneath or at the right, doesn't matter that much IMHO.

I am not sure what the problem is.

For keys where you have a command name, you continue as you have been  
doing.
For keys where you do not have the command names, just enclose the key  
after the @item into @kbd{...}

This should get you very far.

I am not sure if I have the most recent patch - can you
please send it again, so that I can check it?

Thanks.

- Carsten


>
>
>
>>
>> One more thing: I do frequently small changes in the manual,
>> so please make sure to update your patch to the most recent
>> version of Org.
>>
>>
>>> Please have a look at lines 1097 and 1379.
>>> Looks like an erronius replacements.
>>> As its done by a script, ...
>>
>> Well, hand checking will absolutely be necessary with this patch.
>
> Did that. Cancelled the warning already. Seems you didn't get the  
> mail.
>
> What about checkin in the patch as it's done so far?
>
> Andreas
>
>
>> Hope you can do as much as possible of that as well, maybe with
>> comments in the text to get my attention to certain places.
>>
>> - Carsten
>>
>> On Aug 17, 2010, at 2:43 PM, Andreas Röhler wrote:
>>
>>> Am 16.08.2010 10:57, schrieb Carsten Dominik:
>>>>
>>>> On Aug 15, 2010, at 9:07 PM, Andreas Röhler wrote:
>>>>
>>>>> Am 15.08.2010 09:39, schrieb Carsten Dominik:
>>>>>>
>>>>>> On Aug 15, 2010, at 9:37 AM, Carsten Dominik wrote:
>>>>>>
>>>>>>>
>>>>>>> On Aug 13, 2010, at 9:30 PM, Andreas Röhler wrote:
>>>>>>>
>>>>>>>> Am 11.08.2010 12:05, schrieb Carsten Dominik:
>>>>>>>>>
>>>>>>>>> On Aug 9, 2010, at 9:28 PM, Dan Davison wrote:
>>>>>>>>>
>>>>>>>>>> Dan Davison <davison@stats.ox.ac.uk> writes:
>>>>>>>>>>
>>>>>>>>>>> Gregor Zattler <telegraph@gmx.net> writes:
>>>>>>>>>>>
>>>>>>>>>>>> Hi Andreas, org-mode developers,
>>>>>>>>>>>> * Andreas Burtzlaff <andy13@gmx.net> [09. Aug. 2010]:
>>>>>>>>>>>>> Carsten Dominik <carsten.dominik@gmail.com> writes:
>>>>>>>>>>>>>> I have put a version of the manual as modified by Andreas
>>>>>>>>>>>>>> here:
>>>>>>>>>>>>>>
>>>>>>>>>>>>>> http://orgmode.org/org-manual-with-command-names.pdf
>>>>>>>>>>>>>>
>>>>>>>>>>>>>> Not all the command names are in there, but quite a few  
>>>>>>>>>>>>>> are.
>>>>>>>>>>>>>> I'd like to hear from more people
>>>>>>>>>>>>>>
>>>>>>>>>>>>>> - if they would like to have the names there (i.e. if  
>>>>>>>>>>>>>> it would
>>>>>>>>>>>>>> help them finding a command)
>>>>>>>>>>>
>>>>>>>>>>> I would like the command names in the manual.
>>>>>>>>>>>
>>>>>>>>>>> - Emacs-lisp has a lovely tradition of naming functions  
>>>>>>>>>>> *very*
>>>>>>>>>>> descriptively and not being afraid to use long names in the
>>>>>>>>>>> interests
>>>>>>>>>>> of accuracy. It's a shame to lose all that by displaying  
>>>>>>>>>>> only key
>>>>>>>>>>> sequences. It's a linguistic world of its own and I like  
>>>>>>>>>>> being
>>>>>>>>>>> exposed
>>>>>>>>>>> to it.
>>>>>>>>>>> - While one can do C-h k, that's not the same as the way one
>>>>>>>>>>> learns the
>>>>>>>>>>> function names by skimming the manual
>>>>>>>>>>
>>>>>>>>>> Also, it does not add length to the HTML version of the  
>>>>>>>>>> manual,
>>>>>>>>>> because
>>>>>>>>>> the key sequences are already on a line of their own. And the
>>>>>>>>>> same is
>>>>>>>>>> true for a certain proportion of the pdf entries (when the  
>>>>>>>>>> key
>>>>>>>>>> sequence
>>>>>>>>>> is long, then it seems to go on its own line).
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>>>>> - if the position (first thing in the command  
>>>>>>>>>>>>>> description)
>>>>>>>>>>>>>> is right, or if it would be better to have it
>>>>>>>>>>>>>> - last thing in the description
>>>>>>>>>>>>>> - or after the first sentence, this is how the GNUS  
>>>>>>>>>>>>>> manual
>>>>>>>>>>>>>> does it.
>>>>>>>>>>>
>>>>>>>>>>> I definitely would want them out on a line of their own  
>>>>>>>>>>> with the
>>>>>>>>>>> key
>>>>>>>>>>> sequence. I liked the right-aligned model.
>>>>>>>>>>>
>>>>>>>>>>> Or if not right-aligned, is it possible not to have the  
>>>>>>>>>>> comma?
>>>>>>>>>>> Maybe a
>>>>>>>>>>> different font?
>>>>>>>>>
>>>>>>>>> I also like the position on the key line best. So if there  
>>>>>>>>> is a
>>>>>>>>> more-or-less
>>>>>>>>> general agreement that we should get the names in, this  
>>>>>>>>> would be my
>>>>>>>>> preferred
>>>>>>>>> location as well. I knot that this is different from what  
>>>>>>>>> the emacs
>>>>>>>>> and gnus manuals do - but I still think that a solution like  
>>>>>>>>> this
>>>>>>>>> would
>>>>>>>>> be better.
>>>>>>>>>
>>>>>>>>> Andreas, can you be bothered to rework the patch?
>>>>>>>>>
>>>>>>>>> Unfortunately I have no idea if/how the right-aligned model
>>>>>>>>> could be
>>>>>>>>> made to
>>>>>>>>> work. So I think the safest way to do this would be to  
>>>>>>>>> introduce
>>>>>>>>> the
>>>>>>>>> macro,
>>>>>>>>> and we can then work on the macro to get the formatting  
>>>>>>>>> right, and
>>>>>>>>> also
>>>>>>>>> to do the
>>>>>>>>> key and function index stuff fully automatically.
>>>>>>>>>
>>>>>>>>> Here is my proposal for now:
>>>>>>>>>
>>>>>>>>> @macro orgcmd{key,command}
>>>>>>>>> @kindex \key\
>>>>>>>>> @findex \command\
>>>>>>>>> @item \key\ @ @ @ @ @ @ @ @ @ @ @r{(}\command\@r{)}
>>>>>>>>> @end macro
>>>>>>>>>
>>>>>>>>> And then define keys/commands like this:
>>>>>>>>>
>>>>>>>>> @table @kbd
>>>>>>>>> .....
>>>>>>>>> @orgcmd{@key{TAB}, org-cycle}
>>>>>>>>> Here follows the description of the command
>>>>>>>>> ....
>>>>>>>>> @end table
>>>>>>>>>
>>>>>>>>> - Carsten
>>>>>>>>>
>>>>>>>>>
>>>>>>>> [ ... ]
>>>>>>>>
>>>>>>>> Hi Carsten,
>>>>>>>>
>>>>>>>> attached a sreenshot, how it comes out for C-c C-b.
>>>>>>>> Doesn't look ok for me, as back-tick and quote are uncommon  
>>>>>>>> that
>>>>>>>> way.
>>>>>>>
>>>>>>> Hi Andreas, you are correct, this does not look right.
>>>>>>> Seems like we will have to make the table ins @asis and
>>>>>>> then have the macro apply the formatting. Sigh... :)
>>>>>>
>>>>>> If you do insert all the macro calls with the command names, I  
>>>>>> will
>>>>>> take
>>>>>> care of the formatting.
>>>>>>
>>>>>> - Carsten
>>>>>>
>>>>>
>>>>> Hi,
>>>>>
>>>>> will do that.
>>>>>
>>>>> Let us check nonetheless a working example first.
>>>>>
>>>>> While trying to put @asis at the right place, I get error  
>>>>> messages and
>>>>> it refuses to compile.
>>>>>
>>>>> Could you re-write the example for me?
>>>>>
>>>>> Sorry being that stupid :-)
>>>>>
>>>>> Andreas
>>>>
>>>> I mean it like this:
>>>>
>>>> @macro orgcmd{key,command}
>>>> @kindex \key\
>>>> @findex \command\
>>>> @item @kbd{\key\} @ @ @ @ @ @ @ @ @ @ (@code{\command}\)
>>>> @end macro
>>>>
>>>> And then define keys/commands like this:
>>>>
>>>> @table @asis
>>>> .....
>>>> @orgcmd{C-c C-x @key{TAB}, org-cycle}
>>>> Here follows the description of the command
>>>> ....
>>>> @end table
>>>>
>>>>
>>>> Does this work?
>>>>
>>>> - Carsten
>>>
>>>
>>> Think so, thanks.
>>> Patch relying upon attached.
>>>
>>>
>>>
>>> Andreas
>>> <texi.patch>_______________________________________________
>>> Emacs-orgmode mailing list
>>> Please use `Reply All' to send replies to the list.
>>> Emacs-orgmode@gnu.org
>>> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
>>
>>
>>
>
>
> _______________________________________________
> Emacs-orgmode mailing list
> Please use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode

- Carsten

^ permalink raw reply	[relevance 0%]

* Re: Re: keys and command name info
  2010-08-18  8:38  6%                             ` Carsten Dominik
@ 2010-08-20  6:27  0%                               ` Andreas Röhler
  2010-08-20  7:31  0%                                 ` Carsten Dominik
  0 siblings, 1 reply; 59+ results
From: Andreas Röhler @ 2010-08-20  6:27 UTC (permalink / raw)
  To: Carsten Dominik; +Cc: emacs-orgmode

Am 18.08.2010 10:38, schrieb Carsten Dominik:
> Hi Andreas,
>
> this already goes in the right direction.
>
> I have a better definition for the macro, which does now
> push the command name all the way to the right (in PDF output).
> I hated the look of the command name separated by a fixed
> number of spaces - this is a lot better.
> Does anyone know how to do this for HTML and info?
>
> @macro orgcmd{key,command}
> @iftex
> @kindex \key\
> @findex \command\
> @item @kbd{\key\} @hskip 0pt plus 1filll @code{\command\}
> @end iftex
> @ifnottex
> @kindex \key\
> @findex \command\
> @item @kbd{\key\} @tie{}@tie{}@tie{}@tie{}(@code{\command\})
> @end ifnottex
> @end macro
>
> Also, since the table is now an @asis table, lines which do not
> have a command name like
>
> @item C-u C-u C-u @key{TAB}
>
> will need an explicit formatting command, like this:
>
> @item @kbd{C-u C-u C-u @key{TAB}}
>
> Alternatively, we could have another macro
>
> @macro orgkey{key}
> @item @kbd{\key\}
> @end macro
>
> so that we could write keys for which we have no command name
> like this:
>
> @orgkey{C-u C-u C-u @key{TAB}}
>
> Hope this gets you on your way with a tideous task....

Hmm,

I'm afraid this starts walking the desert.
May be it helps keeping things apart for the beginning.

1) Introducing the command names
2) Completing the formatting

As views are different concerning the latter, thats a rather hard task 
for me, as I can't see the progress...

For me it's important seeing command names somewhere near its keys.
If beneath or at the right, doesn't matter that much IMHO.



>
> One more thing: I do frequently small changes in the manual,
> so please make sure to update your patch to the most recent
> version of Org.
>
>
>> Please have a look at lines 1097 and 1379.
>> Looks like an erronius replacements.
>> As its done by a script, ...
>
> Well, hand checking will absolutely be necessary with this patch.

Did that. Cancelled the warning already. Seems you didn't get the mail.

What about checkin in the patch as it's done so far?

Andreas


> Hope you can do as much as possible of that as well, maybe with
> comments in the text to get my attention to certain places.
>
> - Carsten
>
> On Aug 17, 2010, at 2:43 PM, Andreas Röhler wrote:
>
>> Am 16.08.2010 10:57, schrieb Carsten Dominik:
>>>
>>> On Aug 15, 2010, at 9:07 PM, Andreas Röhler wrote:
>>>
>>>> Am 15.08.2010 09:39, schrieb Carsten Dominik:
>>>>>
>>>>> On Aug 15, 2010, at 9:37 AM, Carsten Dominik wrote:
>>>>>
>>>>>>
>>>>>> On Aug 13, 2010, at 9:30 PM, Andreas Röhler wrote:
>>>>>>
>>>>>>> Am 11.08.2010 12:05, schrieb Carsten Dominik:
>>>>>>>>
>>>>>>>> On Aug 9, 2010, at 9:28 PM, Dan Davison wrote:
>>>>>>>>
>>>>>>>>> Dan Davison <davison@stats.ox.ac.uk> writes:
>>>>>>>>>
>>>>>>>>>> Gregor Zattler <telegraph@gmx.net> writes:
>>>>>>>>>>
>>>>>>>>>>> Hi Andreas, org-mode developers,
>>>>>>>>>>> * Andreas Burtzlaff <andy13@gmx.net> [09. Aug. 2010]:
>>>>>>>>>>>> Carsten Dominik <carsten.dominik@gmail.com> writes:
>>>>>>>>>>>>> I have put a version of the manual as modified by Andreas
>>>>>>>>>>>>> here:
>>>>>>>>>>>>>
>>>>>>>>>>>>> http://orgmode.org/org-manual-with-command-names.pdf
>>>>>>>>>>>>>
>>>>>>>>>>>>> Not all the command names are in there, but quite a few are.
>>>>>>>>>>>>> I'd like to hear from more people
>>>>>>>>>>>>>
>>>>>>>>>>>>> - if they would like to have the names there (i.e. if it would
>>>>>>>>>>>>> help them finding a command)
>>>>>>>>>>
>>>>>>>>>> I would like the command names in the manual.
>>>>>>>>>>
>>>>>>>>>> - Emacs-lisp has a lovely tradition of naming functions *very*
>>>>>>>>>> descriptively and not being afraid to use long names in the
>>>>>>>>>> interests
>>>>>>>>>> of accuracy. It's a shame to lose all that by displaying only key
>>>>>>>>>> sequences. It's a linguistic world of its own and I like being
>>>>>>>>>> exposed
>>>>>>>>>> to it.
>>>>>>>>>> - While one can do C-h k, that's not the same as the way one
>>>>>>>>>> learns the
>>>>>>>>>> function names by skimming the manual
>>>>>>>>>
>>>>>>>>> Also, it does not add length to the HTML version of the manual,
>>>>>>>>> because
>>>>>>>>> the key sequences are already on a line of their own. And the
>>>>>>>>> same is
>>>>>>>>> true for a certain proportion of the pdf entries (when the key
>>>>>>>>> sequence
>>>>>>>>> is long, then it seems to go on its own line).
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>>>>> - if the position (first thing in the command description)
>>>>>>>>>>>>> is right, or if it would be better to have it
>>>>>>>>>>>>> - last thing in the description
>>>>>>>>>>>>> - or after the first sentence, this is how the GNUS manual
>>>>>>>>>>>>> does it.
>>>>>>>>>>
>>>>>>>>>> I definitely would want them out on a line of their own with the
>>>>>>>>>> key
>>>>>>>>>> sequence. I liked the right-aligned model.
>>>>>>>>>>
>>>>>>>>>> Or if not right-aligned, is it possible not to have the comma?
>>>>>>>>>> Maybe a
>>>>>>>>>> different font?
>>>>>>>>
>>>>>>>> I also like the position on the key line best. So if there is a
>>>>>>>> more-or-less
>>>>>>>> general agreement that we should get the names in, this would be my
>>>>>>>> preferred
>>>>>>>> location as well. I knot that this is different from what the emacs
>>>>>>>> and gnus manuals do - but I still think that a solution like this
>>>>>>>> would
>>>>>>>> be better.
>>>>>>>>
>>>>>>>> Andreas, can you be bothered to rework the patch?
>>>>>>>>
>>>>>>>> Unfortunately I have no idea if/how the right-aligned model
>>>>>>>> could be
>>>>>>>> made to
>>>>>>>> work. So I think the safest way to do this would be to introduce
>>>>>>>> the
>>>>>>>> macro,
>>>>>>>> and we can then work on the macro to get the formatting right, and
>>>>>>>> also
>>>>>>>> to do the
>>>>>>>> key and function index stuff fully automatically.
>>>>>>>>
>>>>>>>> Here is my proposal for now:
>>>>>>>>
>>>>>>>> @macro orgcmd{key,command}
>>>>>>>> @kindex \key\
>>>>>>>> @findex \command\
>>>>>>>> @item \key\ @ @ @ @ @ @ @ @ @ @ @r{(}\command\@r{)}
>>>>>>>> @end macro
>>>>>>>>
>>>>>>>> And then define keys/commands like this:
>>>>>>>>
>>>>>>>> @table @kbd
>>>>>>>> .....
>>>>>>>> @orgcmd{@key{TAB}, org-cycle}
>>>>>>>> Here follows the description of the command
>>>>>>>> ....
>>>>>>>> @end table
>>>>>>>>
>>>>>>>> - Carsten
>>>>>>>>
>>>>>>>>
>>>>>>> [ ... ]
>>>>>>>
>>>>>>> Hi Carsten,
>>>>>>>
>>>>>>> attached a sreenshot, how it comes out for C-c C-b.
>>>>>>> Doesn't look ok for me, as back-tick and quote are uncommon that
>>>>>>> way.
>>>>>>
>>>>>> Hi Andreas, you are correct, this does not look right.
>>>>>> Seems like we will have to make the table ins @asis and
>>>>>> then have the macro apply the formatting. Sigh... :)
>>>>>
>>>>> If you do insert all the macro calls with the command names, I will
>>>>> take
>>>>> care of the formatting.
>>>>>
>>>>> - Carsten
>>>>>
>>>>
>>>> Hi,
>>>>
>>>> will do that.
>>>>
>>>> Let us check nonetheless a working example first.
>>>>
>>>> While trying to put @asis at the right place, I get error messages and
>>>> it refuses to compile.
>>>>
>>>> Could you re-write the example for me?
>>>>
>>>> Sorry being that stupid :-)
>>>>
>>>> Andreas
>>>
>>> I mean it like this:
>>>
>>> @macro orgcmd{key,command}
>>> @kindex \key\
>>> @findex \command\
>>> @item @kbd{\key\} @ @ @ @ @ @ @ @ @ @ (@code{\command}\)
>>> @end macro
>>>
>>> And then define keys/commands like this:
>>>
>>> @table @asis
>>> .....
>>> @orgcmd{C-c C-x @key{TAB}, org-cycle}
>>> Here follows the description of the command
>>> ....
>>> @end table
>>>
>>>
>>> Does this work?
>>>
>>> - Carsten
>>
>>
>> Think so, thanks.
>> Patch relying upon attached.
>>
>>
>>
>> Andreas
>> <texi.patch>_______________________________________________
>> Emacs-orgmode mailing list
>> Please use `Reply All' to send replies to the list.
>> Emacs-orgmode@gnu.org
>> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
>
>
>

^ permalink raw reply	[relevance 0%]

* Re: Re: keys and command name info
  @ 2010-08-18  8:38  6%                             ` Carsten Dominik
  2010-08-20  6:27  0%                               ` Andreas Röhler
  0 siblings, 1 reply; 59+ results
From: Carsten Dominik @ 2010-08-18  8:38 UTC (permalink / raw)
  To: Andreas Röhler; +Cc: emacs-orgmode

Hi Andreas,

this already goes in the right direction.

I have a better definition for the macro, which does now
push the command name all the way to the right (in PDF output).
I hated the look of the command name separated by a fixed
number of spaces - this is a lot better.
Does anyone know how to do this for HTML and info?

@macro orgcmd{key,command}
@iftex
@kindex \key\
@findex \command\
@item @kbd{\key\} @hskip 0pt plus 1filll @code{\command\}
@end iftex
@ifnottex
@kindex \key\
@findex \command\
@item @kbd{\key\} @tie{}@tie{}@tie{}@tie{}(@code{\command\})
@end ifnottex
@end macro

Also, since the table is now an @asis table, lines which do not
have a command name like

     @item C-u C-u C-u @key{TAB}

will need an explicit formatting command, like this:

     @item @kbd{C-u C-u C-u @key{TAB}}

Alternatively, we could have another macro

@macro orgkey{key}
@item @kbd{\key\}
@end macro

so that we could write keys for which we have no command name
like this:

@orgkey{C-u C-u C-u @key{TAB}}

Hope this gets you on your way with a tideous task....

One more thing:  I do frequently small changes in the manual,
so please make sure to update your patch to the most recent
version of Org.


> Please have a look at lines 1097 and 1379.
> Looks like an erronius replacements.
> As its done by a script, ...

Well, hand checking will absolutely be necessary with this patch.
Hope you can do as much as possible of that as well, maybe with
comments in the text to get my attention to certain places.

- Carsten

On Aug 17, 2010, at 2:43 PM, Andreas Röhler wrote:

> Am 16.08.2010 10:57, schrieb Carsten Dominik:
>>
>> On Aug 15, 2010, at 9:07 PM, Andreas Röhler wrote:
>>
>>> Am 15.08.2010 09:39, schrieb Carsten Dominik:
>>>>
>>>> On Aug 15, 2010, at 9:37 AM, Carsten Dominik wrote:
>>>>
>>>>>
>>>>> On Aug 13, 2010, at 9:30 PM, Andreas Röhler wrote:
>>>>>
>>>>>> Am 11.08.2010 12:05, schrieb Carsten Dominik:
>>>>>>>
>>>>>>> On Aug 9, 2010, at 9:28 PM, Dan Davison wrote:
>>>>>>>
>>>>>>>> Dan Davison <davison@stats.ox.ac.uk> writes:
>>>>>>>>
>>>>>>>>> Gregor Zattler <telegraph@gmx.net> writes:
>>>>>>>>>
>>>>>>>>>> Hi Andreas, org-mode developers,
>>>>>>>>>> * Andreas Burtzlaff <andy13@gmx.net> [09. Aug. 2010]:
>>>>>>>>>>> Carsten Dominik <carsten.dominik@gmail.com> writes:
>>>>>>>>>>>> I have put a version of the manual as modified by Andreas  
>>>>>>>>>>>> here:
>>>>>>>>>>>>
>>>>>>>>>>>> http://orgmode.org/org-manual-with-command-names.pdf
>>>>>>>>>>>>
>>>>>>>>>>>> Not all the command names are in there, but quite a few  
>>>>>>>>>>>> are.
>>>>>>>>>>>> I'd like to hear from more people
>>>>>>>>>>>>
>>>>>>>>>>>> - if they would like to have the names there (i.e. if it  
>>>>>>>>>>>> would
>>>>>>>>>>>> help them finding a command)
>>>>>>>>>
>>>>>>>>> I would like the command names in the manual.
>>>>>>>>>
>>>>>>>>> - Emacs-lisp has a lovely tradition of naming functions *very*
>>>>>>>>> descriptively and not being afraid to use long names in the
>>>>>>>>> interests
>>>>>>>>> of accuracy. It's a shame to lose all that by displaying  
>>>>>>>>> only key
>>>>>>>>> sequences. It's a linguistic world of its own and I like being
>>>>>>>>> exposed
>>>>>>>>> to it.
>>>>>>>>> - While one can do C-h k, that's not the same as the way one
>>>>>>>>> learns the
>>>>>>>>> function names by skimming the manual
>>>>>>>>
>>>>>>>> Also, it does not add length to the HTML version of the manual,
>>>>>>>> because
>>>>>>>> the key sequences are already on a line of their own. And the
>>>>>>>> same is
>>>>>>>> true for a certain proportion of the pdf entries (when the key
>>>>>>>> sequence
>>>>>>>> is long, then it seems to go on its own line).
>>>>>>>>
>>>>>>>>
>>>>>>>>>
>>>>>>>>>>>> - if the position (first thing in the command description)
>>>>>>>>>>>> is right, or if it would be better to have it
>>>>>>>>>>>> - last thing in the description
>>>>>>>>>>>> - or after the first sentence, this is how the GNUS manual
>>>>>>>>>>>> does it.
>>>>>>>>>
>>>>>>>>> I definitely would want them out on a line of their own with  
>>>>>>>>> the
>>>>>>>>> key
>>>>>>>>> sequence. I liked the right-aligned model.
>>>>>>>>>
>>>>>>>>> Or if not right-aligned, is it possible not to have the comma?
>>>>>>>>> Maybe a
>>>>>>>>> different font?
>>>>>>>
>>>>>>> I also like the position on the key line best. So if there is a
>>>>>>> more-or-less
>>>>>>> general agreement that we should get the names in, this would  
>>>>>>> be my
>>>>>>> preferred
>>>>>>> location as well. I knot that this is different from what the  
>>>>>>> emacs
>>>>>>> and gnus manuals do - but I still think that a solution like  
>>>>>>> this
>>>>>>> would
>>>>>>> be better.
>>>>>>>
>>>>>>> Andreas, can you be bothered to rework the patch?
>>>>>>>
>>>>>>> Unfortunately I have no idea if/how the right-aligned model  
>>>>>>> could be
>>>>>>> made to
>>>>>>> work. So I think the safest way to do this would be to  
>>>>>>> introduce the
>>>>>>> macro,
>>>>>>> and we can then work on the macro to get the formatting right,  
>>>>>>> and
>>>>>>> also
>>>>>>> to do the
>>>>>>> key and function index stuff fully automatically.
>>>>>>>
>>>>>>> Here is my proposal for now:
>>>>>>>
>>>>>>> @macro orgcmd{key,command}
>>>>>>> @kindex \key\
>>>>>>> @findex \command\
>>>>>>> @item \key\ @ @ @ @ @ @ @ @ @ @ @r{(}\command\@r{)}
>>>>>>> @end macro
>>>>>>>
>>>>>>> And then define keys/commands like this:
>>>>>>>
>>>>>>> @table @kbd
>>>>>>> .....
>>>>>>> @orgcmd{@key{TAB}, org-cycle}
>>>>>>> Here follows the description of the command
>>>>>>> ....
>>>>>>> @end table
>>>>>>>
>>>>>>> - Carsten
>>>>>>>
>>>>>>>
>>>>>> [ ... ]
>>>>>>
>>>>>> Hi Carsten,
>>>>>>
>>>>>> attached a sreenshot, how it comes out for C-c C-b.
>>>>>> Doesn't look ok for me, as back-tick and quote are uncommon  
>>>>>> that way.
>>>>>
>>>>> Hi Andreas, you are correct, this does not look right.
>>>>> Seems like we will have to make the table ins @asis and
>>>>> then have the macro apply the formatting. Sigh... :)
>>>>
>>>> If you do insert all the macro calls with the command names, I  
>>>> will take
>>>> care of the formatting.
>>>>
>>>> - Carsten
>>>>
>>>
>>> Hi,
>>>
>>> will do that.
>>>
>>> Let us check nonetheless a working example first.
>>>
>>> While trying to put @asis at the right place, I get error messages  
>>> and
>>> it refuses to compile.
>>>
>>> Could you re-write the example for me?
>>>
>>> Sorry being that stupid :-)
>>>
>>> Andreas
>>
>> I mean it like this:
>>
>> @macro orgcmd{key,command}
>> @kindex \key\
>> @findex \command\
>> @item @kbd{\key\} @ @ @ @ @ @ @ @ @ @ (@code{\command}\)
>> @end macro
>>
>> And then define keys/commands like this:
>>
>> @table @asis
>> .....
>> @orgcmd{C-c C-x @key{TAB}, org-cycle}
>> Here follows the description of the command
>> ....
>> @end table
>>
>>
>> Does this work?
>>
>> - Carsten
>
>
> Think so, thanks.
> Patch relying upon attached.
>
>
>
> Andreas
> <texi.patch>_______________________________________________
> Emacs-orgmode mailing list
> Please use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 6%]

* Re: footer for latex export
  2010-07-12 20:57  7% ` Nick Dokos
@ 2010-07-19 16:41  0%   ` Buck Brody
  0 siblings, 0 replies; 59+ results
From: Buck Brody @ 2010-07-19 16:41 UTC (permalink / raw)
  To: nicholas.dokos; +Cc: emacs-orgmode

Thanks.

On Mon, Jul 12, 2010 at 1:57 PM, Nick Dokos <nicholas.dokos@hp.com> wrote:
> Buck Brody <buckbrody@gmail.com> wrote:
>
>> I am just getting started with LaTeX.  I can't seem to figure out how
>> to add a footer to my document.
>>
>
> I don't think that orgmode provides built-in support for this, but it
> does provide mechanisms so that you can do it by hand. The most flexible
> header/footer package that I know of is fancyhdr by Piet van Oostrum:
>
>  http://www.tex.ac.uk/tex-archive/macros/latex/contrib/fancyhdr/
>
> which provides for 3-part headers and footers with a lot of flexibility.
> The PDF doc in the above directory describes it all in clear detail.
>
> Here is a (fairly rudimentary) attempt to do that in an org-mode file:
>
> --8<---------------cut here---------------start------------->8---
> #+LATEX_HEADER: \usepackage{fancyhdr}
> #+LATEX_HEADER: \pagestyle{fancy} \renewcommand{\headrulewidth}{0pt} \lhead{} \chead{} \rhead{} \lfoot{} \cfoot{Centered footer} \rfoot{}
> #+LaTeX: \thispagestyle{fancy}
>
> * Foo
>
> bar
>
> * Foo2
>
> bar2
>
> #+LaTeX: \newpage
>
> * Foo3
>
> bar3
>
>
> --8<---------------cut here---------------end--------------->8---
>
> whose only effect is to replace the default centered page number
> by the string "Centered footer".
>
> HTH,
> Nick
>
>
>

^ permalink raw reply	[relevance 0%]

* Re: footer for latex export
  @ 2010-07-12 20:57  7% ` Nick Dokos
  2010-07-19 16:41  0%   ` Buck Brody
  0 siblings, 1 reply; 59+ results
From: Nick Dokos @ 2010-07-12 20:57 UTC (permalink / raw)
  To: buckbrody; +Cc: nicholas.dokos, emacs-orgmode

Buck Brody <buckbrody@gmail.com> wrote:

> I am just getting started with LaTeX.  I can't seem to figure out how
> to add a footer to my document.
> 

I don't think that orgmode provides built-in support for this, but it
does provide mechanisms so that you can do it by hand. The most flexible
header/footer package that I know of is fancyhdr by Piet van Oostrum:

  http://www.tex.ac.uk/tex-archive/macros/latex/contrib/fancyhdr/

which provides for 3-part headers and footers with a lot of flexibility.
The PDF doc in the above directory describes it all in clear detail.

Here is a (fairly rudimentary) attempt to do that in an org-mode file:

--8<---------------cut here---------------start------------->8---
#+LATEX_HEADER: \usepackage{fancyhdr}
#+LATEX_HEADER: \pagestyle{fancy} \renewcommand{\headrulewidth}{0pt} \lhead{} \chead{} \rhead{} \lfoot{} \cfoot{Centered footer} \rfoot{}
#+LaTeX: \thispagestyle{fancy}

* Foo

bar

* Foo2

bar2

#+LaTeX: \newpage

* Foo3

bar3


--8<---------------cut here---------------end--------------->8---

whose only effect is to replace the default centered page number
by the string "Centered footer".

HTH,
Nick

^ permalink raw reply	[relevance 7%]

* Re: org-babel-tangle-lang-exts must be initialized? how to get syntax coloring?
  2010-07-08 20:07  8%           ` Nicholas Putnam
@ 2010-07-08 20:28  0%             ` Eric Schulte
  0 siblings, 0 replies; 59+ results
From: Eric Schulte @ 2010-07-08 20:28 UTC (permalink / raw)
  To: Nicholas Putnam; +Cc: Emacs-orgmode

Alright,

Fontification is not specifically an Org-babel feature, but is provided
by Org-mode at large, the relevant portion of the manual is available
online, and may be worth a quick read
http://orgmode.org/manual/Literal-examples.html#Literal-examples

I suppose it may be possible that you are using an old version of
htmlize, I'd recommend looking for a message like the following

  htmlize.el 1.34 or later is needed for source code formatting

in your *Messages* buffer after an html export.

Aside from that, and the htmlize variables (which should all be set to
their default values)
- org-export-htmlize-output-type
- org-export-htmlized-org-css-url
- org-export-htmlize-css-font-prefix
I don't know where the problem could lie.

Sorry I can't be of more help -- Eric

Nicholas Putnam <nputnam@gmail.com> writes:

> My emacs version is "GNU Emacs 23.2.1 (x86_64-apple-darwin10.4.0) of
> 2010-07-07"
>
> htmlfontify-buffer on a python buffer worked -- although at first I thought
> it hadn't because all the font sizes were set to 0pt.
>
> How can I get org-babel to htmlfontify my code on html export?
>
> Nik
>
>
> On Thu, Jul 8, 2010 at 1:33 PM, Eric Schulte <schulte.eric@gmail.com> wrote:
>
>> Hi Nicholas,
>>
>> Nicholas Putnam <nputnam@gmail.com> writes:
>>
>> > Dear Eric,
>> >
>> > Updating from the repository, and putting it at the head of my load-path
>> > fixed the problem with org-babel-tangle-lang-exts.  Thanks.
>> >
>>
>> Great, we're making progress
>>
>> >
>> > org-version returns org-mode version 6.36trans
>> > (release_6.36.576.gec22).
>> >
>>
>> The Org-mode version looks good.
>>
>> >
>> > I still can't seem to export python to html with syntax coloring when
>> > exporting to browser on C-c C-e b.  Should this just work?  I do see
>> syntax
>> > coloring on C-c '.  Setting or not setting org-export-htmlize doesn't
>> seem
>> > to make any difference.
>> >
>>
>> What version of Emacs are you using?  I htmlfontify requires at least
>> Emacs 22 or later.  Running 'emacs --version' at the shell will answer
>> this one.
>>
>> If you have a recent enough Emacs, then can you try opening up a
>> source-code buffer (say Python) and running M-x htmlfontify-buffer from
>> withing the buffer.  This should open up a buffer of html which when
>> viewed through a web-browser looks very similar to your Emacs buffer
>> fontification.
>>
>> If the above doesn't work, try loading htmlize.el explicitly from
>>
>>  org/contrib/lisp/htmlize.el
>>
>> Best -- Eric
>>
>>

^ permalink raw reply	[relevance 0%]

* Re: org-babel-tangle-lang-exts must be initialized? how to get syntax coloring?
  @ 2010-07-08 20:07  8%           ` Nicholas Putnam
  2010-07-08 20:28  0%             ` Eric Schulte
  0 siblings, 1 reply; 59+ results
From: Nicholas Putnam @ 2010-07-08 20:07 UTC (permalink / raw)
  To: Eric Schulte; +Cc: Emacs-orgmode


[-- Attachment #1.1: Type: text/plain, Size: 1611 bytes --]

My emacs version is "GNU Emacs 23.2.1 (x86_64-apple-darwin10.4.0) of
2010-07-07"

htmlfontify-buffer on a python buffer worked -- although at first I thought
it hadn't because all the font sizes were set to 0pt.

How can I get org-babel to htmlfontify my code on html export?

Nik


On Thu, Jul 8, 2010 at 1:33 PM, Eric Schulte <schulte.eric@gmail.com> wrote:

> Hi Nicholas,
>
> Nicholas Putnam <nputnam@gmail.com> writes:
>
> > Dear Eric,
> >
> > Updating from the repository, and putting it at the head of my load-path
> > fixed the problem with org-babel-tangle-lang-exts.  Thanks.
> >
>
> Great, we're making progress
>
> >
> > org-version returns org-mode version 6.36trans
> > (release_6.36.576.gec22).
> >
>
> The Org-mode version looks good.
>
> >
> > I still can't seem to export python to html with syntax coloring when
> > exporting to browser on C-c C-e b.  Should this just work?  I do see
> syntax
> > coloring on C-c '.  Setting or not setting org-export-htmlize doesn't
> seem
> > to make any difference.
> >
>
> What version of Emacs are you using?  I htmlfontify requires at least
> Emacs 22 or later.  Running 'emacs --version' at the shell will answer
> this one.
>
> If you have a recent enough Emacs, then can you try opening up a
> source-code buffer (say Python) and running M-x htmlfontify-buffer from
> withing the buffer.  This should open up a buffer of html which when
> viewed through a web-browser looks very similar to your Emacs buffer
> fontification.
>
> If the above doesn't work, try loading htmlize.el explicitly from
>
>  org/contrib/lisp/htmlize.el
>
> Best -- Eric
>
>

[-- Attachment #1.2: Type: text/html, Size: 2270 bytes --]

[-- Attachment #2: Type: text/plain, Size: 201 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Please use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 8%]

* Re: Tables and environment with parameters
  2010-06-23 21:30  6% Tables and environment with parameters Sébastien Vauban
@ 2010-06-24  6:15  0% ` Carsten Dominik
  0 siblings, 0 replies; 59+ results
From: Carsten Dominik @ 2010-06-24  6:15 UTC (permalink / raw)
  To: Sébastien Vauban; +Cc: emacs-orgmode

Hi Sebastien,

maybe you could use git bisect to identify the offending commit?

Thanks!

- Carsten

On Jun 23, 2010, at 11:30 PM, Sébastien Vauban wrote:

> Hi,
>
> I'm filling my taxes now. Of course, using Org for keeping a trace  
> of all
> computations and reasons of imputing this or that...
>
> Though, since one of the last updates -- I guess --, I now have a  
> problem
> exporting such a table:
>
> --8<---------------cut here---------------start------------->8---
> * Autres frais professionnels
>
> #+BEGIN_changemargin {-4.2cm}{0cm}
>  #+TBLNAME: AutresFPNVE
>  #+ATTR_LaTeX: align=lrrrrr
>  |   |                                          | Montant total  
> (\EUR) | Taux amort (\%) | Part pro. (\%) | Déduc (\%) | NVE (\EUR) |
>  |---+------------------------------------------ 
> +----------------------+-----------------+---------------- 
> +------------+------------|
>  |   | Documentation et formation               |                 
> 51.05 |                 |                |            |       0.00 |
>  |   | Communications GSM                       |                
> 831.16 |             100 |             25 |        100 |     207.79 |
>  |   | Internet (Dommel)                        |                
> 167.88 |             100 |             33 |        100 |      55.40 |
>  |   | Fournitures à amortir (ordinateur + GSM) |                
> 762.51 |              33 |             80 |        100 |     201.30 |
>  |   | Restaurant                               |                
> 304.70 |             100 |            100 |         69 |     210.24 |
>  |---+------------------------------------------ 
> +----------------------+-----------------+---------------- 
> +------------+------------|
>  |   | Total                                     
> |                      |                 |                 
> |            |    1062.02 |
>  | ^ |                                           
> |                      |                 |                 
> |            |      Total |
>  #+TBLFM: $7=$3*$4*$5*$6/1000000;%. 
> 2f 
> ::@2 
> $ 
> 3 
> = 
> 51.05 
> ::@3 
> $ 
> 3 
> = 
> 9.00 
> + 
> 184.88 
> + 
> 51.22 
> + 
> 201.82 
> + 
> 45.67 
> + 
> 69.03 
> + 
> 62.93 
> +54.16+38.87+39.77+36.35+37.46::@4$3=12*13.99::@6$3=146.50+158.20;%. 
> 2f::@7$7=vsum(@-I..@-II);%.2f
> #+END_changemargin
>
>  Some text.
> --8<---------------cut here---------------end--------------->8---
>
> 1. I see the meta-tags in the PDF output!  Very new...
>
> 2. The `changemargin' environment is not correctly handled. See
>   http://article.gmane.org/gmane.emacs.orgmode/25849 for more info.
>
>   FYI, here is the code for `changemargin' in my default class:
>
> --8<---------------cut here---------------start------------->8---
> % changing margins "on the fly" (in mid document)
> \newenvironment{changemargin}[2]%
>    {\begin{list}{}{%
>        \setlength{\topsep}{0pt}%
>        \setlength{\leftmargin}{#1}%
>        \setlength{\rightmargin}{#2}%
>        \setlength{\listparindent}{\parindent}%
>        \setlength{\itemindent}{\parindent}%
>        \setlength{\parsep}{\parskip}%
>    }\item[]}%
>    {\end{list}}
> --8<---------------cut here---------------end--------------->8---
>
> Any confirmation of these problems as new?
>
> Best regards,
>  Seb
>
> PS- Something not new, a bit annoying (even if detail):
>    the `#+BEGIN_environment' "meta-tags" must begin at column 0.
>
> -- 
> Sébastien Vauban
>
>
> _______________________________________________
> Emacs-orgmode mailing list
> Please use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode

- Carsten

^ permalink raw reply	[relevance 0%]

* Tables and environment with parameters
@ 2010-06-23 21:30  6% Sébastien Vauban
  2010-06-24  6:15  0% ` Carsten Dominik
  0 siblings, 1 reply; 59+ results
From: Sébastien Vauban @ 2010-06-23 21:30 UTC (permalink / raw)
  To: emacs-orgmode-mXXj517/zsQ

Hi,

I'm filling my taxes now. Of course, using Org for keeping a trace of all
computations and reasons of imputing this or that...

Though, since one of the last updates -- I guess --, I now have a problem
exporting such a table:

--8<---------------cut here---------------start------------->8---
* Autres frais professionnels

#+BEGIN_changemargin {-4.2cm}{0cm}
  #+TBLNAME: AutresFPNVE
  #+ATTR_LaTeX: align=lrrrrr
  |   |                                          | Montant total (\EUR) | Taux amort (\%) | Part pro. (\%) | Déduc (\%) | NVE (\EUR) |
  |---+------------------------------------------+----------------------+-----------------+----------------+------------+------------|
  |   | Documentation et formation               |                51.05 |                 |                |            |       0.00 |
  |   | Communications GSM                       |               831.16 |             100 |             25 |        100 |     207.79 |
  |   | Internet (Dommel)                        |               167.88 |             100 |             33 |        100 |      55.40 |
  |   | Fournitures à amortir (ordinateur + GSM) |               762.51 |              33 |             80 |        100 |     201.30 |
  |   | Restaurant                               |               304.70 |             100 |            100 |         69 |     210.24 |
  |---+------------------------------------------+----------------------+-----------------+----------------+------------+------------|
  |   | Total                                    |                      |                 |                |            |    1062.02 |
  | ^ |                                          |                      |                 |                |            |      Total |
  #+TBLFM: $7=$3*$4*$5*$6/1000000;%.2f::@2$3=51.05::@3$3=9.00+184.88+51.22+201.82+45.67+69.03+62.93+54.16+38.87+39.77+36.35+37.46::@4$3=12*13.99::@6$3=146.50+158.20;%.2f::@7$7=vsum(@-I..@-II);%.2f
#+END_changemargin

  Some text.
--8<---------------cut here---------------end--------------->8---

1. I see the meta-tags in the PDF output!  Very new...

2. The `changemargin' environment is not correctly handled. See
   http://article.gmane.org/gmane.emacs.orgmode/25849 for more info.

   FYI, here is the code for `changemargin' in my default class:

--8<---------------cut here---------------start------------->8---
% changing margins "on the fly" (in mid document)
\newenvironment{changemargin}[2]%
    {\begin{list}{}{%
        \setlength{\topsep}{0pt}%
        \setlength{\leftmargin}{#1}%
        \setlength{\rightmargin}{#2}%
        \setlength{\listparindent}{\parindent}%
        \setlength{\itemindent}{\parindent}%
        \setlength{\parsep}{\parskip}%
    }\item[]}%
    {\end{list}}
--8<---------------cut here---------------end--------------->8---

Any confirmation of these problems as new?

Best regards,
  Seb

PS- Something not new, a bit annoying (even if detail):
    the `#+BEGIN_environment' "meta-tags" must begin at column 0.

-- 
Sébastien Vauban


_______________________________________________
Emacs-orgmode mailing list
Please use `Reply All' to send replies to the list.
Emacs-orgmode-mXXj517/zsQ@public.gmane.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 6%]

* Re: day-agenda: show whole-day-events first
  @ 2010-06-07  0:10  0%     ` Nick Dokos
  0 siblings, 0 replies; 59+ results
From: Nick Dokos @ 2010-06-07  0:10 UTC (permalink / raw)
  To: Daniel Martins; +Cc: Eraldo Helal, Org-Mode, nicholas.dokos, Carsten Dominik

Daniel Martins <danielemc@gmail.com> wrote:

> Sorry,
> 
> but I did not understand. Which of the 4 variables should be set?
> 
> I have the same intention as Eraldo.
> 

I haven't tried it but I would guess this one:

Show Value Org Sort Agenda Notime Is Late 
   Non-nil means items without time are considered late. More

Nick

> 
> 2010/6/6 Carsten Dominik <carsten.dominik@gmail.com>
> 
> >
> > On Jun 6, 2010, at 1:13 AM, Eraldo Helal wrote:
> >
> >  Right now (default), I get time specific entries shown before events
> >> that last the whole day. I would however prefer to get whole-day
> >> entries(no time) first and time-entries after.
> >>
> >> org-agenda-sorting-strategy:
> >> agenda
> >>  habit-down time-up priority-down category-keep
> >> ,----[ result (now) ]
> >> | Day-agenda (W23):
> >> | Monday      7 June 2010 W23
> >> |   jku:        12:45-15:15  Betriebssysteme
> >> |   jku:        15:30-18:45  Betriebswirtschaftslehre
> >> |   review:     Scheduled:  TODO daily review
> >> |   event:      APPT TEX speech
> >> `----
> >>
> >> ,----[ result (would like to have) ]
> >> | Day-agenda (W23):
> >> | Monday      7 June 2010 W23
> >> |   event:      APPT TEX speech
> >> |   jku:        12:45-15:15  Betriebssysteme
> >> |   jku:        15:30-18:45  Betriebswirtschaftslehre
> >> |   review:     Scheduled:  TODO daily review
> >> `----
> >> the Scheduled item can also go above the time-events if that is easier
> >> to get.
> >>
> >> Would be great if someone could enlighten me with the matching sorting
> >> strategy. :)
> >> Or suggest what else I could do/use instead.
> >>
> >
> > Hi Eraldo,
> >
> > this is
> >
> > Have you looked in the customization group org-agenda-sorting?
> >
> > There are exacly 4 variables there, and one of them is the right one.
> >
> > Cheers
> >
> > - Carsten
> > (steq org-agenda-notim
> >
> >
> >
> >> Greetings from Austria,
> >> Eraldo
> >>
> >> _______________________________________________
> >> Emacs-orgmode mailing list
> >> Please use `Reply All' to send replies to the list.
> >> Emacs-orgmode@gnu.org
> >> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
> >>
> >
> > - Carsten
> >
> >
> >
> >
> >
> > _______________________________________________
> > Emacs-orgmode mailing list
> > Please use `Reply All' to send replies to the list.
> > Emacs-orgmode@gnu.org
> > http://lists.gnu.org/mailman/listinfo/emacs-orgmode
> >
> 
> --0016e6d2661aafdf0a048865465b
> Content-Type: text/html; charset=ISO-8859-1
> Content-Transfer-Encoding: quoted-printable
> 
> Sorry,<br><br>but I did not understand. Which of the 4 variables should be =
> set?<br><br>I have the same intention as Eraldo.<br><br>Daniel<br><br><div =
> class=3D"gmail_quote">2010/6/6 Carsten Dominik <span dir=3D"ltr">&lt;<a hre=
> f=3D"mailto:carsten.dominik@gmail.com">carsten.dominik@gmail.com</a>&gt;</s=
> pan><br>
> <blockquote class=3D"gmail_quote" style=3D"margin: 0pt 0pt 0pt 0.8ex; borde=
> r-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;"><div><div></div><=
> div class=3D"h5"><br>
> On Jun 6, 2010, at 1:13 AM, Eraldo Helal wrote:<br>
> <br>
> <blockquote class=3D"gmail_quote" style=3D"margin: 0pt 0pt 0pt 0.8ex; borde=
> r-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
> Right now (default), I get time specific entries shown before events<br>
> that last the whole day. I would however prefer to get whole-day<br>
> entries(no time) first and time-entries after.<br>
> <br>
> org-agenda-sorting-strategy:<br>
> agenda<br>
> =A0habit-down time-up priority-down category-keep<br>
> ,----[ result (now) ]<br>
> | Day-agenda (W23):<br>
> | Monday =A0 =A0 =A07 June 2010 W23<br>
> | =A0 jku: =A0 =A0 =A0 =A012:45-15:15 =A0Betriebssysteme<br>
> | =A0 jku: =A0 =A0 =A0 =A015:30-18:45 =A0Betriebswirtschaftslehre<br>
> | =A0 review: =A0 =A0 Scheduled: =A0TODO daily review<br>
> | =A0 event: =A0 =A0 =A0APPT TEX speech<br>
> `----<br>
> <br>
> ,----[ result (would like to have) ]<br>
> | Day-agenda (W23):<br>
> | Monday =A0 =A0 =A07 June 2010 W23<br>
> | =A0 event: =A0 =A0 =A0APPT TEX speech<br>
> | =A0 jku: =A0 =A0 =A0 =A012:45-15:15 =A0Betriebssysteme<br>
> | =A0 jku: =A0 =A0 =A0 =A015:30-18:45 =A0Betriebswirtschaftslehre<br>
> | =A0 review: =A0 =A0 Scheduled: =A0TODO daily review<br>
> `----<br>
> the Scheduled item can also go above the time-events if that is easier<br>
> to get.<br>
> <br>
> Would be great if someone could enlighten me with the matching sorting<br>
> strategy. :)<br>
> Or suggest what else I could do/use instead.<br>
> </blockquote>
> <br></div></div>
> Hi Eraldo,<br>
> <br>
> this is<br>
> <br>
> Have you looked in the customization group org-agenda-sorting?<br>
> <br>
> There are exacly 4 variables there, and one of them is the right one.<br>
> <br>
> Cheers<br>
> <br>
> - Carsten<br>
> (steq org-agenda-notim<div class=3D"im"><br>
> <br>
> <blockquote class=3D"gmail_quote" style=3D"margin: 0pt 0pt 0pt 0.8ex; borde=
> r-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
> <br>
> Greetings from Austria,<br>
> Eraldo<br>
> <br>
> _______________________________________________<br>
> Emacs-orgmode mailing list<br>
> Please use `Reply All&#39; to send replies to the list.<br>
> <a href=3D"mailto:Emacs-orgmode@gnu.org" target=3D"_blank">Emacs-orgmode@gn=
> u.org</a><br>
> <a href=3D"http://lists.gnu.org/mailman/listinfo/emacs-orgmode" target=3D"_=
> blank">http://lists.gnu.org/mailman/listinfo/emacs-orgmode</a><br>
> </blockquote>
> <br></div><font color=3D"#888888">
> - Carsten</font><div><div></div><div class=3D"h5"><br>
> <br>
> <br>
> <br>
> <br>
> _______________________________________________<br>
> Emacs-orgmode mailing list<br>
> Please use `Reply All&#39; to send replies to the list.<br>
> <a href=3D"mailto:Emacs-orgmode@gnu.org" target=3D"_blank">Emacs-orgmode@gn=
> u.org</a><br>
> <a href=3D"http://lists.gnu.org/mailman/listinfo/emacs-orgmode" target=3D"_=
> blank">http://lists.gnu.org/mailman/listinfo/emacs-orgmode</a><br>
> </div></div></blockquote></div><br>
> 
> --0016e6d2661aafdf0a048865465b--
> 
> 
> --===============1177117011==
> Content-Type: text/plain; charset="us-ascii"
> MIME-Version: 1.0
> Content-Transfer-Encoding: 7bit
> Content-Disposition: inline
> 
> _______________________________________________
> Emacs-orgmode mailing list
> Please use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
> 
> --===============1177117011==--
> 

^ permalink raw reply	[relevance 0%]

* Re: latex-export + columnview: misinterpretation of section prefixes as emphasis
  @ 2010-06-01 14:52  8% ` tcburt
  0 siblings, 0 replies; 59+ results
From: tcburt @ 2010-06-01 14:52 UTC (permalink / raw)
  To: Carsten Dominik; +Cc: Emacs-orgmode, Juan Pechiar


---- Carsten Dominik <carsten.dominik@gmail.com> wrote: 
> 
> On Jun 1, 2010, at 12:51 PM, Tim Burt wrote:
> 
> >
> >
> > Carsten Dominik <carsten.dominik@gmail.com> writes:
> >
> >> Hi Juan,
> >> On May 31, 2010, at 5:38 AM, Juan Pechiar wrote:
> >>
> >>> Hi!
> >>>
> >>> The test file below contains a columnview table showing section
> >>> headers.
> >>>
> >>> Export to HTML works OK: the asterisks inside the table are
> >>> transformed into indentation.
> >>>
> >>> Export to LaTeX: asterisk pairs are interpreted as emphasis,  
> >>> resulting
> >>> in an incorrect renering of asterisks and bold asterisks.
> >>>
> >>> Following the code, I got lost at org-export-latex-fontify.
> >>>
> >>> I will keep searching for what is happening, but any guidance will  
> >>> be
> >>> appreciated.
> >>
> >> I have fixed at least part of the problem, so the stars will no  
> >> longer
> >> be
> >> interpreted as emphasis.
> >>
> >> However, I am still getting strange results.  FOrmatting a latex file
> >> with this:
> >>
> >> \begin{center}
> >> \begin{tabular}{l}
> >> ITEM                     \\
> >> \hline
> >> * There comes the table  \\
> >> * first                  \\
> >> ** second                \\
> >> *** third                \\
> >> *** other third          \\
> >> **** fourth              \\
> >> ** other second          \\
> >> \end{tabular}
> >> \end{center}
> >>
> >> somehow swallows some of the stars, but seemingly random.
> >> For example, the star before "There" remains, but the star
> >> before "first" disappears.
> >>
> >> This must be some strange LaTeX thing - does anyone
> >> understand what is going on here?
> >
> > This is indeed a LaTeX thing.  The newline sequence (\\) has more than
> > one signature
> > - \\ :: simple newline
> > - \\[additionalSpace] :: newline with additionalSpace
> > - \\*[additionalSpace] :: same as above but will not break a page
> > After the \\ sequence, LaTeX looks for a [ or a * in case the optional
> > argument exists.  In the example above the star is found as _part of a
> > command sequence_ and is therefore not available as something to
> > typeset.
> >
> > One solution in this situation is to put an empty group before the
> > stars:
> >   \begin{center}
> >   \begin{tabular}{l}
> >    ITEM                     \\
> >   \hline
> >   {}* There comes the table  \\
> >   {}* first                  \\
> >   {}** second                \\
> >   {}*** third                \\
> >   {}*** other third          \\
> >   {}**** fourth              \\
> >   {}** other second          \\
> >   \end{tabular}
> >   \end{center}
> >
> > I will think on other possible options.  I hope this helps.
> 
> Well, it certainly helps!  Thanks a lot. At least I understand
> now what is going on.  I guess one solution would be to add an empty  
> column into the Org table and export this as an empty column.   
> Whatever we do, it will be a hack.

I have not found a hack-free solution yet.  Here are some other things I've tried that would be less hackish, but have all failed:
 - Replace \\ with \tabularnewline :: Same behavior as with \\
 - Replace \\ with \\{} :: Extra horizontal space before the *
 - Replace \\ with \tabularnewline{} :: Same behavior as \\{}

I just now tried another solution that does work, but may still be considered a hack.  In short, use the optional argument explicitly:
 - Replace \\ with \\[0pt] :: This has the expected behavior for the * and for the spacing

Tim


> 
> - Carsten
> 
> 
> > Tim
> >
> >
> >>
> >> - Carsten
> >>
> >>
> >>>
> >>> Thanks!
> >>>
> >>> .j.
> >>>
> >>>
> >>> Test file:
> >>> ========================================
> >>> #+COLUMNS: %25ITEM
> >>>
> >>> * There comes the table
> >>>
> >>> #+BEGIN: columnview :vlines 1 :id global
> >>> |   | ITEM                    |
> >>> |---+-------------------------|
> >>> |   | * There comes the table |
> >>> |   | * first                 |
> >>> |   | ** second               |
> >>> |   | *** third               |
> >>> |   | *** other third         |
> >>> |   | **** fourth             |
> >>> |   | ** other second         |
> >>> | / | <>                      |
> >>> #+END:
> >>>
> >>> * first
> >>> ** second
> >>> *** third
> >>> *** other third
> >>> **** fourth
> >>> ** other second
> >>> ========================================
> >>>
> >>> LaTeX output:
> >>> ========================================
> >>> \begin{tabular}{l}
> >>> ITEM                     \\
> >>> \hline
> >>> * There comes the table  \\
> >>> * first                  \\
> >>> ** second                \\
> >>> *** third                \\
> >>> \textbf{*} other third   \\
> >>> \textbf{**} fourth       \\
> >>> ** other second          \\
> >>> \end{tabular}
> >>> ========================================
> >>>
> >>> And the PDF display reads:
> >>> ========================================
> >>> ITEM
> >>> * There comes the table
> >>> first
> >>> * second
> >>> ** third
> >>> * other third
> >>> ** fourth
> >>> * other second
> >>> ========================================
> >>>
> >>>
> >>>
> >>> _______________________________________________
> >>> Emacs-orgmode mailing list
> >>> Please use `Reply All' to send replies to the list.
> >>> Emacs-orgmode@gnu.org
> >>> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
> >>
> >> - Carsten
> >>
> >>
> >>
> >>
> >> _______________________________________________
> >> Emacs-orgmode mailing list
> >> Please use `Reply All' to send replies to the list.
> >> Emacs-orgmode@gnu.org
> >> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
> 
> - Carsten
> 
> 
> 

^ permalink raw reply	[relevance 8%]

* Request for guidance: Export ONLY headlines matching occur search?
@ 2009-12-21  9:48  2% Alan E. Davis
  0 siblings, 0 replies; 59+ results
From: Alan E. Davis @ 2009-12-21  9:48 UTC (permalink / raw)
  To: org-mode


[-- Attachment #1.1: Type: text/plain, Size: 1910 bytes --]

   I am keeping notes in a single file about several topics.  I can
   isolate headlines about these topics/products, by an agenda occur
   search: C-a a / <key phrase> .   I have made a template to print a
   memo about these products, but it seems I must copy the headlines
   by hand to a register or file, then massage them into shape.

   I would like to do something like export a PDF of all
   entries/subtrees within the region that have the product's key
   phrase in the heading.   Is it possible to selectively export only
   the subtrees identified by the Occur agenda search, automagically?
   Since my notes start with an inactive time stamp, I would like to
   strip these out as well.  I think I can easily write an elisp
   function to do this, but perhaps org-mode already has such
   capabilities built in, a regexp for an inactive time stamp.

   Perhaps I'll spend some time over Christmas break on this.  It's
   nice to easily make a memo, but it would be a big help to make it
   less laborious.

    In case there is interest, here are the template and the fragments
   for the head and tail of the memo.

   Remember template:
         ("Memo"       ?Z "%[~/org/MEMO/Top.2.memo]  %?    \n %i  %&
%[~/org/MEMO/Bot.memo]"
                       "~/or/MEMO/Memo.tex" top)

   The required files Top.2.memo and Bot.memo are attached.  Top.2.memo can
be edited with any hard wired recipient and from lines.  The class file,
also included, is edited to change the header on the memo.  All three must
be in the directory ~/org/MEMO.      I am using the sloppy approach of
running LaTeX on the long Memo.tex file to which the current memo has been
pre-pended.  Only the topmost memo is printed.

This approach works but it is currently a kluge, unpolished. The
enhancements I have requested would make it possible to instantly fire off a
memo about a specific product.
  *

*

    Alan Davis

[-- Attachment #1.2: Type: text/html, Size: 2150 bytes --]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: memo-aed-products.cls --]
[-- Type: text/x-tex; name="memo-aed-products.cls", Size: 14186 bytes --]

%% 
%% This is file `memo.cls',
%% \CharacterTable
%%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
%%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
%%   Digits        \0\1\2\3\4\5\6\7\8\9
%%   Exclamation   \!     Double quote  \"     Hash (number) \#
%%   Dollar        \$     Percent       \%     Ampersand     \&
%%   Acute accent  \'     Left paren    \(     Right paren   \)
%%   Asterisk      \*     Plus          \+     Comma         \,
%%   Minus         \-     Point         \.     Solidus       \/
%%   Colon         \:     Semicolon     \;     Less than     \<
%%   Equals        \=     Greater than  \>     Question mark \?
%%   Commercial at \@     Left bracket  \[     Backslash     \\
%%   Right bracket \]     Circumflex    \^     Underscore    \_
%%   Grave accent  \`     Left brace    \{     Vertical bar  \|
%%   Right brace   \}     Tilde         \~}
\NeedsTeXFormat{LaTeX2e}[1996/06/01]
\ProvidesClass{memo}
              [1999/02/09 v1.2z
               Standard LaTeX document class]
\typeout{Document Class `memo' by Ray Seyfarth based on letter style, 9/2000. }
\typeout{  }

\newcommand\@ptsize{}
\DeclareOption{a4paper}
   {\setlength\paperheight {297mm}%
    \setlength\paperwidth  {210mm}}
\DeclareOption{a5paper}
   {\setlength\paperheight {210mm}%
    \setlength\paperwidth  {148mm}}
\DeclareOption{b5paper}
   {\setlength\paperheight {250mm}%
    \setlength\paperwidth  {176mm}}
\DeclareOption{letterpaper}
   {\setlength\paperheight {11in}%
    \setlength\paperwidth  {8.5in}}
\DeclareOption{legalpaper}
   {\setlength\paperheight {14in}%
    \setlength\paperwidth  {8.5in}}
\DeclareOption{executivepaper}
   {\setlength\paperheight {10.5in}%
    \setlength\paperwidth  {7.25in}}
\DeclareOption{landscape}
   {\setlength\@tempdima   {\paperheight}%
    \setlength\paperheight {\paperwidth}%
    \setlength\paperwidth  {\@tempdima}}
\DeclareOption{10pt}{\renewcommand\@ptsize{0}}
\DeclareOption{11pt}{\renewcommand\@ptsize{1}}
\DeclareOption{12pt}{\renewcommand\@ptsize{2}}
\if@compatibility
  \DeclareOption{twoside}{\@latexerr{No `twoside' layout for memo}%
                                   \@eha}
\else
  \DeclareOption{twoside}{\@twosidetrue  \@mparswitchtrue}
\fi
\DeclareOption{oneside}{\@twosidefalse \@mparswitchfalse}
\DeclareOption{draft}{\setlength\overfullrule{5pt}}
\DeclareOption{final}{\setlength\overfullrule{0pt}}
\DeclareOption{leqno}{\input{leqno.clo}}
\DeclareOption{fleqn}{\input{fleqn.clo}}
\ExecuteOptions{letterpaper,10pt,oneside,onecolumn,final}
\ProcessOptions
\input{size1\@ptsize.clo}
\setlength\lineskip{1\p@}
\setlength\normallineskip{1\p@}
\renewcommand\baselinestretch{}
\setlength\parskip{0.7em}
\setlength\parindent{0\p@}
\@lowpenalty   51
\@medpenalty  151
\@highpenalty 301
\setlength\headheight{12\p@}
\setlength\headsep   {45\p@}
\setlength\footskip{25\p@}
\if@compatibility
  \setlength\textwidth{365\p@}
  \setlength\textheight{505\p@}
\fi
\if@compatibility
  \setlength\oddsidemargin{53pt}
  \setlength\evensidemargin{53pt}
  \setlength\marginparwidth{90pt}
\else
  \setlength\@tempdima{\paperwidth}
  \addtolength\@tempdima{-2in}
  \addtolength\@tempdima{-\textwidth}
  \setlength\oddsidemargin   {.5\@tempdima}
  \setlength\evensidemargin  {\oddsidemargin}
  \setlength\marginparwidth  {90\p@}
\fi
\setlength\marginparsep {11\p@}
\setlength\marginparpush{5\p@}
\setlength\topmargin{27pt}
\setlength\footnotesep{12\p@}
\setlength{\skip\footins}{10\p@ \@plus 2\p@ \@minus 4\p@}
\if@twoside
  \def\ps@headings{%
      \let\@oddfoot\@empty\let\@evenfoot\@empty
      \def\@oddhead{\slshape\headtoname{} \ignorespaces\toname
                    \hfil \@date
                    \hfil \pagename{} \thepage}%
      \let\@evenhead\@oddhead}
\else
  \def\ps@headings{%
      \let\@oddfoot\@empty
      \def\@oddhead{\slshape\headtoname{} \ignorespaces\toname
                    \hfil \@date
                    \hfil \pagename{} \thepage}}
\fi
\def\ps@empty{%
      \let\@oddfoot\@empty\let\@oddhead\@empty
      \let\@evenfoot\@empty\let\@evenhead\@empty}
\def\ps@firstpage{%
     \let\@oddhead\@empty
     \def\@oddfoot{\raisebox{-45\p@}[\z@]{%
        \hb@xt@\textwidth{\hspace*{100\p@}%
          \ifcase \@ptsize\relax
             \normalsize
          \or
             \small
          \or
             \footnotesize
          \fi
        \fromlocation \hfill \telephonenum}}\hss}}
\def\ps@plain{%
      \let\@oddhead\@empty
      \def\@oddfoot{\normalfont\hfil\thepage\hfil}%
      \def\@evenfoot{\normalfont\hfil\thepage\hfil}}
\newcommand*{\name}[1]{\def\fromname{#1}}
\newcommand*{\signature}[1]{\def\fromsig{#1}}
\newcommand*{\address}[1]{\def\fromaddress{#1}}
\newcommand*{\location}[1]{\def\fromlocation{#1}}
\newcommand*{\telephone}[1]{\def\telephonenum{#1}}
\name{}
\signature{}
\address{}
\location{}
\telephone{}
\newcommand*{\makelabels}{%
  \AtBeginDocument{%
     \let\@startlabels\startlabels
     \let\@mlabel\mlabel
     \if@filesw
       \immediate\write\@mainaux{\string\@startlabels}\fi}%
  \AtEndDocument{%
     \if@filesw\immediate\write\@mainaux{\string\clearpage}\fi}}
\@onlypreamble\makelabels
\newenvironment{memo}
  {%\newpage
  \rule{\textwidth}{.2pt}
    \if@twoside \ifodd\c@page
                \else\thispagestyle{empty}\null\newpage\fi
    \fi
    \c@page\@ne
    \c@footnote\@ne
    \interlinepenalty=200 % smaller than the TeXbook value
    %\@processto{\leavevmode\ignorespaces #1}
    \vspace{.05in}}
  {\vfill \stopletter\@@par\pagebreak\@@par
    %\if@filesw
      %\begingroup
        %\let\\=\relax
        %\let\protect\@unexpandable@protect
        %\immediate\write\@auxout{%
          %\string\@mlabel{\returnaddress}{\toname\\\toaddress}}%
      %\endgroup
    %\fi}
    }
\long\def\@processto#1{%
  \@xproc #1\\@@@%
  \ifx\toaddress\@empty
  \else
    \@yproc #1@@@%
  \fi}
\long\def\@xproc #1\\#2@@@{\def\toname{#1}\def\toaddress{#2}}
\long\def\@yproc #1\\#2@@@{\def\toaddress{#2}}
\newcommand*{\stopbreaks}{%
  \interlinepenalty\@M
  \def\par{\@@par\nobreak}%
  \let\\\@nobreakcr
  \let\vspace\@nobreakvspace}
\DeclareRobustCommand\@nobreakvspace
   {\@ifstar\@nobreakvspacex\@nobreakvspacex}
\def\@nobreakvspacex#1{%
  \ifvmode
    \nobreak\vskip #1\relax
  \else
    \@bsphack\vadjust{\nobreak\vskip #1}\@esphack
  \fi}
\def\@nobreakcr{\@ifstar{\@normalcr*}{\@normalcr*}}
\newcommand*{\startbreaks}{%
  \let\\\@normalcr
  \interlinepenalty 200%
  \def\par{\@@par\penalty 200\relax}}
\newdimen\longindentation
\longindentation=.5\textwidth
\newdimen\indentedwidth
\indentedwidth=\textwidth
\advance\indentedwidth -\longindentation
\newcommand*{\opening}[1]{\ifx\@empty\fromaddress
  \thispagestyle{firstpage}%
    {\raggedleft\@date\par}%
  \else  % home address
    \thispagestyle{empty}%
    {\raggedleft\begin{tabular}{l@{}}\ignorespaces
      \fromaddress \\*[2\parskip]%
      \@date \end{tabular}\par}%
  \fi
  \vspace{2\parskip}%
  {\raggedright \toname \\ \toaddress \par}%
  \vspace{2\parskip}%
  #1\par\nobreak}
\newcommand{\closing}[1]{\par\nobreak\vspace{\parskip}%
  \stopbreaks
  \noindent
  \ifx\@empty\fromaddress\else
  \hspace*{\longindentation}\fi
  \parbox{\indentedwidth}{\raggedright
       \ignorespaces #1\\[6\medskipamount]%
       \ifx\@empty\fromsig
           \fromname
       \else \fromsig \fi\strut}%
   \par}
\medskipamount=\parskip
\newcommand*{\CC}[1]{%
    \Ccname: 
    \begin{tabular}[t]{l@{\qquad\qquad}l}
    #1
    \end{tabular}}
\newcommand*{\Cc}[1]{%
  \par\noindent
  \parbox[t]{\textwidth}{%
    \@hangfrom{\normalfont\Ccname: }%
    \ignorespaces #1\strut}\par}
\newcommand*{\Date}[1]{%
  \par\noindent
  \parbox[t]{\textwidth}{%
    \@hangfrom{\normalfont\Datename: }%
    \ignorespaces #1\strut}\par}
\newcommand*{\To}[1]{%
  \par\noindent
  \parbox[t]{\textwidth}{%
    \@hangfrom{\normalfont\Toname: }%
    \ignorespaces #1\strut}\par}
\newcommand*{\From}[1]{%
  \par\noindent
  \parbox[t]{\textwidth}{%
    \@hangfrom{\normalfont\Fromname: }%
    \ignorespaces #1\strut}\par}
\newcommand*{\USM}{
\vspace{-1.2cm}
\begin{center}
\thispagestyle{empty}
{\bf \large
\noindent
{\sf \Large\textsc{Huge Bureaucracy // Products Section}} \vspace{1pt}

\noindent
{\sf \large\textsc{Correspondence}}}\\
\end{center}

%\rule{16.0cm}{1pt}

\vspace{1.0cm}
}
\newcommand*{\Subject}[1]{%
  \par\noindent
  \parbox[t]{\textwidth}{%
    \@hangfrom{\normalfont\Subjectname: }%
    \ignorespaces #1\strut}\par}
\newcommand*{\encl}[1]{%
  \par\noindent
  \parbox[t]{\textwidth}{%
    \@hangfrom{\normalfont\enclname: }%
    \ignorespaces #1\strut}\par}
\newcommand*{\ps}{\par\startbreaks}
\newcommand*{\stopletter}{}
\newcommand*{\returnaddress}{}
\newcount\labelcount
\newcommand*{\startlabels}{\labelcount\z@
  \pagestyle{empty}%
  \let\@texttop\relax
  \topmargin -50\p@
  \headsep \z@
  \oddsidemargin -35\p@
  \evensidemargin -35\p@
  \textheight 10in
  \@colht\textheight  \@colroom\textheight \vsize\textheight
  \textwidth 550\p@
  \columnsep 26\p@
  \ifcase \@ptsize\relax
    \normalsize
  \or
    \small
  \or
    \footnotesize
  \fi
  \baselineskip \z@
  \lineskip \z@
  \boxmaxdepth \z@
  \parindent \z@
  \twocolumn\relax}
\let\@startlabels=\relax
\newcommand*{\mlabel}[2]{%
  \parbox[b][2in][c]{262\p@}{\strut\ignorespaces #2}%
  }
\let\@mlabel=\@gobbletwo
\setlength\leftmargini  {2.5em}
\setlength\leftmarginii  {2.2em}
\setlength\leftmarginiii {1.87em}
\setlength\leftmarginiv  {1.7em}
\setlength\leftmarginv  {1em}
\setlength\leftmarginvi {1em}
\setlength\leftmargin    {\leftmargini}
\setlength  \labelsep  {5\p@}
\setlength  \labelwidth{\leftmargini}
\addtolength\labelwidth{-\labelsep}
\setlength\partopsep{0\p@}
\@beginparpenalty -\@lowpenalty
\@endparpenalty   -\@lowpenalty
\@itempenalty     -\@lowpenalty
\def\@listI{\setlength\leftmargin{\leftmargini}%
            \setlength\parsep {0\p@}%
            \setlength\topsep {.4em}%
            \setlength\itemsep{.4em}}
\let\@listi\@listI
\@listi
\def\@listii {\setlength  \leftmargin{\leftmarginii}%
              \setlength  \labelwidth{\leftmarginii}%
              \addtolength\labelwidth{-\labelsep}}
\def\@listiii{\setlength  \leftmargin{\leftmarginiii}%
              \setlength  \labelwidth{\leftmarginiii}%
              \addtolength\labelwidth{-\labelsep}%
              \setlength  \topsep    {.2em}%
              \setlength  \itemsep   {\topsep}}
\def\@listiv {\setlength  \leftmargin{\leftmarginiv}%
              \setlength  \labelwidth{\leftmarginiv}%
              \addtolength\labelwidth{-\labelsep}}
\def\@listv  {\setlength  \leftmargin{\leftmarginv}%
              \setlength  \labelwidth{\leftmarginv}%
              \addtolength\labelwidth{-\labelsep}}
\def\@listvi {\setlength  \leftmargin{\leftmarginvi}%
              \setlength  \labelwidth{\leftmarginvi}%
              \addtolength\labelwidth{-\labelsep}}
\renewcommand\theenumi{\@arabic\c@enumi}
\renewcommand\theenumii{\@alph\c@enumii}
\renewcommand\theenumiii{\@roman\c@enumiii}
\renewcommand\theenumiv{\@Alph\c@enumiv}
\newcommand\labelenumi{\theenumi.}
\newcommand\labelenumii{(\theenumii)}
\newcommand\labelenumiii{\theenumiii.}
\newcommand\labelenumiv{\theenumiv.}
\renewcommand\p@enumii{\theenumi}
\renewcommand\p@enumiii{\theenumi(\theenumii)}
\renewcommand\p@enumiv{\p@enumiii\theenumiii}
\newcommand\labelitemi{\textbullet}
\newcommand\labelitemii{\normalfont\bfseries \textendash}
\newcommand\labelitemiii{\textasteriskcentered}
\newcommand\labelitemiv{\textperiodcentered}
\newenvironment{description}
               {\list{}{\labelwidth\z@ \itemindent-\leftmargin
                        \let\makelabel\descriptionlabel}}
               {\endlist}
\newcommand*{\descriptionlabel}[1]{\hspace\labelsep
                                \normalfont\bfseries #1}
\newenvironment{verse}
               {\let\\=\@centercr
                \list{}{\setlength\itemsep{\z@}%
                        \setlength\itemindent{-15\p@}%
                        \setlength\listparindent{\itemindent}%
                        \setlength\rightmargin{\leftmargin}%
                        \addtolength\leftmargin{15\p@}}%
                \item[]}
               {\endlist}
\newenvironment{quotation}
               {\list{}{\setlength\listparindent{1.5em}%
                        \setlength\itemindent{\listparindent}%
                        \setlength\rightmargin{\leftmargin}}%
                \item[]}
               {\endlist}
\newenvironment{quote}
               {\list{}{\setlength\rightmargin{\leftmargin}}%
                \item[]}
               {\endlist}
\setlength\arraycolsep{5\p@}
\setlength\tabcolsep{6\p@}
\setlength\arrayrulewidth{.4\p@}
\setlength\doublerulesep{2\p@}
\setlength\tabbingsep{\labelsep}
\skip\@mpfootins = \skip\footins
\setlength\fboxsep{3\p@}
\setlength\fboxrule{.4\p@}
\renewcommand\theequation{\@arabic\c@equation}
\DeclareOldFontCommand{\rm}{\normalfont\rmfamily}{\mathrm}
\DeclareOldFontCommand{\sf}{\normalfont\sffamily}{\mathsf}
\DeclareOldFontCommand{\tt}{\normalfont\ttfamily}{\mathtt}
\DeclareOldFontCommand{\bf}{\normalfont\bfseries}{\mathbf}
\DeclareOldFontCommand{\it}{\normalfont\itshape}{\mathit}
\DeclareOldFontCommand{\sl}{\normalfont\slshape}{\relax}
\DeclareOldFontCommand{\sc}{\normalfont\scshape}{\relax}
\DeclareRobustCommand*{\cal}{\@fontswitch{\relax}{\mathcal}}
\DeclareRobustCommand*{\mit}{\@fontswitch{\relax}{\mathnormal}}
\renewcommand\footnoterule{%
  \kern-\p@
  \hrule \@width .4\columnwidth
  \kern .6\p@}
\long\def\@makefntext#1{%
    \noindent
    \hangindent 5\p@
    \hb@xt@5\p@{\hss\@makefnmark}#1}
\newcommand*{\Toname}{To}
\newcommand*{\Fromname}{From}
\newcommand*{\Datename}{Date}
\newcommand*{\Subjectname}{Subject}
\newcommand*{\Ccname}{cc}
\newcommand*{\enclname}{encl}
\newcommand*{\pagename}{Page}
\newcommand*{\headtoname}{To}
\newcommand*{\today}{\ifcase\month\or
  January\or February\or March\or April\or May\or June\or
  July\or August\or September\or October\or November\or December\fi
  \space\number\day, \number\year}
\setlength\columnsep{10\p@}
\setlength\columnseprule{0\p@}
\pagestyle{plain}
\pagenumbering{arabic}
\raggedbottom
\def\@texttop{\ifnum\c@page=1\vskip \z@ plus.00006fil\relax\fi}
\onecolumn
\endinput
%%
%% End of file `memo.cls'.

[-- Attachment #3: Bot.memo --]
[-- Type: application/octet-stream, Size: 50 bytes --]


\end{memo}
\end{document}
#Generated by org-mode

[-- Attachment #4: Type: text/plain, Size: 201 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Please use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 2%]

* Re: Bug: Incorrect escaping of braces on LaTeX export [6.33trans (release_6.33f.122.g7062a.dirty)]
  2009-12-18  8:08  0%     ` Carsten Dominik
@ 2009-12-18 18:13  0%       ` Mark Elston
  0 siblings, 0 replies; 59+ results
From: Mark Elston @ 2009-12-18 18:13 UTC (permalink / raw)
  To: Carsten Dominik; +Cc: emacs-orgmode

Thank you very much, Carsten.  I can confirm it works perfectly now.

Mark

Carsten Dominik wrote:
> Hi Mark,
> 
> On Dec 18, 2009, at 12:16 AM, Mark Elston wrote:
> 
>> Carsten,
>>
>> Notice the title line in the generated latex code.  It looks like:
>>
>>    \title{ABC Class Notes\}
>>                          ^^
> 
> Ah, yes, it was actually in your first email, only further down that I 
> expected.  Sorry about this.
> 
> This problem is now fixed.
> 
> - Carsten
> 
>>
>> The closing brace is escaped.
>>
>> Mark
>>
>> Carsten Dominik wrote:
>>> Hi Mark,
>>> what is the error you are getting?
>>> - Carsten
>>> On Dec 17, 2009, at 1:05 AM, Mark Elston wrote:
>>>>
>>>> Remember to cover the basics, that is, what you expected to happen and
>>>> what in fact did happen.  You don't know how to make a good report?  
>>>> See
>>>>
>>>>    http://orgmode.org/manual/Feedback.html#Feedback
>>>>
>>>> Your bug report will be posted to the Org-mode mailing list.
>>>> ------------------------------------------------------------------------ 
>>>>
>>>>
>>>> While attempting to generate some notes for a class I give I ran into
>>>> an error in the generated latex file.  I use memoir for my notes since
>>>> this package gives me the particular formatting I like without any
>>>> hassle so I created an org-export-latex-class to make use of it.
>>>> Since my boilerplate for my notes includes a number of lines after the
>>>> \begin{document} line I have added these to #+TEXT entries in the org
>>>> file.
>>>>
>>>> I use the memoir titlingpage facility as it gives me the control and
>>>> look I want without a lot of code.  However, this causes a problem
>>>> with org export since the \maketitle line must be inside a titlingpage
>>>> environment. To accomplish this I have set the #+TITLE: directive to
>>>> an empty value and put the entire titlingpage environment (3 lines) in
>>>> #+TEXT lines.
>>>>
>>>> I have included a simple ErrorSample latex class in my configuration
>>>> which demonstrates the problem without as much being generated.
>>>>
>>>> A sample org file looks like this:
>>>>
>>>> -----------------------------------------------------------------------
>>>> #+TITLE:
>>>> #+OPTIONS: toc:nil
>>>> #+LaTeX_CLASS: ErrorSample
>>>> #+TEXT: \title{ABC Class Notes}
>>>> #+TEXT: \begin{titlingpage}
>>>> #+TEXT: \maketitle
>>>> #+TEXT: \end{titlingpage}
>>>> #+TEXT: \maxtocdepth{subsection}
>>>> #+TEXT: \pagenumbering{roman}
>>>> #+TEXT: \cleartooddpage
>>>> #+TEXT: \tableofcontents
>>>> #+TEXT: \cleartooddpage
>>>> #+TEXT: \chapterstyle{companion}
>>>> #+TEXT: \pagestyle{companion}
>>>> #+TEXT: \aliaspagestyle{part}{companion}
>>>> #+TEXT: \aliaspagestyle{chapter}{headings}
>>>> #+TEXT: \aliaspagestyle{cleared}{companion}
>>>> #+TEXT: \include{Preface}
>>>> #+TEXT: \pagenumbering{arabic}
>>>>
>>>> * Simple First Heading
>>>> Some text.
>>>>
>>>> * Simple Second Heading
>>>> Other text.
>>>> -----------------------------------------------------------------------
>>>>
>>>> The generated tex file is shown next.  Notice the escaped closing
>>>> brace on the \title{} instruction:
>>>>
>>>> -----------------------------------------------------------------------
>>>> % Created 2009-12-16 Wed 15:54
>>>> \documentclass[letter,twoside,openright]{memoir}
>>>> \usepackage{varioref}
>>>> \usepackage{shorttoc}
>>>> \usepackage{color}
>>>> \usepackage{graphicx}
>>>> \usepackage{bbding}
>>>>
>>>> \setlength{\parindent}{0pt}
>>>> \setlength{\parskip}{1ex}
>>>>
>>>>
>>>> \title{}
>>>> \author{Mark Elston}
>>>> \date{16 December 2009}
>>>>
>>>> \begin{document}
>>>>
>>>>
>>>>
>>>> \title{ABC Class Notes\}
>>>> \begin{titlingpage}
>>>> \maketitle
>>>> \end{titlingpage}
>>>> \maxtocdepth{subsection}
>>>> \pagenumbering{roman}
>>>> \cleartooddpage
>>>> \tableofcontents
>>>> \cleartooddpage
>>>> \chapterstyle{companion}
>>>> \pagestyle{companion}
>>>> \aliaspagestyle{part}{companion}
>>>> \aliaspagestyle{chapter}{headings}
>>>> \aliaspagestyle{cleared}{companion}
>>>> \include{Preface}
>>>> \pagenumbering{arabic}
>>>>
>>>>
>>>> \chapter{Simple First Heading}
>>>> \label{sec-1}
>>>>
>>>> Some text.
>>>> \chapter{Simple Second Heading}
>>>> \label{sec-2}
>>>>
>>>> Other text.
>>>>
>>>> \end{document}
>>>>
>>>> -----------------------------------------------------------------------
>>>>
>>>> Emacs  : GNU Emacs 23.1.1 (i386-mingw-nt6.0.6002)
>>>> of 2009-07-29 on SOFT-MJASON
>>>> Package: Org-mode version 6.33trans (release_6.33f.122.g7062a.dirty)
>>>>
>>>> current state:
>>>> ==============
>>>> (setq
>>>> org-log-done 'time
>>>> org-export-latex-after-initial-vars-hook 
>>>> '(org-beamer-after-initial-vars)
>>>> org-agenda-custom-commands '(("S" "Schedule for the week" ((agenda 
>>>> "") (todo "TODO"))))
>>>> org-agenda-files '("~/org")
>>>> org-agenda-include-diary t
>>>> org-blocker-hook '(org-block-todo-from-children-or-siblings-or-parent
>>>>                   org-block-todo-from-checkboxes)
>>>> org-list-demote-modify-bullet '(("-" . "+") ("+" . "-"))
>>>> org-fontify-whole-heading-line t
>>>> org-metaup-hook '(org-babel-load-in-session-maybe)
>>>> org-agenda-skip-timestamp-if-done t
>>>> org-after-todo-state-change-hook '(org-clock-out-if-current)
>>>> org-babel-interpreters '("R" "asymptote" "dot" "ditaa" "python" "sh" 
>>>> "emacs-lisp")
>>>> org-export-latex-format-toc-function 
>>>> 'org-export-latex-format-toc-default
>>>> org-protocol-protocol-alist '(("Fireforg get bibtex entry: 
>>>> fireforg-bibtex-entry://<bibtex entry (encoded)>" :protocol 
>>>> "fireforg-bibtex-entry" :function org-fireforg-receive-bibtex-entry)
>>>>                              ("Fireforg show annotation: 
>>>> fireforg-show-annotation://<file (encoded)>/<header (encoded)>" 
>>>> :protocol "fireforg-show-annotation" :function 
>>>> org-fireforg-show-annotation)
>>>>                              )
>>>> org-agenda-skip-scheduled-if-done t
>>>> org-export-preprocess-hook '(org-export-blocks-preprocess)
>>>> org-tab-first-hook '(yas/org-very-safe-expand 
>>>> org-babel-hide-result-toggle-maybe
>>>>                     org-hide-block-toggle-maybe)
>>>> org-src-mode-hook '(org-src-mode-configure-edit-buffer)
>>>> org-confirm-shell-link-function 'yes-or-no-p
>>>> org-export-first-hook '(org-beamer-initialize-open-trackers)
>>>> org-agenda-before-write-hook '(org-agenda-add-entry-text)
>>>> org-directory "~/org/"
>>>> org-cycle-hook '(org-cycle-hide-archived-subtrees 
>>>> org-cycle-hide-drawers
>>>>                 org-cycle-show-empty-lines 
>>>> org-optimize-window-after-visibility-change)
>>>> org-export-latex-classes '(("article"
>>>> "\\documentclass[11pt]{article}\n\\usepackage[utf8]{inputenc}\n\\usepackage[T1]{fontenc}\n\\usepackage{graphicx}\n\\usepackage{longtable}\n\\usepackage{float}\n\\usepackage{wrapfig}\n\\usepackage{soul}\n\\usepackage{amssymb}\n\\usepackage{hyperref}" 
>>>>
>>>>                            ("\\section{%s}" . "\\section*{%s}")
>>>>                            ("\\subsection{%s}" . "\\subsection*{%s}")
>>>>                            ("\\subsubsection{%s}" . 
>>>> "\\subsubsection*{%s}")
>>>>                            ("\\paragraph{%s}" . "\\paragraph*{%s}")
>>>>                            ("\\subparagraph{%s}" . 
>>>> "\\subparagraph*{%s}"))
>>>>                           ("report"
>>>> "\\documentclass[11pt]{report}\n\\usepackage[utf8]{inputenc}\n\\usepackage[T1]{fontenc}\n\\usepackage{graphicx}\n\\usepackage{longtable}\n\\usepackage{float}\n\\usepackage{wrapfig}\n\\usepackage{soul}\n\\usepackage{amssymb}\n\\usepackage{hyperref}" 
>>>>
>>>>                            ("\\part{%s}" . "\\part*{%s}")
>>>>                            ("\\chapter{%s}" . "\\chapter*{%s}")
>>>>                            ("\\section{%s}" . "\\section*{%s}")
>>>>                            ("\\subsection{%s}" . "\\subsection*{%s}")
>>>>                            ("\\subsubsection{%s}" . 
>>>> "\\subsubsection*{%s}"))
>>>>                           ("book"
>>>> "\\documentclass[11pt]{book}\n\\usepackage[utf8]{inputenc}\n\\usepackage[T1]{fontenc}\n\\usepackage{graphicx}\n\\usepackage{longtable}\n\\usepackage{float}\n\\usepackage{wrapfig}\n\\usepackage{soul}\n\\usepackage{amssymb}\n\\usepackage{hyperref}" 
>>>>
>>>>                            ("\\part{%s}" . "\\part*{%s}")
>>>>                            ("\\chapter{%s}" . "\\chapter*{%s}")
>>>>                            ("\\section{%s}" . "\\section*{%s}")
>>>>                            ("\\subsection{%s}" . "\\subsection*{%s}")
>>>>                            ("\\subsubsection{%s}" . 
>>>> "\\subsubsection*{%s}"))
>>>>                           ("ClassNotes"
>>>> "\\documentclass[letter,twoside,openright]{memoir}\n\\usepackage{varioref}\n\\usepackage{shorttoc}\n\\usepackage{color}\n\\usepackage{graphicx}\n\\usepackage{biblestudy}\n\\usepackage[polutonikogreek,english]{babel}\n\\usepackage{cjhebrew}\n\\usepackage{bbding}\n\n\\newcommand\\checkmark{\\Checkmark}\n\\newcommand\\xmark{\\XSolidBold}\n\n\\newcommand\\gr[1]{\\begingroup%\n  
>>>> \\selectlanguage{greek}#1%\n 
>>>> \\endgroup}\n\n\\newcommand\\heb[1]{\\begingroup%\n  \\cjRL{#1}%\n 
>>>> \\endgroup}\n\n\\setlength{\\parindent}{0pt}\n\\setlength{\\parskip}{1ex}" 
>>>>
>>>>                            ("\\chapter{%s}" . "\\chapter*{%s}")
>>>>                            ("\\section{%s}" . "\\section*{%s}")
>>>>                            ("\\subsection{%s}" . "\\subsection*{%s}")
>>>>                            ("\\subsubsection{%s}" . 
>>>> "\\subsubsection*{%s}"))
>>>>                           ("ErrorSample"
>>>> "\\documentclass[letter,twoside,openright]{memoir}\n\\usepackage{varioref}\n\\usepackage{shorttoc}\n\\usepackage{color}\n\\usepackage{graphicx}\n\\usepackage{bbding}\n\n\\setlength{\\parindent}{0pt}\n\\setlength{\\parskip}{1ex}" 
>>>>
>>>>                            ("\\chapter{%s}" . "\\chapter*{%s}")
>>>>                            ("\\section{%s}" . "\\section*{%s}")
>>>>                            ("\\subsection{%s}" . "\\subsection*{%s}")
>>>>                            ("\\subsubsection{%s}" . 
>>>> "\\subsubsection*{%s}"))
>>>>                           )
>>>> org-use-speed-commands t
>>>> org-mode-hook '((lambda nil
>>>>                 (setq org-mouse-context-menu-function (quote 
>>>> org-mouse-context-menu))
>>>>                 (when (memq (quote context-menu) org-mouse-features)
>>>>                  (define-key org-mouse-map
>>>>                   (if (featurep (quote xemacs)) [button3] [mouse-3]) 
>>>> nil)
>>>>                  (define-key org-mode-map [mouse-3]
>>>>                   (quote org-mouse-show-context-menu))
>>>>                  )
>>>>                 (define-key org-mode-map [down-mouse-1] (quote 
>>>> org-mouse-down-mouse))
>>>>                 (when (memq (quote context-menu) org-mouse-features)
>>>>                  (define-key org-mouse-map [C-drag-mouse-1]
>>>>                   (quote org-mouse-move-tree))
>>>>                  (define-key org-mouse-map [C-down-mouse-1]
>>>>                   (quote org-mouse-move-tree-start))
>>>>                  )
>>>>                 (when (memq (quote yank-link) org-mouse-features)
>>>>                  (define-key org-mode-map [S-mouse-2] (quote 
>>>> org-mouse-yank-link))
>>>>                  (define-key org-mode-map [drag-mouse-3] (quote 
>>>> org-mouse-yank-link)))
>>>>                 (when (memq (quote move-tree) org-mouse-features)
>>>>                  (define-key org-mouse-map [drag-mouse-3] (quote 
>>>> org-mouse-move-tree))
>>>>                  (define-key org-mouse-map [down-mouse-3]
>>>>                   (quote org-mouse-move-tree-start))
>>>>                  )
>>>>                 (when (memq (quote activate-stars) org-mouse-features)
>>>>                  (font-lock-add-keywords nil
>>>>                   (\`
>>>>                    (((\, outline-regexp) 0
>>>>                      (\`
>>>>                       (face org-link mouse-face highlight keymap (\, 
>>>> org-mouse-map)))
>>>>                      (quote prepend))
>>>>                     )
>>>>                    )
>>>>                   t)
>>>>                  )
>>>>                 (when (memq (quote activate-bullets) 
>>>> org-mouse-features)
>>>>                  (font-lock-add-keywords nil
>>>>                   (\`
>>>>                    (("^[     ]*\\([-+*]\\|[0-9]+[.)]\\) +"
>>>>                      (1
>>>>                       (\`
>>>>                        (face org-link keymap (\, org-mouse-map) 
>>>> mouse-face highlight))
>>>>                       (quote prepend))
>>>>                      )
>>>>                     )
>>>>                    )
>>>>                   t)
>>>>                  )
>>>>                 (when (memq (quote activate-checkboxes) 
>>>> org-mouse-features)
>>>>                  (font-lock-add-keywords nil
>>>>                   (\`
>>>>                    (("^[     ]*\\([-+*]\\|[0-9]+[.)]\\) +\\(\\[[ 
>>>> X]\\]\\)"
>>>>                      (2
>>>>                       (\` (face bold keymap (\, org-mouse-map) 
>>>> mouse-face highlight))
>>>>                       t)
>>>>                      )
>>>>                     )
>>>>                    )
>>>>                   t)
>>>>                  )
>>>>                 (defadvice org-open-at-point (around 
>>>> org-mouse-open-at-point activate)
>>>>                  (let ((context (org-context)))
>>>>                   (cond ((assq :headline-stars context) (org-cycle))
>>>>                    ((assq :checkbox context) (org-toggle-checkbox))
>>>>                    ((assq :item-bullet context)
>>>>                     (let ((org-cycle-include-plain-lists t)) 
>>>> (org-cycle)))
>>>>                    (t ad-do-it))
>>>>                   )
>>>>                  )
>>>>                 )
>>>>                #[nil "\302\300!\210\303\x10\304\305\306\"\210\307 
>>>> \310\311#\207"
>>>>                  [yas/trigger-key yas/keymap 
>>>> make-variable-buffer-local [tab]
>>>>                   add-to-list org-tab-first-hook 
>>>> yas/org-very-safe-expand define-key
>>>>                   [tab] yas/next-field]
>>>>                  4]
>>>>                (lambda nil
>>>>                 (org-add-hook (quote change-major-mode-hook)
>>>>                  (quote org-babel-show-result-all) (quote append) 
>>>> (quote local))
>>>>                 )
>>>>                org-babel-result-hide-spec org-babel-hide-all-hashes
>>>>                (lambda nil
>>>>                 (add-hook (quote after-save-hook) (quote 
>>>> org-fireforg-registry-update)
>>>>                  t t)
>>>>                 )
>>>>                #[nil "\300\301\302\303\304$\207"
>>>>                  [org-add-hook change-major-mode-hook 
>>>> org-show-block-all append local]
>>>>                  5]
>>>>                )
>>>> org-ctrl-c-ctrl-c-hook '(org-babel-lob-execute-maybe 
>>>> org-babel-hash-at-point
>>>>                         org-babel-execute-src-block-maybe)
>>>> org-confirm-elisp-link-function 'yes-or-no-p
>>>> org-agenda-mode-hook '((lambda nil
>>>>                        (setq org-mouse-context-menu-function
>>>>                         (quote org-mouse-agenda-context-menu))
>>>>                        (define-key org-agenda-mode-map
>>>>                         (if (featurep (quote xemacs)) [button3] 
>>>> [mouse-3])
>>>>                         (quote org-mouse-show-context-menu))
>>>>                        (define-key org-agenda-mode-map [down-mouse-3]
>>>>                         (quote org-mouse-move-tree-start))
>>>>                        (define-key org-agenda-mode-map
>>>>                         (if (featurep (quote xemacs)) [(control 
>>>> mouse-4)] [C-mouse-4])
>>>>                         (quote org-agenda-earlier))
>>>>                        (define-key org-agenda-mode-map
>>>>                         (if (featurep (quote xemacs)) [(control 
>>>> mouse-5)] [C-mouse-5])
>>>>                         (quote org-agenda-later))
>>>>                        (define-key org-agenda-mode-map [drag-mouse-3]
>>>>                         (quote
>>>>                          (lambda (event) (interactive "e")
>>>>                           (case (org-mouse-get-gesture event)
>>>>                            (:left (org-agenda-earlier 1))
>>>>                            (:right (org-agenda-later 1)))
>>>>                           )
>>>>                          )
>>>>                         )
>>>>                        )
>>>>                       )
>>>> org-agenda-start-on-weekday nil
>>>> org-export-interblocks '((lob org-babel-exp-lob-one-liners)
>>>>                         (src org-babel-exp-inline-src-blocks))
>>>> org-agenda-skip-deadline-if-done t
>>>> org-enforce-todo-dependencies t
>>>> org-occur-hook '(org-first-headline-recenter)
>>>> org-from-is-user-regexp nil
>>>> org-export-preprocess-before-selecting-backend-code-hook 
>>>> '(org-beamer-select-beamer-code)
>>>> org-remember-templates '(("Todo" 116 "* TODO %?\n  %i\n  %a\n" 
>>>> "~/org/TODO.org" "Tasks")
>>>>                         ("Journal" 106 "* %U %?\n\n  %i\n  %a\n" 
>>>> "~/org/JOURNAL.org")
>>>>                         ("Idea" 105 "* %^{Title}\n  %i\n  %a\n" 
>>>> "~/org/JOURNAL.org"
>>>>                          "New Ideas")
>>>>                         ("Project" 112 "* %^{Title}\n  %i\n  %a\n"
>>>>                          "~/org/ProjectNotes.org" "Project Notes")
>>>>                         ("Browser" 119 "* %^{Title}\n  %u\n\n 
>>>> Source: %c\n\n  %i"
>>>>                          "~/org/Notes.org" "Notes")
>>>>                         )
>>>> org-export-latex-final-hook '(org-beamer-amend-header 
>>>> org-beamer-fix-toc
>>>>                              org-beamer-auto-fragile-frames
>>>>                              
>>>> org-beamer-place-default-actions-for-lists)
>>>> org-enforce-todo-checkbox-dependencies t
>>>> org-metadown-hook '(org-babel-pop-to-session-maybe)
>>>> org-export-blocks '((src org-babel-exp-src-blocks nil)
>>>>                    (comment org-export-blocks-format-comment t)
>>>>                    (ditaa org-export-blocks-format-ditaa nil)
>>>>                    (dot org-export-blocks-format-dot nil))
>>>> )
>>>>
>>>>
>>>>
>>>> _______________________________________________
>>>> Emacs-orgmode mailing list
>>>> Please use `Reply All' to send replies to the list.
>>>> Emacs-orgmode@gnu.org
>>>> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
>>> - Carsten
>>
> 
> - Carsten
> 
> 
> 
> 

^ permalink raw reply	[relevance 0%]

* Re: Bug: Incorrect escaping of braces on LaTeX export [6.33trans (release_6.33f.122.g7062a.dirty)]
  2009-12-17 23:16  0%   ` Mark Elston
@ 2009-12-18  8:08  0%     ` Carsten Dominik
  2009-12-18 18:13  0%       ` Mark Elston
  0 siblings, 1 reply; 59+ results
From: Carsten Dominik @ 2009-12-18  8:08 UTC (permalink / raw)
  To: Mark Elston; +Cc: emacs-orgmode

Hi Mark,

On Dec 18, 2009, at 12:16 AM, Mark Elston wrote:

> Carsten,
>
> Notice the title line in the generated latex code.  It looks like:
>
>    \title{ABC Class Notes\}
>                          ^^

Ah, yes, it was actually in your first email, only further down that I  
expected.  Sorry about this.

This problem is now fixed.

- Carsten

>
> The closing brace is escaped.
>
> Mark
>
> Carsten Dominik wrote:
>> Hi Mark,
>> what is the error you are getting?
>> - Carsten
>> On Dec 17, 2009, at 1:05 AM, Mark Elston wrote:
>>>
>>> Remember to cover the basics, that is, what you expected to happen  
>>> and
>>> what in fact did happen.  You don't know how to make a good  
>>> report?  See
>>>
>>>    http://orgmode.org/manual/Feedback.html#Feedback
>>>
>>> Your bug report will be posted to the Org-mode mailing list.
>>> ------------------------------------------------------------------------
>>>
>>> While attempting to generate some notes for a class I give I ran  
>>> into
>>> an error in the generated latex file.  I use memoir for my notes  
>>> since
>>> this package gives me the particular formatting I like without any
>>> hassle so I created an org-export-latex-class to make use of it.
>>> Since my boilerplate for my notes includes a number of lines after  
>>> the
>>> \begin{document} line I have added these to #+TEXT entries in the  
>>> org
>>> file.
>>>
>>> I use the memoir titlingpage facility as it gives me the control and
>>> look I want without a lot of code.  However, this causes a problem
>>> with org export since the \maketitle line must be inside a  
>>> titlingpage
>>> environment. To accomplish this I have set the #+TITLE: directive to
>>> an empty value and put the entire titlingpage environment (3  
>>> lines) in
>>> #+TEXT lines.
>>>
>>> I have included a simple ErrorSample latex class in my configuration
>>> which demonstrates the problem without as much being generated.
>>>
>>> A sample org file looks like this:
>>>
>>> -----------------------------------------------------------------------
>>> #+TITLE:
>>> #+OPTIONS: toc:nil
>>> #+LaTeX_CLASS: ErrorSample
>>> #+TEXT: \title{ABC Class Notes}
>>> #+TEXT: \begin{titlingpage}
>>> #+TEXT: \maketitle
>>> #+TEXT: \end{titlingpage}
>>> #+TEXT: \maxtocdepth{subsection}
>>> #+TEXT: \pagenumbering{roman}
>>> #+TEXT: \cleartooddpage
>>> #+TEXT: \tableofcontents
>>> #+TEXT: \cleartooddpage
>>> #+TEXT: \chapterstyle{companion}
>>> #+TEXT: \pagestyle{companion}
>>> #+TEXT: \aliaspagestyle{part}{companion}
>>> #+TEXT: \aliaspagestyle{chapter}{headings}
>>> #+TEXT: \aliaspagestyle{cleared}{companion}
>>> #+TEXT: \include{Preface}
>>> #+TEXT: \pagenumbering{arabic}
>>>
>>> * Simple First Heading
>>> Some text.
>>>
>>> * Simple Second Heading
>>> Other text.
>>> -----------------------------------------------------------------------
>>>
>>> The generated tex file is shown next.  Notice the escaped closing
>>> brace on the \title{} instruction:
>>>
>>> -----------------------------------------------------------------------
>>> % Created 2009-12-16 Wed 15:54
>>> \documentclass[letter,twoside,openright]{memoir}
>>> \usepackage{varioref}
>>> \usepackage{shorttoc}
>>> \usepackage{color}
>>> \usepackage{graphicx}
>>> \usepackage{bbding}
>>>
>>> \setlength{\parindent}{0pt}
>>> \setlength{\parskip}{1ex}
>>>
>>>
>>> \title{}
>>> \author{Mark Elston}
>>> \date{16 December 2009}
>>>
>>> \begin{document}
>>>
>>>
>>>
>>> \title{ABC Class Notes\}
>>> \begin{titlingpage}
>>> \maketitle
>>> \end{titlingpage}
>>> \maxtocdepth{subsection}
>>> \pagenumbering{roman}
>>> \cleartooddpage
>>> \tableofcontents
>>> \cleartooddpage
>>> \chapterstyle{companion}
>>> \pagestyle{companion}
>>> \aliaspagestyle{part}{companion}
>>> \aliaspagestyle{chapter}{headings}
>>> \aliaspagestyle{cleared}{companion}
>>> \include{Preface}
>>> \pagenumbering{arabic}
>>>
>>>
>>> \chapter{Simple First Heading}
>>> \label{sec-1}
>>>
>>> Some text.
>>> \chapter{Simple Second Heading}
>>> \label{sec-2}
>>>
>>> Other text.
>>>
>>> \end{document}
>>>
>>> -----------------------------------------------------------------------
>>>
>>> Emacs  : GNU Emacs 23.1.1 (i386-mingw-nt6.0.6002)
>>> of 2009-07-29 on SOFT-MJASON
>>> Package: Org-mode version 6.33trans (release_6.33f.122.g7062a.dirty)
>>>
>>> current state:
>>> ==============
>>> (setq
>>> org-log-done 'time
>>> org-export-latex-after-initial-vars-hook '(org-beamer-after- 
>>> initial-vars)
>>> org-agenda-custom-commands '(("S" "Schedule for the week" ((agenda  
>>> "") (todo "TODO"))))
>>> org-agenda-files '("~/org")
>>> org-agenda-include-diary t
>>> org-blocker-hook '(org-block-todo-from-children-or-siblings-or- 
>>> parent
>>>                   org-block-todo-from-checkboxes)
>>> org-list-demote-modify-bullet '(("-" . "+") ("+" . "-"))
>>> org-fontify-whole-heading-line t
>>> org-metaup-hook '(org-babel-load-in-session-maybe)
>>> org-agenda-skip-timestamp-if-done t
>>> org-after-todo-state-change-hook '(org-clock-out-if-current)
>>> org-babel-interpreters '("R" "asymptote" "dot" "ditaa" "python"  
>>> "sh" "emacs-lisp")
>>> org-export-latex-format-toc-function 'org-export-latex-format-toc- 
>>> default
>>> org-protocol-protocol-alist '(("Fireforg get bibtex entry:  
>>> fireforg-bibtex-entry://<bibtex entry (encoded)>" :protocol  
>>> "fireforg-bibtex-entry" :function org-fireforg-receive-bibtex-entry)
>>>                              ("Fireforg show annotation: fireforg- 
>>> show-annotation://<file (encoded)>/<header (encoded)>" :protocol  
>>> "fireforg-show-annotation" :function org-fireforg-show-annotation)
>>>                              )
>>> org-agenda-skip-scheduled-if-done t
>>> org-export-preprocess-hook '(org-export-blocks-preprocess)
>>> org-tab-first-hook '(yas/org-very-safe-expand org-babel-hide- 
>>> result-toggle-maybe
>>>                     org-hide-block-toggle-maybe)
>>> org-src-mode-hook '(org-src-mode-configure-edit-buffer)
>>> org-confirm-shell-link-function 'yes-or-no-p
>>> org-export-first-hook '(org-beamer-initialize-open-trackers)
>>> org-agenda-before-write-hook '(org-agenda-add-entry-text)
>>> org-directory "~/org/"
>>> org-cycle-hook '(org-cycle-hide-archived-subtrees org-cycle-hide- 
>>> drawers
>>>                 org-cycle-show-empty-lines org-optimize-window- 
>>> after-visibility-change)
>>> org-export-latex-classes '(("article"
>>> "\\documentclass[11pt]{article}\n\\usepackage[utf8]{inputenc}\n\ 
>>> \usepackage[T1]{fontenc}\n\\usepackage{graphicx}\n\ 
>>> \usepackage{longtable}\n\\usepackage{float}\n\\usepackage{wrapfig} 
>>> \n\\usepackage{soul}\n\\usepackage{amssymb}\n\\usepackage{hyperref}"
>>>                            ("\\section{%s}" . "\\section*{%s}")
>>>                            ("\\subsection{%s}" . "\ 
>>> \subsection*{%s}")
>>>                            ("\\subsubsection{%s}" . "\ 
>>> \subsubsection*{%s}")
>>>                            ("\\paragraph{%s}" . "\\paragraph*{%s}")
>>>                            ("\\subparagraph{%s}" . "\ 
>>> \subparagraph*{%s}"))
>>>                           ("report"
>>> "\\documentclass[11pt]{report}\n\\usepackage[utf8]{inputenc}\n\ 
>>> \usepackage[T1]{fontenc}\n\\usepackage{graphicx}\n\ 
>>> \usepackage{longtable}\n\\usepackage{float}\n\\usepackage{wrapfig} 
>>> \n\\usepackage{soul}\n\\usepackage{amssymb}\n\\usepackage{hyperref}"
>>>                            ("\\part{%s}" . "\\part*{%s}")
>>>                            ("\\chapter{%s}" . "\\chapter*{%s}")
>>>                            ("\\section{%s}" . "\\section*{%s}")
>>>                            ("\\subsection{%s}" . "\ 
>>> \subsection*{%s}")
>>>                            ("\\subsubsection{%s}" . "\ 
>>> \subsubsection*{%s}"))
>>>                           ("book"
>>> "\\documentclass[11pt]{book}\n\\usepackage[utf8]{inputenc}\n\ 
>>> \usepackage[T1]{fontenc}\n\\usepackage{graphicx}\n\ 
>>> \usepackage{longtable}\n\\usepackage{float}\n\\usepackage{wrapfig} 
>>> \n\\usepackage{soul}\n\\usepackage{amssymb}\n\\usepackage{hyperref}"
>>>                            ("\\part{%s}" . "\\part*{%s}")
>>>                            ("\\chapter{%s}" . "\\chapter*{%s}")
>>>                            ("\\section{%s}" . "\\section*{%s}")
>>>                            ("\\subsection{%s}" . "\ 
>>> \subsection*{%s}")
>>>                            ("\\subsubsection{%s}" . "\ 
>>> \subsubsection*{%s}"))
>>>                           ("ClassNotes"
>>> "\\documentclass[letter,twoside,openright]{memoir}\n\ 
>>> \usepackage{varioref}\n\\usepackage{shorttoc}\n\\usepackage{color} 
>>> \n\\usepackage{graphicx}\n\\usepackage{biblestudy}\n\ 
>>> \usepackage[polutonikogreek,english]{babel}\n\\usepackage{cjhebrew} 
>>> \n\\usepackage{bbding}\n\n\\newcommand\\checkmark{\\Checkmark}\n\ 
>>> \newcommand\\xmark{\\XSolidBold}\n\n\\newcommand\\gr[1]{\ 
>>> \begingroup%\n  \\selectlanguage{greek}#1%\n \\endgroup}\n\n\ 
>>> \newcommand\\heb[1]{\\begingroup%\n  \\cjRL{#1}%\n \\endgroup}\n\n\ 
>>> \setlength{\\parindent}{0pt}\n\\setlength{\\parskip}{1ex}"
>>>                            ("\\chapter{%s}" . "\\chapter*{%s}")
>>>                            ("\\section{%s}" . "\\section*{%s}")
>>>                            ("\\subsection{%s}" . "\ 
>>> \subsection*{%s}")
>>>                            ("\\subsubsection{%s}" . "\ 
>>> \subsubsection*{%s}"))
>>>                           ("ErrorSample"
>>> "\\documentclass[letter,twoside,openright]{memoir}\n\ 
>>> \usepackage{varioref}\n\\usepackage{shorttoc}\n\\usepackage{color} 
>>> \n\\usepackage{graphicx}\n\\usepackage{bbding}\n\n\\setlength{\ 
>>> \parindent}{0pt}\n\\setlength{\\parskip}{1ex}"
>>>                            ("\\chapter{%s}" . "\\chapter*{%s}")
>>>                            ("\\section{%s}" . "\\section*{%s}")
>>>                            ("\\subsection{%s}" . "\ 
>>> \subsection*{%s}")
>>>                            ("\\subsubsection{%s}" . "\ 
>>> \subsubsection*{%s}"))
>>>                           )
>>> org-use-speed-commands t
>>> org-mode-hook '((lambda nil
>>>                 (setq org-mouse-context-menu-function (quote org- 
>>> mouse-context-menu))
>>>                 (when (memq (quote context-menu) org-mouse-features)
>>>                  (define-key org-mouse-map
>>>                   (if (featurep (quote xemacs)) [button3]  
>>> [mouse-3]) nil)
>>>                  (define-key org-mode-map [mouse-3]
>>>                   (quote org-mouse-show-context-menu))
>>>                  )
>>>                 (define-key org-mode-map [down-mouse-1] (quote org- 
>>> mouse-down-mouse))
>>>                 (when (memq (quote context-menu) org-mouse-features)
>>>                  (define-key org-mouse-map [C-drag-mouse-1]
>>>                   (quote org-mouse-move-tree))
>>>                  (define-key org-mouse-map [C-down-mouse-1]
>>>                   (quote org-mouse-move-tree-start))
>>>                  )
>>>                 (when (memq (quote yank-link) org-mouse-features)
>>>                  (define-key org-mode-map [S-mouse-2] (quote org- 
>>> mouse-yank-link))
>>>                  (define-key org-mode-map [drag-mouse-3] (quote  
>>> org-mouse-yank-link)))
>>>                 (when (memq (quote move-tree) org-mouse-features)
>>>                  (define-key org-mouse-map [drag-mouse-3] (quote  
>>> org-mouse-move-tree))
>>>                  (define-key org-mouse-map [down-mouse-3]
>>>                   (quote org-mouse-move-tree-start))
>>>                  )
>>>                 (when (memq (quote activate-stars) org-mouse- 
>>> features)
>>>                  (font-lock-add-keywords nil
>>>                   (\`
>>>                    (((\, outline-regexp) 0
>>>                      (\`
>>>                       (face org-link mouse-face highlight keymap  
>>> (\, org-mouse-map)))
>>>                      (quote prepend))
>>>                     )
>>>                    )
>>>                   t)
>>>                  )
>>>                 (when (memq (quote activate-bullets) org-mouse- 
>>> features)
>>>                  (font-lock-add-keywords nil
>>>                   (\`
>>>                    (("^[     ]*\\([-+*]\\|[0-9]+[.)]\\) +"
>>>                      (1
>>>                       (\`
>>>                        (face org-link keymap (\, org-mouse-map)  
>>> mouse-face highlight))
>>>                       (quote prepend))
>>>                      )
>>>                     )
>>>                    )
>>>                   t)
>>>                  )
>>>                 (when (memq (quote activate-checkboxes) org-mouse- 
>>> features)
>>>                  (font-lock-add-keywords nil
>>>                   (\`
>>>                    (("^[     ]*\\([-+*]\\|[0-9]+[.)]\\) +\\(\\[[ X] 
>>> \\]\\)"
>>>                      (2
>>>                       (\` (face bold keymap (\, org-mouse-map)  
>>> mouse-face highlight))
>>>                       t)
>>>                      )
>>>                     )
>>>                    )
>>>                   t)
>>>                  )
>>>                 (defadvice org-open-at-point (around org-mouse- 
>>> open-at-point activate)
>>>                  (let ((context (org-context)))
>>>                   (cond ((assq :headline-stars context) (org-cycle))
>>>                    ((assq :checkbox context) (org-toggle-checkbox))
>>>                    ((assq :item-bullet context)
>>>                     (let ((org-cycle-include-plain-lists t)) (org- 
>>> cycle)))
>>>                    (t ad-do-it))
>>>                   )
>>>                  )
>>>                 )
>>>                #[nil "\302\300!\210\303\x10\304\305\306\"\210\307  
>>> \310\311#\207"
>>>                  [yas/trigger-key yas/keymap make-variable-buffer- 
>>> local [tab]
>>>                   add-to-list org-tab-first-hook yas/org-very-safe- 
>>> expand define-key
>>>                   [tab] yas/next-field]
>>>                  4]
>>>                (lambda nil
>>>                 (org-add-hook (quote change-major-mode-hook)
>>>                  (quote org-babel-show-result-all) (quote append)  
>>> (quote local))
>>>                 )
>>>                org-babel-result-hide-spec org-babel-hide-all-hashes
>>>                (lambda nil
>>>                 (add-hook (quote after-save-hook) (quote org- 
>>> fireforg-registry-update)
>>>                  t t)
>>>                 )
>>>                #[nil "\300\301\302\303\304$\207"
>>>                  [org-add-hook change-major-mode-hook org-show- 
>>> block-all append local]
>>>                  5]
>>>                )
>>> org-ctrl-c-ctrl-c-hook '(org-babel-lob-execute-maybe org-babel- 
>>> hash-at-point
>>>                         org-babel-execute-src-block-maybe)
>>> org-confirm-elisp-link-function 'yes-or-no-p
>>> org-agenda-mode-hook '((lambda nil
>>>                        (setq org-mouse-context-menu-function
>>>                         (quote org-mouse-agenda-context-menu))
>>>                        (define-key org-agenda-mode-map
>>>                         (if (featurep (quote xemacs)) [button3]  
>>> [mouse-3])
>>>                         (quote org-mouse-show-context-menu))
>>>                        (define-key org-agenda-mode-map [down- 
>>> mouse-3]
>>>                         (quote org-mouse-move-tree-start))
>>>                        (define-key org-agenda-mode-map
>>>                         (if (featurep (quote xemacs)) [(control  
>>> mouse-4)] [C-mouse-4])
>>>                         (quote org-agenda-earlier))
>>>                        (define-key org-agenda-mode-map
>>>                         (if (featurep (quote xemacs)) [(control  
>>> mouse-5)] [C-mouse-5])
>>>                         (quote org-agenda-later))
>>>                        (define-key org-agenda-mode-map [drag- 
>>> mouse-3]
>>>                         (quote
>>>                          (lambda (event) (interactive "e")
>>>                           (case (org-mouse-get-gesture event)
>>>                            (:left (org-agenda-earlier 1))
>>>                            (:right (org-agenda-later 1)))
>>>                           )
>>>                          )
>>>                         )
>>>                        )
>>>                       )
>>> org-agenda-start-on-weekday nil
>>> org-export-interblocks '((lob org-babel-exp-lob-one-liners)
>>>                         (src org-babel-exp-inline-src-blocks))
>>> org-agenda-skip-deadline-if-done t
>>> org-enforce-todo-dependencies t
>>> org-occur-hook '(org-first-headline-recenter)
>>> org-from-is-user-regexp nil
>>> org-export-preprocess-before-selecting-backend-code-hook '(org- 
>>> beamer-select-beamer-code)
>>> org-remember-templates '(("Todo" 116 "* TODO %?\n  %i\n  %a\n" "~/ 
>>> org/TODO.org" "Tasks")
>>>                         ("Journal" 106 "* %U %?\n\n  %i\n  %a\n"  
>>> "~/org/JOURNAL.org")
>>>                         ("Idea" 105 "* %^{Title}\n  %i\n  %a\n" "~/ 
>>> org/JOURNAL.org"
>>>                          "New Ideas")
>>>                         ("Project" 112 "* %^{Title}\n  %i\n  %a\n"
>>>                          "~/org/ProjectNotes.org" "Project Notes")
>>>                         ("Browser" 119 "* %^{Title}\n  %u\n\n  
>>> Source: %c\n\n  %i"
>>>                          "~/org/Notes.org" "Notes")
>>>                         )
>>> org-export-latex-final-hook '(org-beamer-amend-header org-beamer- 
>>> fix-toc
>>>                              org-beamer-auto-fragile-frames
>>>                              org-beamer-place-default-actions-for- 
>>> lists)
>>> org-enforce-todo-checkbox-dependencies t
>>> org-metadown-hook '(org-babel-pop-to-session-maybe)
>>> org-export-blocks '((src org-babel-exp-src-blocks nil)
>>>                    (comment org-export-blocks-format-comment t)
>>>                    (ditaa org-export-blocks-format-ditaa nil)
>>>                    (dot org-export-blocks-format-dot nil))
>>> )
>>>
>>>
>>>
>>> _______________________________________________
>>> Emacs-orgmode mailing list
>>> Please use `Reply All' to send replies to the list.
>>> Emacs-orgmode@gnu.org
>>> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
>> - Carsten
>

- Carsten

^ permalink raw reply	[relevance 0%]

* Re: Bug: Incorrect escaping of braces on LaTeX export [6.33trans (release_6.33f.122.g7062a.dirty)]
  2009-12-17 19:27  0% ` Carsten Dominik
@ 2009-12-17 23:16  0%   ` Mark Elston
  2009-12-18  8:08  0%     ` Carsten Dominik
  0 siblings, 1 reply; 59+ results
From: Mark Elston @ 2009-12-17 23:16 UTC (permalink / raw)
  To: Carsten Dominik; +Cc: emacs-orgmode

Carsten,

Notice the title line in the generated latex code.  It looks like:

     \title{ABC Class Notes\}
                           ^^

The closing brace is escaped.

Mark

Carsten Dominik wrote:
> Hi Mark,
> 
> what is the error you are getting?
> 
> - Carsten
> 
> On Dec 17, 2009, at 1:05 AM, Mark Elston wrote:
> 
>>
>> Remember to cover the basics, that is, what you expected to happen and
>> what in fact did happen.  You don't know how to make a good report?  See
>>
>>     http://orgmode.org/manual/Feedback.html#Feedback
>>
>> Your bug report will be posted to the Org-mode mailing list.
>> ------------------------------------------------------------------------
>>
>> While attempting to generate some notes for a class I give I ran into
>> an error in the generated latex file.  I use memoir for my notes since
>> this package gives me the particular formatting I like without any
>> hassle so I created an org-export-latex-class to make use of it.
>> Since my boilerplate for my notes includes a number of lines after the
>> \begin{document} line I have added these to #+TEXT entries in the org
>> file.
>>
>> I use the memoir titlingpage facility as it gives me the control and
>> look I want without a lot of code.  However, this causes a problem
>> with org export since the \maketitle line must be inside a titlingpage
>> environment. To accomplish this I have set the #+TITLE: directive to
>> an empty value and put the entire titlingpage environment (3 lines) in
>> #+TEXT lines.
>>
>> I have included a simple ErrorSample latex class in my configuration
>> which demonstrates the problem without as much being generated.
>>
>> A sample org file looks like this:
>>
>> -----------------------------------------------------------------------
>> #+TITLE:
>> #+OPTIONS: toc:nil
>> #+LaTeX_CLASS: ErrorSample
>> #+TEXT: \title{ABC Class Notes}
>> #+TEXT: \begin{titlingpage}
>> #+TEXT: \maketitle
>> #+TEXT: \end{titlingpage}
>> #+TEXT: \maxtocdepth{subsection}
>> #+TEXT: \pagenumbering{roman}
>> #+TEXT: \cleartooddpage
>> #+TEXT: \tableofcontents
>> #+TEXT: \cleartooddpage
>> #+TEXT: \chapterstyle{companion}
>> #+TEXT: \pagestyle{companion}
>> #+TEXT: \aliaspagestyle{part}{companion}
>> #+TEXT: \aliaspagestyle{chapter}{headings}
>> #+TEXT: \aliaspagestyle{cleared}{companion}
>> #+TEXT: \include{Preface}
>> #+TEXT: \pagenumbering{arabic}
>>
>> * Simple First Heading
>>  Some text.
>>
>> * Simple Second Heading
>>  Other text.
>> -----------------------------------------------------------------------
>>
>> The generated tex file is shown next.  Notice the escaped closing
>> brace on the \title{} instruction:
>>
>> -----------------------------------------------------------------------
>> % Created 2009-12-16 Wed 15:54
>> \documentclass[letter,twoside,openright]{memoir}
>> \usepackage{varioref}
>> \usepackage{shorttoc}
>> \usepackage{color}
>> \usepackage{graphicx}
>> \usepackage{bbding}
>>
>> \setlength{\parindent}{0pt}
>> \setlength{\parskip}{1ex}
>>
>>
>> \title{}
>> \author{Mark Elston}
>> \date{16 December 2009}
>>
>> \begin{document}
>>
>>
>>
>> \title{ABC Class Notes\}
>> \begin{titlingpage}
>> \maketitle
>> \end{titlingpage}
>> \maxtocdepth{subsection}
>> \pagenumbering{roman}
>> \cleartooddpage
>> \tableofcontents
>> \cleartooddpage
>> \chapterstyle{companion}
>> \pagestyle{companion}
>> \aliaspagestyle{part}{companion}
>> \aliaspagestyle{chapter}{headings}
>> \aliaspagestyle{cleared}{companion}
>> \include{Preface}
>> \pagenumbering{arabic}
>>
>>
>> \chapter{Simple First Heading}
>> \label{sec-1}
>>
>>  Some text.
>> \chapter{Simple Second Heading}
>> \label{sec-2}
>>
>>  Other text.
>>
>> \end{document}
>>
>> -----------------------------------------------------------------------
>>
>> Emacs  : GNU Emacs 23.1.1 (i386-mingw-nt6.0.6002)
>> of 2009-07-29 on SOFT-MJASON
>> Package: Org-mode version 6.33trans (release_6.33f.122.g7062a.dirty)
>>
>> current state:
>> ==============
>> (setq
>> org-log-done 'time
>> org-export-latex-after-initial-vars-hook '(org-beamer-after-initial-vars)
>> org-agenda-custom-commands '(("S" "Schedule for the week" ((agenda "") 
>> (todo "TODO"))))
>> org-agenda-files '("~/org")
>> org-agenda-include-diary t
>> org-blocker-hook '(org-block-todo-from-children-or-siblings-or-parent
>>                    org-block-todo-from-checkboxes)
>> org-list-demote-modify-bullet '(("-" . "+") ("+" . "-"))
>> org-fontify-whole-heading-line t
>> org-metaup-hook '(org-babel-load-in-session-maybe)
>> org-agenda-skip-timestamp-if-done t
>> org-after-todo-state-change-hook '(org-clock-out-if-current)
>> org-babel-interpreters '("R" "asymptote" "dot" "ditaa" "python" "sh" 
>> "emacs-lisp")
>> org-export-latex-format-toc-function 'org-export-latex-format-toc-default
>> org-protocol-protocol-alist '(("Fireforg get bibtex entry: 
>> fireforg-bibtex-entry://<bibtex entry (encoded)>" :protocol 
>> "fireforg-bibtex-entry" :function org-fireforg-receive-bibtex-entry)
>>                               ("Fireforg show annotation: 
>> fireforg-show-annotation://<file (encoded)>/<header (encoded)>" 
>> :protocol "fireforg-show-annotation" :function 
>> org-fireforg-show-annotation)
>>                               )
>> org-agenda-skip-scheduled-if-done t
>> org-export-preprocess-hook '(org-export-blocks-preprocess)
>> org-tab-first-hook '(yas/org-very-safe-expand 
>> org-babel-hide-result-toggle-maybe
>>                      org-hide-block-toggle-maybe)
>> org-src-mode-hook '(org-src-mode-configure-edit-buffer)
>> org-confirm-shell-link-function 'yes-or-no-p
>> org-export-first-hook '(org-beamer-initialize-open-trackers)
>> org-agenda-before-write-hook '(org-agenda-add-entry-text)
>> org-directory "~/org/"
>> org-cycle-hook '(org-cycle-hide-archived-subtrees org-cycle-hide-drawers
>>                  org-cycle-show-empty-lines 
>> org-optimize-window-after-visibility-change)
>> org-export-latex-classes '(("article"
>> "\\documentclass[11pt]{article}\n\\usepackage[utf8]{inputenc}\n\\usepackage[T1]{fontenc}\n\\usepackage{graphicx}\n\\usepackage{longtable}\n\\usepackage{float}\n\\usepackage{wrapfig}\n\\usepackage{soul}\n\\usepackage{amssymb}\n\\usepackage{hyperref}" 
>>
>>                             ("\\section{%s}" . "\\section*{%s}")
>>                             ("\\subsection{%s}" . "\\subsection*{%s}")
>>                             ("\\subsubsection{%s}" . 
>> "\\subsubsection*{%s}")
>>                             ("\\paragraph{%s}" . "\\paragraph*{%s}")
>>                             ("\\subparagraph{%s}" . 
>> "\\subparagraph*{%s}"))
>>                            ("report"
>> "\\documentclass[11pt]{report}\n\\usepackage[utf8]{inputenc}\n\\usepackage[T1]{fontenc}\n\\usepackage{graphicx}\n\\usepackage{longtable}\n\\usepackage{float}\n\\usepackage{wrapfig}\n\\usepackage{soul}\n\\usepackage{amssymb}\n\\usepackage{hyperref}" 
>>
>>                             ("\\part{%s}" . "\\part*{%s}")
>>                             ("\\chapter{%s}" . "\\chapter*{%s}")
>>                             ("\\section{%s}" . "\\section*{%s}")
>>                             ("\\subsection{%s}" . "\\subsection*{%s}")
>>                             ("\\subsubsection{%s}" . 
>> "\\subsubsection*{%s}"))
>>                            ("book"
>> "\\documentclass[11pt]{book}\n\\usepackage[utf8]{inputenc}\n\\usepackage[T1]{fontenc}\n\\usepackage{graphicx}\n\\usepackage{longtable}\n\\usepackage{float}\n\\usepackage{wrapfig}\n\\usepackage{soul}\n\\usepackage{amssymb}\n\\usepackage{hyperref}" 
>>
>>                             ("\\part{%s}" . "\\part*{%s}")
>>                             ("\\chapter{%s}" . "\\chapter*{%s}")
>>                             ("\\section{%s}" . "\\section*{%s}")
>>                             ("\\subsection{%s}" . "\\subsection*{%s}")
>>                             ("\\subsubsection{%s}" . 
>> "\\subsubsection*{%s}"))
>>                            ("ClassNotes"
>> "\\documentclass[letter,twoside,openright]{memoir}\n\\usepackage{varioref}\n\\usepackage{shorttoc}\n\\usepackage{color}\n\\usepackage{graphicx}\n\\usepackage{biblestudy}\n\\usepackage[polutonikogreek,english]{babel}\n\\usepackage{cjhebrew}\n\\usepackage{bbding}\n\n\\newcommand\\checkmark{\\Checkmark}\n\\newcommand\\xmark{\\XSolidBold}\n\n\\newcommand\\gr[1]{\\begingroup%\n  
>> \\selectlanguage{greek}#1%\n 
>> \\endgroup}\n\n\\newcommand\\heb[1]{\\begingroup%\n  \\cjRL{#1}%\n 
>> \\endgroup}\n\n\\setlength{\\parindent}{0pt}\n\\setlength{\\parskip}{1ex}" 
>>
>>                             ("\\chapter{%s}" . "\\chapter*{%s}")
>>                             ("\\section{%s}" . "\\section*{%s}")
>>                             ("\\subsection{%s}" . "\\subsection*{%s}")
>>                             ("\\subsubsection{%s}" . 
>> "\\subsubsection*{%s}"))
>>                            ("ErrorSample"
>> "\\documentclass[letter,twoside,openright]{memoir}\n\\usepackage{varioref}\n\\usepackage{shorttoc}\n\\usepackage{color}\n\\usepackage{graphicx}\n\\usepackage{bbding}\n\n\\setlength{\\parindent}{0pt}\n\\setlength{\\parskip}{1ex}" 
>>
>>                             ("\\chapter{%s}" . "\\chapter*{%s}")
>>                             ("\\section{%s}" . "\\section*{%s}")
>>                             ("\\subsection{%s}" . "\\subsection*{%s}")
>>                             ("\\subsubsection{%s}" . 
>> "\\subsubsection*{%s}"))
>>                            )
>> org-use-speed-commands t
>> org-mode-hook '((lambda nil
>>                  (setq org-mouse-context-menu-function (quote 
>> org-mouse-context-menu))
>>                  (when (memq (quote context-menu) org-mouse-features)
>>                   (define-key org-mouse-map
>>                    (if (featurep (quote xemacs)) [button3] [mouse-3]) 
>> nil)
>>                   (define-key org-mode-map [mouse-3]
>>                    (quote org-mouse-show-context-menu))
>>                   )
>>                  (define-key org-mode-map [down-mouse-1] (quote 
>> org-mouse-down-mouse))
>>                  (when (memq (quote context-menu) org-mouse-features)
>>                   (define-key org-mouse-map [C-drag-mouse-1]
>>                    (quote org-mouse-move-tree))
>>                   (define-key org-mouse-map [C-down-mouse-1]
>>                    (quote org-mouse-move-tree-start))
>>                   )
>>                  (when (memq (quote yank-link) org-mouse-features)
>>                   (define-key org-mode-map [S-mouse-2] (quote 
>> org-mouse-yank-link))
>>                   (define-key org-mode-map [drag-mouse-3] (quote 
>> org-mouse-yank-link)))
>>                  (when (memq (quote move-tree) org-mouse-features)
>>                   (define-key org-mouse-map [drag-mouse-3] (quote 
>> org-mouse-move-tree))
>>                   (define-key org-mouse-map [down-mouse-3]
>>                    (quote org-mouse-move-tree-start))
>>                   )
>>                  (when (memq (quote activate-stars) org-mouse-features)
>>                   (font-lock-add-keywords nil
>>                    (\`
>>                     (((\, outline-regexp) 0
>>                       (\`
>>                        (face org-link mouse-face highlight keymap (\, 
>> org-mouse-map)))
>>                       (quote prepend))
>>                      )
>>                     )
>>                    t)
>>                   )
>>                  (when (memq (quote activate-bullets) org-mouse-features)
>>                   (font-lock-add-keywords nil
>>                    (\`
>>                     (("^[     ]*\\([-+*]\\|[0-9]+[.)]\\) +"
>>                       (1
>>                        (\`
>>                         (face org-link keymap (\, org-mouse-map) 
>> mouse-face highlight))
>>                        (quote prepend))
>>                       )
>>                      )
>>                     )
>>                    t)
>>                   )
>>                  (when (memq (quote activate-checkboxes) 
>> org-mouse-features)
>>                   (font-lock-add-keywords nil
>>                    (\`
>>                     (("^[     ]*\\([-+*]\\|[0-9]+[.)]\\) +\\(\\[[ 
>> X]\\]\\)"
>>                       (2
>>                        (\` (face bold keymap (\, org-mouse-map) 
>> mouse-face highlight))
>>                        t)
>>                       )
>>                      )
>>                     )
>>                    t)
>>                   )
>>                  (defadvice org-open-at-point (around 
>> org-mouse-open-at-point activate)
>>                   (let ((context (org-context)))
>>                    (cond ((assq :headline-stars context) (org-cycle))
>>                     ((assq :checkbox context) (org-toggle-checkbox))
>>                     ((assq :item-bullet context)
>>                      (let ((org-cycle-include-plain-lists t)) 
>> (org-cycle)))
>>                     (t ad-do-it))
>>                    )
>>                   )
>>                  )
>>                 #[nil "\302\300!\210\303\x10\304\305\306\"\210\307 
>> \310\311#\207"
>>                   [yas/trigger-key yas/keymap 
>> make-variable-buffer-local [tab]
>>                    add-to-list org-tab-first-hook 
>> yas/org-very-safe-expand define-key
>>                    [tab] yas/next-field]
>>                   4]
>>                 (lambda nil
>>                  (org-add-hook (quote change-major-mode-hook)
>>                   (quote org-babel-show-result-all) (quote append) 
>> (quote local))
>>                  )
>>                 org-babel-result-hide-spec org-babel-hide-all-hashes
>>                 (lambda nil
>>                  (add-hook (quote after-save-hook) (quote 
>> org-fireforg-registry-update)
>>                   t t)
>>                  )
>>                 #[nil "\300\301\302\303\304$\207"
>>                   [org-add-hook change-major-mode-hook 
>> org-show-block-all append local]
>>                   5]
>>                 )
>> org-ctrl-c-ctrl-c-hook '(org-babel-lob-execute-maybe 
>> org-babel-hash-at-point
>>                          org-babel-execute-src-block-maybe)
>> org-confirm-elisp-link-function 'yes-or-no-p
>> org-agenda-mode-hook '((lambda nil
>>                         (setq org-mouse-context-menu-function
>>                          (quote org-mouse-agenda-context-menu))
>>                         (define-key org-agenda-mode-map
>>                          (if (featurep (quote xemacs)) [button3] 
>> [mouse-3])
>>                          (quote org-mouse-show-context-menu))
>>                         (define-key org-agenda-mode-map [down-mouse-3]
>>                          (quote org-mouse-move-tree-start))
>>                         (define-key org-agenda-mode-map
>>                          (if (featurep (quote xemacs)) [(control 
>> mouse-4)] [C-mouse-4])
>>                          (quote org-agenda-earlier))
>>                         (define-key org-agenda-mode-map
>>                          (if (featurep (quote xemacs)) [(control 
>> mouse-5)] [C-mouse-5])
>>                          (quote org-agenda-later))
>>                         (define-key org-agenda-mode-map [drag-mouse-3]
>>                          (quote
>>                           (lambda (event) (interactive "e")
>>                            (case (org-mouse-get-gesture event)
>>                             (:left (org-agenda-earlier 1))
>>                             (:right (org-agenda-later 1)))
>>                            )
>>                           )
>>                          )
>>                         )
>>                        )
>> org-agenda-start-on-weekday nil
>> org-export-interblocks '((lob org-babel-exp-lob-one-liners)
>>                          (src org-babel-exp-inline-src-blocks))
>> org-agenda-skip-deadline-if-done t
>> org-enforce-todo-dependencies t
>> org-occur-hook '(org-first-headline-recenter)
>> org-from-is-user-regexp nil
>> org-export-preprocess-before-selecting-backend-code-hook 
>> '(org-beamer-select-beamer-code)
>> org-remember-templates '(("Todo" 116 "* TODO %?\n  %i\n  %a\n" 
>> "~/org/TODO.org" "Tasks")
>>                          ("Journal" 106 "* %U %?\n\n  %i\n  %a\n" 
>> "~/org/JOURNAL.org")
>>                          ("Idea" 105 "* %^{Title}\n  %i\n  %a\n" 
>> "~/org/JOURNAL.org"
>>                           "New Ideas")
>>                          ("Project" 112 "* %^{Title}\n  %i\n  %a\n"
>>                           "~/org/ProjectNotes.org" "Project Notes")
>>                          ("Browser" 119 "* %^{Title}\n  %u\n\n Source: 
>> %c\n\n  %i"
>>                           "~/org/Notes.org" "Notes")
>>                          )
>> org-export-latex-final-hook '(org-beamer-amend-header org-beamer-fix-toc
>>                               org-beamer-auto-fragile-frames
>>                               org-beamer-place-default-actions-for-lists)
>> org-enforce-todo-checkbox-dependencies t
>> org-metadown-hook '(org-babel-pop-to-session-maybe)
>> org-export-blocks '((src org-babel-exp-src-blocks nil)
>>                     (comment org-export-blocks-format-comment t)
>>                     (ditaa org-export-blocks-format-ditaa nil)
>>                     (dot org-export-blocks-format-dot nil))
>> )
>>
>>
>>
>> _______________________________________________
>> Emacs-orgmode mailing list
>> Please use `Reply All' to send replies to the list.
>> Emacs-orgmode@gnu.org
>> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
> 
> - Carsten
> 
> 
> 
> 

^ permalink raw reply	[relevance 0%]

* Re: Bug: Incorrect escaping of braces on LaTeX export [6.33trans (release_6.33f.122.g7062a.dirty)]
  2009-12-17  0:05  6% Bug: Incorrect escaping of braces on LaTeX export [6.33trans (release_6.33f.122.g7062a.dirty)] Mark Elston
@ 2009-12-17 19:27  0% ` Carsten Dominik
  2009-12-17 23:16  0%   ` Mark Elston
  0 siblings, 1 reply; 59+ results
From: Carsten Dominik @ 2009-12-17 19:27 UTC (permalink / raw)
  To: Mark Elston; +Cc: emacs-orgmode

Hi Mark,

what is the error you are getting?

- Carsten

On Dec 17, 2009, at 1:05 AM, Mark Elston wrote:

>
> Remember to cover the basics, that is, what you expected to happen and
> what in fact did happen.  You don't know how to make a good report?   
> See
>
>     http://orgmode.org/manual/Feedback.html#Feedback
>
> Your bug report will be posted to the Org-mode mailing list.
> ------------------------------------------------------------------------
>
> While attempting to generate some notes for a class I give I ran into
> an error in the generated latex file.  I use memoir for my notes since
> this package gives me the particular formatting I like without any
> hassle so I created an org-export-latex-class to make use of it.
> Since my boilerplate for my notes includes a number of lines after the
> \begin{document} line I have added these to #+TEXT entries in the org
> file.
>
> I use the memoir titlingpage facility as it gives me the control and
> look I want without a lot of code.  However, this causes a problem
> with org export since the \maketitle line must be inside a titlingpage
> environment. To accomplish this I have set the #+TITLE: directive to
> an empty value and put the entire titlingpage environment (3 lines) in
> #+TEXT lines.
>
> I have included a simple ErrorSample latex class in my configuration
> which demonstrates the problem without as much being generated.
>
> A sample org file looks like this:
>
> -----------------------------------------------------------------------
> #+TITLE:
> #+OPTIONS: toc:nil
> #+LaTeX_CLASS: ErrorSample
> #+TEXT: \title{ABC Class Notes}
> #+TEXT: \begin{titlingpage}
> #+TEXT: \maketitle
> #+TEXT: \end{titlingpage}
> #+TEXT: \maxtocdepth{subsection}
> #+TEXT: \pagenumbering{roman}
> #+TEXT: \cleartooddpage
> #+TEXT: \tableofcontents
> #+TEXT: \cleartooddpage
> #+TEXT: \chapterstyle{companion}
> #+TEXT: \pagestyle{companion}
> #+TEXT: \aliaspagestyle{part}{companion}
> #+TEXT: \aliaspagestyle{chapter}{headings}
> #+TEXT: \aliaspagestyle{cleared}{companion}
> #+TEXT: \include{Preface}
> #+TEXT: \pagenumbering{arabic}
>
> * Simple First Heading
>  Some text.
>
> * Simple Second Heading
>  Other text.
> -----------------------------------------------------------------------
>
> The generated tex file is shown next.  Notice the escaped closing
> brace on the \title{} instruction:
>
> -----------------------------------------------------------------------
> % Created 2009-12-16 Wed 15:54
> \documentclass[letter,twoside,openright]{memoir}
> \usepackage{varioref}
> \usepackage{shorttoc}
> \usepackage{color}
> \usepackage{graphicx}
> \usepackage{bbding}
>
> \setlength{\parindent}{0pt}
> \setlength{\parskip}{1ex}
>
>
> \title{}
> \author{Mark Elston}
> \date{16 December 2009}
>
> \begin{document}
>
>
>
> \title{ABC Class Notes\}
> \begin{titlingpage}
> \maketitle
> \end{titlingpage}
> \maxtocdepth{subsection}
> \pagenumbering{roman}
> \cleartooddpage
> \tableofcontents
> \cleartooddpage
> \chapterstyle{companion}
> \pagestyle{companion}
> \aliaspagestyle{part}{companion}
> \aliaspagestyle{chapter}{headings}
> \aliaspagestyle{cleared}{companion}
> \include{Preface}
> \pagenumbering{arabic}
>
>
> \chapter{Simple First Heading}
> \label{sec-1}
>
>  Some text.
> \chapter{Simple Second Heading}
> \label{sec-2}
>
>  Other text.
>
> \end{document}
>
> -----------------------------------------------------------------------
>
> Emacs  : GNU Emacs 23.1.1 (i386-mingw-nt6.0.6002)
> of 2009-07-29 on SOFT-MJASON
> Package: Org-mode version 6.33trans (release_6.33f.122.g7062a.dirty)
>
> current state:
> ==============
> (setq
> org-log-done 'time
> org-export-latex-after-initial-vars-hook '(org-beamer-after-initial- 
> vars)
> org-agenda-custom-commands '(("S" "Schedule for the week" ((agenda  
> "") (todo "TODO"))))
> org-agenda-files '("~/org")
> org-agenda-include-diary t
> org-blocker-hook '(org-block-todo-from-children-or-siblings-or-parent
>                    org-block-todo-from-checkboxes)
> org-list-demote-modify-bullet '(("-" . "+") ("+" . "-"))
> org-fontify-whole-heading-line t
> org-metaup-hook '(org-babel-load-in-session-maybe)
> org-agenda-skip-timestamp-if-done t
> org-after-todo-state-change-hook '(org-clock-out-if-current)
> org-babel-interpreters '("R" "asymptote" "dot" "ditaa" "python" "sh"  
> "emacs-lisp")
> org-export-latex-format-toc-function 'org-export-latex-format-toc- 
> default
> org-protocol-protocol-alist '(("Fireforg get bibtex entry: fireforg- 
> bibtex-entry://<bibtex entry (encoded)>" :protocol "fireforg-bibtex- 
> entry" :function org-fireforg-receive-bibtex-entry)
>                               ("Fireforg show annotation: fireforg- 
> show-annotation://<file (encoded)>/<header (encoded)>" :protocol  
> "fireforg-show-annotation" :function org-fireforg-show-annotation)
>                               )
> org-agenda-skip-scheduled-if-done t
> org-export-preprocess-hook '(org-export-blocks-preprocess)
> org-tab-first-hook '(yas/org-very-safe-expand org-babel-hide-result- 
> toggle-maybe
>                      org-hide-block-toggle-maybe)
> org-src-mode-hook '(org-src-mode-configure-edit-buffer)
> org-confirm-shell-link-function 'yes-or-no-p
> org-export-first-hook '(org-beamer-initialize-open-trackers)
> org-agenda-before-write-hook '(org-agenda-add-entry-text)
> org-directory "~/org/"
> org-cycle-hook '(org-cycle-hide-archived-subtrees org-cycle-hide- 
> drawers
>                  org-cycle-show-empty-lines org-optimize-window- 
> after-visibility-change)
> org-export-latex-classes '(("article"
> "\\documentclass[11pt]{article}\n\\usepackage[utf8]{inputenc}\n\ 
> \usepackage[T1]{fontenc}\n\\usepackage{graphicx}\n\ 
> \usepackage{longtable}\n\\usepackage{float}\n\\usepackage{wrapfig}\n\ 
> \usepackage{soul}\n\\usepackage{amssymb}\n\\usepackage{hyperref}"
>                             ("\\section{%s}" . "\\section*{%s}")
>                             ("\\subsection{%s}" . "\\subsection*{%s}")
>                             ("\\subsubsection{%s}" . "\ 
> \subsubsection*{%s}")
>                             ("\\paragraph{%s}" . "\\paragraph*{%s}")
>                             ("\\subparagraph{%s}" . "\ 
> \subparagraph*{%s}"))
>                            ("report"
> "\\documentclass[11pt]{report}\n\\usepackage[utf8]{inputenc}\n\ 
> \usepackage[T1]{fontenc}\n\\usepackage{graphicx}\n\ 
> \usepackage{longtable}\n\\usepackage{float}\n\\usepackage{wrapfig}\n\ 
> \usepackage{soul}\n\\usepackage{amssymb}\n\\usepackage{hyperref}"
>                             ("\\part{%s}" . "\\part*{%s}")
>                             ("\\chapter{%s}" . "\\chapter*{%s}")
>                             ("\\section{%s}" . "\\section*{%s}")
>                             ("\\subsection{%s}" . "\\subsection*{%s}")
>                             ("\\subsubsection{%s}" . "\ 
> \subsubsection*{%s}"))
>                            ("book"
> "\\documentclass[11pt]{book}\n\\usepackage[utf8]{inputenc}\n\ 
> \usepackage[T1]{fontenc}\n\\usepackage{graphicx}\n\ 
> \usepackage{longtable}\n\\usepackage{float}\n\\usepackage{wrapfig}\n\ 
> \usepackage{soul}\n\\usepackage{amssymb}\n\\usepackage{hyperref}"
>                             ("\\part{%s}" . "\\part*{%s}")
>                             ("\\chapter{%s}" . "\\chapter*{%s}")
>                             ("\\section{%s}" . "\\section*{%s}")
>                             ("\\subsection{%s}" . "\\subsection*{%s}")
>                             ("\\subsubsection{%s}" . "\ 
> \subsubsection*{%s}"))
>                            ("ClassNotes"
> "\\documentclass[letter,twoside,openright]{memoir}\n\ 
> \usepackage{varioref}\n\\usepackage{shorttoc}\n\\usepackage{color}\n\ 
> \usepackage{graphicx}\n\\usepackage{biblestudy}\n\ 
> \usepackage[polutonikogreek,english]{babel}\n\\usepackage{cjhebrew}\n 
> \\usepackage{bbding}\n\n\\newcommand\\checkmark{\\Checkmark}\n\ 
> \newcommand\\xmark{\\XSolidBold}\n\n\\newcommand\\gr[1]{\\begingroup% 
> \n  \\selectlanguage{greek}#1%\n \\endgroup}\n\n\\newcommand\\heb[1] 
> {\\begingroup%\n  \\cjRL{#1}%\n \\endgroup}\n\n\\setlength{\ 
> \parindent}{0pt}\n\\setlength{\\parskip}{1ex}"
>                             ("\\chapter{%s}" . "\\chapter*{%s}")
>                             ("\\section{%s}" . "\\section*{%s}")
>                             ("\\subsection{%s}" . "\\subsection*{%s}")
>                             ("\\subsubsection{%s}" . "\ 
> \subsubsection*{%s}"))
>                            ("ErrorSample"
> "\\documentclass[letter,twoside,openright]{memoir}\n\ 
> \usepackage{varioref}\n\\usepackage{shorttoc}\n\\usepackage{color}\n\ 
> \usepackage{graphicx}\n\\usepackage{bbding}\n\n\\setlength{\ 
> \parindent}{0pt}\n\\setlength{\\parskip}{1ex}"
>                             ("\\chapter{%s}" . "\\chapter*{%s}")
>                             ("\\section{%s}" . "\\section*{%s}")
>                             ("\\subsection{%s}" . "\\subsection*{%s}")
>                             ("\\subsubsection{%s}" . "\ 
> \subsubsection*{%s}"))
>                            )
> org-use-speed-commands t
> org-mode-hook '((lambda nil
>                  (setq org-mouse-context-menu-function (quote org- 
> mouse-context-menu))
>                  (when (memq (quote context-menu) org-mouse-features)
>                   (define-key org-mouse-map
>                    (if (featurep (quote xemacs)) [button3]  
> [mouse-3]) nil)
>                   (define-key org-mode-map [mouse-3]
>                    (quote org-mouse-show-context-menu))
>                   )
>                  (define-key org-mode-map [down-mouse-1] (quote org- 
> mouse-down-mouse))
>                  (when (memq (quote context-menu) org-mouse-features)
>                   (define-key org-mouse-map [C-drag-mouse-1]
>                    (quote org-mouse-move-tree))
>                   (define-key org-mouse-map [C-down-mouse-1]
>                    (quote org-mouse-move-tree-start))
>                   )
>                  (when (memq (quote yank-link) org-mouse-features)
>                   (define-key org-mode-map [S-mouse-2] (quote org- 
> mouse-yank-link))
>                   (define-key org-mode-map [drag-mouse-3] (quote org- 
> mouse-yank-link)))
>                  (when (memq (quote move-tree) org-mouse-features)
>                   (define-key org-mouse-map [drag-mouse-3] (quote  
> org-mouse-move-tree))
>                   (define-key org-mouse-map [down-mouse-3]
>                    (quote org-mouse-move-tree-start))
>                   )
>                  (when (memq (quote activate-stars) org-mouse- 
> features)
>                   (font-lock-add-keywords nil
>                    (\`
>                     (((\, outline-regexp) 0
>                       (\`
>                        (face org-link mouse-face highlight keymap  
> (\, org-mouse-map)))
>                       (quote prepend))
>                      )
>                     )
>                    t)
>                   )
>                  (when (memq (quote activate-bullets) org-mouse- 
> features)
>                   (font-lock-add-keywords nil
>                    (\`
>                     (("^[ 	]*\\([-+*]\\|[0-9]+[.)]\\) +"
>                       (1
>                        (\`
>                         (face org-link keymap (\, org-mouse-map)  
> mouse-face highlight))
>                        (quote prepend))
>                       )
>                      )
>                     )
>                    t)
>                   )
>                  (when (memq (quote activate-checkboxes) org-mouse- 
> features)
>                   (font-lock-add-keywords nil
>                    (\`
>                     (("^[ 	]*\\([-+*]\\|[0-9]+[.)]\\) +\\(\\[[ X]\\]\ 
> \)"
>                       (2
>                        (\` (face bold keymap (\, org-mouse-map)  
> mouse-face highlight))
>                        t)
>                       )
>                      )
>                     )
>                    t)
>                   )
>                  (defadvice org-open-at-point (around org-mouse-open- 
> at-point activate)
>                   (let ((context (org-context)))
>                    (cond ((assq :headline-stars context) (org-cycle))
>                     ((assq :checkbox context) (org-toggle-checkbox))
>                     ((assq :item-bullet context)
>                      (let ((org-cycle-include-plain-lists t)) (org- 
> cycle)))
>                     (t ad-do-it))
>                    )
>                   )
>                  )
>                 #[nil "\302\300!\210\303\x10\304\305\306\"\210\307  
> \310\311#\207"
>                   [yas/trigger-key yas/keymap make-variable-buffer- 
> local [tab]
>                    add-to-list org-tab-first-hook yas/org-very-safe- 
> expand define-key
>                    [tab] yas/next-field]
>                   4]
>                 (lambda nil
>                  (org-add-hook (quote change-major-mode-hook)
>                   (quote org-babel-show-result-all) (quote append)  
> (quote local))
>                  )
>                 org-babel-result-hide-spec org-babel-hide-all-hashes
>                 (lambda nil
>                  (add-hook (quote after-save-hook) (quote org- 
> fireforg-registry-update)
>                   t t)
>                  )
>                 #[nil "\300\301\302\303\304$\207"
>                   [org-add-hook change-major-mode-hook org-show- 
> block-all append local]
>                   5]
>                 )
> org-ctrl-c-ctrl-c-hook '(org-babel-lob-execute-maybe org-babel-hash- 
> at-point
>                          org-babel-execute-src-block-maybe)
> org-confirm-elisp-link-function 'yes-or-no-p
> org-agenda-mode-hook '((lambda nil
>                         (setq org-mouse-context-menu-function
>                          (quote org-mouse-agenda-context-menu))
>                         (define-key org-agenda-mode-map
>                          (if (featurep (quote xemacs)) [button3]  
> [mouse-3])
>                          (quote org-mouse-show-context-menu))
>                         (define-key org-agenda-mode-map [down-mouse-3]
>                          (quote org-mouse-move-tree-start))
>                         (define-key org-agenda-mode-map
>                          (if (featurep (quote xemacs)) [(control  
> mouse-4)] [C-mouse-4])
>                          (quote org-agenda-earlier))
>                         (define-key org-agenda-mode-map
>                          (if (featurep (quote xemacs)) [(control  
> mouse-5)] [C-mouse-5])
>                          (quote org-agenda-later))
>                         (define-key org-agenda-mode-map [drag-mouse-3]
>                          (quote
>                           (lambda (event) (interactive "e")
>                            (case (org-mouse-get-gesture event)
>                             (:left (org-agenda-earlier 1))
>                             (:right (org-agenda-later 1)))
>                            )
>                           )
>                          )
>                         )
>                        )
> org-agenda-start-on-weekday nil
> org-export-interblocks '((lob org-babel-exp-lob-one-liners)
>                          (src org-babel-exp-inline-src-blocks))
> org-agenda-skip-deadline-if-done t
> org-enforce-todo-dependencies t
> org-occur-hook '(org-first-headline-recenter)
> org-from-is-user-regexp nil
> org-export-preprocess-before-selecting-backend-code-hook '(org- 
> beamer-select-beamer-code)
> org-remember-templates '(("Todo" 116 "* TODO %?\n  %i\n  %a\n" "~/ 
> org/TODO.org" "Tasks")
>                          ("Journal" 106 "* %U %?\n\n  %i\n  %a\n" "~/ 
> org/JOURNAL.org")
>                          ("Idea" 105 "* %^{Title}\n  %i\n  %a\n" "~/ 
> org/JOURNAL.org"
>                           "New Ideas")
>                          ("Project" 112 "* %^{Title}\n  %i\n  %a\n"
>                           "~/org/ProjectNotes.org" "Project Notes")
>                          ("Browser" 119 "* %^{Title}\n  %u\n\n  
> Source: %c\n\n  %i"
>                           "~/org/Notes.org" "Notes")
>                          )
> org-export-latex-final-hook '(org-beamer-amend-header org-beamer-fix- 
> toc
>                               org-beamer-auto-fragile-frames
>                               org-beamer-place-default-actions-for- 
> lists)
> org-enforce-todo-checkbox-dependencies t
> org-metadown-hook '(org-babel-pop-to-session-maybe)
> org-export-blocks '((src org-babel-exp-src-blocks nil)
>                     (comment org-export-blocks-format-comment t)
>                     (ditaa org-export-blocks-format-ditaa nil)
>                     (dot org-export-blocks-format-dot nil))
> )
>
>
>
> _______________________________________________
> Emacs-orgmode mailing list
> Please use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode

- Carsten

^ permalink raw reply	[relevance 0%]

* Bug: Incorrect escaping of braces on LaTeX export [6.33trans (release_6.33f.122.g7062a.dirty)]
@ 2009-12-17  0:05  6% Mark Elston
  2009-12-17 19:27  0% ` Carsten Dominik
  0 siblings, 1 reply; 59+ results
From: Mark Elston @ 2009-12-17  0:05 UTC (permalink / raw)
  To: emacs-orgmode


Remember to cover the basics, that is, what you expected to happen and
what in fact did happen.  You don't know how to make a good report?  See

      http://orgmode.org/manual/Feedback.html#Feedback

Your bug report will be posted to the Org-mode mailing list.
------------------------------------------------------------------------

While attempting to generate some notes for a class I give I ran into
an error in the generated latex file.  I use memoir for my notes since
this package gives me the particular formatting I like without any
hassle so I created an org-export-latex-class to make use of it.
Since my boilerplate for my notes includes a number of lines after the
\begin{document} line I have added these to #+TEXT entries in the org
file.

I use the memoir titlingpage facility as it gives me the control and
look I want without a lot of code.  However, this causes a problem
with org export since the \maketitle line must be inside a titlingpage
environment. To accomplish this I have set the #+TITLE: directive to
an empty value and put the entire titlingpage environment (3 lines) in
#+TEXT lines.

I have included a simple ErrorSample latex class in my configuration
which demonstrates the problem without as much being generated.

A sample org file looks like this:

-----------------------------------------------------------------------
#+TITLE:
#+OPTIONS: toc:nil
#+LaTeX_CLASS: ErrorSample
#+TEXT: \title{ABC Class Notes}
#+TEXT: \begin{titlingpage}
#+TEXT: \maketitle
#+TEXT: \end{titlingpage}
#+TEXT: \maxtocdepth{subsection}
#+TEXT: \pagenumbering{roman}
#+TEXT: \cleartooddpage
#+TEXT: \tableofcontents
#+TEXT: \cleartooddpage
#+TEXT: \chapterstyle{companion}
#+TEXT: \pagestyle{companion}
#+TEXT: \aliaspagestyle{part}{companion}
#+TEXT: \aliaspagestyle{chapter}{headings}
#+TEXT: \aliaspagestyle{cleared}{companion}
#+TEXT: \include{Preface}
#+TEXT: \pagenumbering{arabic}

* Simple First Heading
   Some text.

* Simple Second Heading
   Other text.
-----------------------------------------------------------------------

The generated tex file is shown next.  Notice the escaped closing
brace on the \title{} instruction:

-----------------------------------------------------------------------
% Created 2009-12-16 Wed 15:54
\documentclass[letter,twoside,openright]{memoir}
\usepackage{varioref}
\usepackage{shorttoc}
\usepackage{color}
\usepackage{graphicx}
\usepackage{bbding}

\setlength{\parindent}{0pt}
\setlength{\parskip}{1ex}


\title{}
\author{Mark Elston}
\date{16 December 2009}

\begin{document}



\title{ABC Class Notes\}
\begin{titlingpage}
\maketitle
\end{titlingpage}
\maxtocdepth{subsection}
\pagenumbering{roman}
\cleartooddpage
\tableofcontents
\cleartooddpage
\chapterstyle{companion}
\pagestyle{companion}
\aliaspagestyle{part}{companion}
\aliaspagestyle{chapter}{headings}
\aliaspagestyle{cleared}{companion}
\include{Preface}
\pagenumbering{arabic}


\chapter{Simple First Heading}
\label{sec-1}

   Some text.
\chapter{Simple Second Heading}
\label{sec-2}

   Other text.

\end{document}

-----------------------------------------------------------------------

Emacs  : GNU Emacs 23.1.1 (i386-mingw-nt6.0.6002)
  of 2009-07-29 on SOFT-MJASON
Package: Org-mode version 6.33trans (release_6.33f.122.g7062a.dirty)

current state:
==============
(setq
  org-log-done 'time
  org-export-latex-after-initial-vars-hook '(org-beamer-after-initial-vars)
  org-agenda-custom-commands '(("S" "Schedule for the week" ((agenda "") 
(todo "TODO"))))
  org-agenda-files '("~/org")
  org-agenda-include-diary t
  org-blocker-hook '(org-block-todo-from-children-or-siblings-or-parent
                     org-block-todo-from-checkboxes)
  org-list-demote-modify-bullet '(("-" . "+") ("+" . "-"))
  org-fontify-whole-heading-line t
  org-metaup-hook '(org-babel-load-in-session-maybe)
  org-agenda-skip-timestamp-if-done t
  org-after-todo-state-change-hook '(org-clock-out-if-current)
  org-babel-interpreters '("R" "asymptote" "dot" "ditaa" "python" "sh" 
"emacs-lisp")
  org-export-latex-format-toc-function 'org-export-latex-format-toc-default
  org-protocol-protocol-alist '(("Fireforg get bibtex entry: 
fireforg-bibtex-entry://<bibtex entry (encoded)>" :protocol 
"fireforg-bibtex-entry" :function org-fireforg-receive-bibtex-entry)
                                ("Fireforg show annotation: 
fireforg-show-annotation://<file (encoded)>/<header (encoded)>" 
:protocol "fireforg-show-annotation" :function org-fireforg-show-annotation)
                                )
  org-agenda-skip-scheduled-if-done t
  org-export-preprocess-hook '(org-export-blocks-preprocess)
  org-tab-first-hook '(yas/org-very-safe-expand 
org-babel-hide-result-toggle-maybe
                       org-hide-block-toggle-maybe)
  org-src-mode-hook '(org-src-mode-configure-edit-buffer)
  org-confirm-shell-link-function 'yes-or-no-p
  org-export-first-hook '(org-beamer-initialize-open-trackers)
  org-agenda-before-write-hook '(org-agenda-add-entry-text)
  org-directory "~/org/"
  org-cycle-hook '(org-cycle-hide-archived-subtrees org-cycle-hide-drawers
                   org-cycle-show-empty-lines 
org-optimize-window-after-visibility-change)
  org-export-latex-classes '(("article"
 
"\\documentclass[11pt]{article}\n\\usepackage[utf8]{inputenc}\n\\usepackage[T1]{fontenc}\n\\usepackage{graphicx}\n\\usepackage{longtable}\n\\usepackage{float}\n\\usepackage{wrapfig}\n\\usepackage{soul}\n\\usepackage{amssymb}\n\\usepackage{hyperref}"
                              ("\\section{%s}" . "\\section*{%s}")
                              ("\\subsection{%s}" . "\\subsection*{%s}")
                              ("\\subsubsection{%s}" . 
"\\subsubsection*{%s}")
                              ("\\paragraph{%s}" . "\\paragraph*{%s}")
                              ("\\subparagraph{%s}" . 
"\\subparagraph*{%s}"))
                             ("report"
 
"\\documentclass[11pt]{report}\n\\usepackage[utf8]{inputenc}\n\\usepackage[T1]{fontenc}\n\\usepackage{graphicx}\n\\usepackage{longtable}\n\\usepackage{float}\n\\usepackage{wrapfig}\n\\usepackage{soul}\n\\usepackage{amssymb}\n\\usepackage{hyperref}"
                              ("\\part{%s}" . "\\part*{%s}")
                              ("\\chapter{%s}" . "\\chapter*{%s}")
                              ("\\section{%s}" . "\\section*{%s}")
                              ("\\subsection{%s}" . "\\subsection*{%s}")
                              ("\\subsubsection{%s}" . 
"\\subsubsection*{%s}"))
                             ("book"
 
"\\documentclass[11pt]{book}\n\\usepackage[utf8]{inputenc}\n\\usepackage[T1]{fontenc}\n\\usepackage{graphicx}\n\\usepackage{longtable}\n\\usepackage{float}\n\\usepackage{wrapfig}\n\\usepackage{soul}\n\\usepackage{amssymb}\n\\usepackage{hyperref}"
                              ("\\part{%s}" . "\\part*{%s}")
                              ("\\chapter{%s}" . "\\chapter*{%s}")
                              ("\\section{%s}" . "\\section*{%s}")
                              ("\\subsection{%s}" . "\\subsection*{%s}")
                              ("\\subsubsection{%s}" . 
"\\subsubsection*{%s}"))
                             ("ClassNotes"
 
"\\documentclass[letter,twoside,openright]{memoir}\n\\usepackage{varioref}\n\\usepackage{shorttoc}\n\\usepackage{color}\n\\usepackage{graphicx}\n\\usepackage{biblestudy}\n\\usepackage[polutonikogreek,english]{babel}\n\\usepackage{cjhebrew}\n\\usepackage{bbding}\n\n\\newcommand\\checkmark{\\Checkmark}\n\\newcommand\\xmark{\\XSolidBold}\n\n\\newcommand\\gr[1]{\\begingroup%\n 
  \\selectlanguage{greek}#1%\n 
\\endgroup}\n\n\\newcommand\\heb[1]{\\begingroup%\n  \\cjRL{#1}%\n 
\\endgroup}\n\n\\setlength{\\parindent}{0pt}\n\\setlength{\\parskip}{1ex}"
                              ("\\chapter{%s}" . "\\chapter*{%s}")
                              ("\\section{%s}" . "\\section*{%s}")
                              ("\\subsection{%s}" . "\\subsection*{%s}")
                              ("\\subsubsection{%s}" . 
"\\subsubsection*{%s}"))
                             ("ErrorSample"
 
"\\documentclass[letter,twoside,openright]{memoir}\n\\usepackage{varioref}\n\\usepackage{shorttoc}\n\\usepackage{color}\n\\usepackage{graphicx}\n\\usepackage{bbding}\n\n\\setlength{\\parindent}{0pt}\n\\setlength{\\parskip}{1ex}"
                              ("\\chapter{%s}" . "\\chapter*{%s}")
                              ("\\section{%s}" . "\\section*{%s}")
                              ("\\subsection{%s}" . "\\subsection*{%s}")
                              ("\\subsubsection{%s}" . 
"\\subsubsection*{%s}"))
                             )
  org-use-speed-commands t
  org-mode-hook '((lambda nil
                   (setq org-mouse-context-menu-function (quote 
org-mouse-context-menu))
                   (when (memq (quote context-menu) org-mouse-features)
                    (define-key org-mouse-map
                     (if (featurep (quote xemacs)) [button3] [mouse-3]) nil)
                    (define-key org-mode-map [mouse-3]
                     (quote org-mouse-show-context-menu))
                    )
                   (define-key org-mode-map [down-mouse-1] (quote 
org-mouse-down-mouse))
                   (when (memq (quote context-menu) org-mouse-features)
                    (define-key org-mouse-map [C-drag-mouse-1]
                     (quote org-mouse-move-tree))
                    (define-key org-mouse-map [C-down-mouse-1]
                     (quote org-mouse-move-tree-start))
                    )
                   (when (memq (quote yank-link) org-mouse-features)
                    (define-key org-mode-map [S-mouse-2] (quote 
org-mouse-yank-link))
                    (define-key org-mode-map [drag-mouse-3] (quote 
org-mouse-yank-link)))
                   (when (memq (quote move-tree) org-mouse-features)
                    (define-key org-mouse-map [drag-mouse-3] (quote 
org-mouse-move-tree))
                    (define-key org-mouse-map [down-mouse-3]
                     (quote org-mouse-move-tree-start))
                    )
                   (when (memq (quote activate-stars) org-mouse-features)
                    (font-lock-add-keywords nil
                     (\`
                      (((\, outline-regexp) 0
                        (\`
                         (face org-link mouse-face highlight keymap (\, 
org-mouse-map)))
                        (quote prepend))
                       )
                      )
                     t)
                    )
                   (when (memq (quote activate-bullets) org-mouse-features)
                    (font-lock-add-keywords nil
                     (\`
                      (("^[ 	]*\\([-+*]\\|[0-9]+[.)]\\) +"
                        (1
                         (\`
                          (face org-link keymap (\, org-mouse-map) 
mouse-face highlight))
                         (quote prepend))
                        )
                       )
                      )
                     t)
                    )
                   (when (memq (quote activate-checkboxes) 
org-mouse-features)
                    (font-lock-add-keywords nil
                     (\`
                      (("^[ 	]*\\([-+*]\\|[0-9]+[.)]\\) +\\(\\[[ X]\\]\\)"
                        (2
                         (\` (face bold keymap (\, org-mouse-map) 
mouse-face highlight))
                         t)
                        )
                       )
                      )
                     t)
                    )
                   (defadvice org-open-at-point (around 
org-mouse-open-at-point activate)
                    (let ((context (org-context)))
                     (cond ((assq :headline-stars context) (org-cycle))
                      ((assq :checkbox context) (org-toggle-checkbox))
                      ((assq :item-bullet context)
                       (let ((org-cycle-include-plain-lists t)) 
(org-cycle)))
                      (t ad-do-it))
                     )
                    )
                   )
                  #[nil "\302\300!\210\303\x10\304\305\306\"\210\307 
\310\311#\207"
                    [yas/trigger-key yas/keymap 
make-variable-buffer-local [tab]
                     add-to-list org-tab-first-hook 
yas/org-very-safe-expand define-key
                     [tab] yas/next-field]
                    4]
                  (lambda nil
                   (org-add-hook (quote change-major-mode-hook)
                    (quote org-babel-show-result-all) (quote append) 
(quote local))
                   )
                  org-babel-result-hide-spec org-babel-hide-all-hashes
                  (lambda nil
                   (add-hook (quote after-save-hook) (quote 
org-fireforg-registry-update)
                    t t)
                   )
                  #[nil "\300\301\302\303\304$\207"
                    [org-add-hook change-major-mode-hook 
org-show-block-all append local]
                    5]
                  )
  org-ctrl-c-ctrl-c-hook '(org-babel-lob-execute-maybe 
org-babel-hash-at-point
                           org-babel-execute-src-block-maybe)
  org-confirm-elisp-link-function 'yes-or-no-p
  org-agenda-mode-hook '((lambda nil
                          (setq org-mouse-context-menu-function
                           (quote org-mouse-agenda-context-menu))
                          (define-key org-agenda-mode-map
                           (if (featurep (quote xemacs)) [button3] 
[mouse-3])
                           (quote org-mouse-show-context-menu))
                          (define-key org-agenda-mode-map [down-mouse-3]
                           (quote org-mouse-move-tree-start))
                          (define-key org-agenda-mode-map
                           (if (featurep (quote xemacs)) [(control 
mouse-4)] [C-mouse-4])
                           (quote org-agenda-earlier))
                          (define-key org-agenda-mode-map
                           (if (featurep (quote xemacs)) [(control 
mouse-5)] [C-mouse-5])
                           (quote org-agenda-later))
                          (define-key org-agenda-mode-map [drag-mouse-3]
                           (quote
                            (lambda (event) (interactive "e")
                             (case (org-mouse-get-gesture event)
                              (:left (org-agenda-earlier 1))
                              (:right (org-agenda-later 1)))
                             )
                            )
                           )
                          )
                         )
  org-agenda-start-on-weekday nil
  org-export-interblocks '((lob org-babel-exp-lob-one-liners)
                           (src org-babel-exp-inline-src-blocks))
  org-agenda-skip-deadline-if-done t
  org-enforce-todo-dependencies t
  org-occur-hook '(org-first-headline-recenter)
  org-from-is-user-regexp nil
  org-export-preprocess-before-selecting-backend-code-hook 
'(org-beamer-select-beamer-code)
  org-remember-templates '(("Todo" 116 "* TODO %?\n  %i\n  %a\n" 
"~/org/TODO.org" "Tasks")
                           ("Journal" 106 "* %U %?\n\n  %i\n  %a\n" 
"~/org/JOURNAL.org")
                           ("Idea" 105 "* %^{Title}\n  %i\n  %a\n" 
"~/org/JOURNAL.org"
                            "New Ideas")
                           ("Project" 112 "* %^{Title}\n  %i\n  %a\n"
                            "~/org/ProjectNotes.org" "Project Notes")
                           ("Browser" 119 "* %^{Title}\n  %u\n\n 
Source: %c\n\n  %i"
                            "~/org/Notes.org" "Notes")
                           )
  org-export-latex-final-hook '(org-beamer-amend-header org-beamer-fix-toc
                                org-beamer-auto-fragile-frames
                                org-beamer-place-default-actions-for-lists)
  org-enforce-todo-checkbox-dependencies t
  org-metadown-hook '(org-babel-pop-to-session-maybe)
  org-export-blocks '((src org-babel-exp-src-blocks nil)
                      (comment org-export-blocks-format-comment t)
                      (ditaa org-export-blocks-format-ditaa nil)
                      (dot org-export-blocks-format-dot nil))
  )

^ permalink raw reply	[relevance 6%]

* Re: Change line spacing for lists for LaTeX export
  2009-06-18 22:02 10% Change line spacing for lists for " Alan E. Davis
  2009-06-18 22:18  0% ` Alan E. Davis
@ 2009-06-26 15:41  0% ` Carsten Dominik
  1 sibling, 0 replies; 59+ results
From: Carsten Dominik @ 2009-06-26 15:41 UTC (permalink / raw)
  To: Alan E. Davis; +Cc: org-mode


On Jun 19, 2009, at 12:02 AM, Alan E. Davis wrote:

> I need to print outlines in a more compact form than LaTeX lists  
> ordinarily provide.  I often have used the paralist package,  
> although it conflicts with some other packages.  How can I alter the  
> line spacing for the lists directly, for export?
>
> I found this suggestion, and I was going to use #+LATEX_HEADER:, but  
> then it occured to me that I don't have a way to specifiy that  
> "my_enumerate" would be used instead of "enumerate".
>
> This is the code I found on line:
>
> %
> % this makes list spacing much better.
> %
> \newenvironment{my_enumerate}{
> \begin{enumerate}
>   \setlength{\itemsep}{1pt}
>   \setlength{\parskip}{0pt}
>   \setlength{\parsep}{0pt}}{\end{enumerate}
>
>
> }
> Thank you for any suggestions.

You can now (latest git) define an environment like you do above

Then set

(setq org-export-latex-low-levels '("\\begin{myenv}" "\\end{myenv}" "\ 
\item %s"))


Now this environment will be used for the lower levels of LaTeX export.

Note that you can use

#+OPTIONS: H:0

to force even the top-level headings into this environment.

HTH

- Carsten

>
>
> Alan Davis
>
> "Pollution is nothing but the resources we are not harvesting. We  
> allow them to disperse because we've been ignorant of their value."
>   --- Buckminster Fuller
>
> _______________________________________________
> Emacs-orgmode mailing list
> Remember: use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 0%]

* Re: Change line spacing for lists for LaTeX export
  2009-06-18 22:19  0%   ` Alan E. Davis
@ 2009-06-18 23:09 10%     ` Alan E. Davis
  0 siblings, 0 replies; 59+ results
From: Alan E. Davis @ 2009-06-18 23:09 UTC (permalink / raw)
  To: org-mode


[-- Attachment #1.1: Type: text/plain, Size: 652 bytes --]

I apologize for sending so many updates.

I was able to get the feature I desire by adding the following to the top of
the exported LaTeX and replacing "itemize" with "packed_item".

\newenvironment{packed_item}{
\begin{itemize}
  \setlength{\itemsep}{1pt}
  \setlength{\parskip}{0pt}
  \setlength{\parsep}{0pt}
}{\end{itemize}}

It would be preferable by far to be able to get this effect straightaway in
exported pdfs.

But I think I need to  change my mode of outlining or else find  a way to
reduce the spacing in sectioning-based outlines in the exported LaTeX.
Perhaps a macro to convert from ** based outlines to plain list (-)
outlines.


Alan

[-- Attachment #1.2: Type: text/html, Size: 795 bytes --]

[-- Attachment #2: Type: text/plain, Size: 204 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 10%]

* Re: Change line spacing for lists for LaTeX export
  2009-06-18 22:18  0% ` Alan E. Davis
@ 2009-06-18 22:19  0%   ` Alan E. Davis
  2009-06-18 23:09 10%     ` Alan E. Davis
  0 siblings, 1 reply; 59+ results
From: Alan E. Davis @ 2009-06-18 22:19 UTC (permalink / raw)
  To: org-mode


[-- Attachment #1.1: Type: text/plain, Size: 1935 bytes --]

I had used the following:

#+LATEX_HEADER:\addtolength{\itemsep}{-4pt}

and, previously:

#+LATEX_HEADER:\setlength{\itemsep}{1pt}

Neither of them makes a difference.


Alan




On Fri, Jun 19, 2009 at 8:18 AM, Alan E. Davis <lngndvs@gmail.com> wrote:

> I can see now that the LaTeX source for my outline is not in list form, but
> in sections.   When I reformat to use list notation in org, the following do
> not change anything in the pdf that is output.  Interestingly, when I export
> LaTeX into a buffer latex then complains about too many nested levels, while
> the pdf is exported ok.
>
> Perhaps there is another length parameter I can change to make the outlines
> based on sectioning more compact.
>
>
> Alan
>
> "Pollution is nothing but the resources we are not harvesting. We allow
> them to disperse because we've been ignorant of their value."
>   --- Buckminster Fuller
>
>
>
> On Fri, Jun 19, 2009 at 8:02 AM, Alan E. Davis <lngndvs@gmail.com> wrote:
>
>> I need to print outlines in a more compact form than LaTeX lists
>> ordinarily provide.  I often have used the paralist package, although it
>> conflicts with some other packages.  How can I alter the line spacing for
>> the lists directly, for export?
>>
>> I found this suggestion, and I was going to use #+LATEX_HEADER:, but then
>> it occured to me that I don't have a way to specifiy that "my_enumerate"
>> would be used instead of "enumerate".
>>
>> This is the code I found on line:
>>
>> %
>> % this makes list spacing much better.
>> %
>> \newenvironment{my_enumerate}{
>> \begin{enumerate}
>>   \setlength{\itemsep}{1pt}
>>   \setlength{\parskip}{0pt}
>>   \setlength{\parsep}{0pt}}{\end{enumerate}
>>
>>
>>
>> }
>>
>> Thank you for any suggestions.
>>
>>
>> Alan Davis
>>
>> "Pollution is nothing but the resources we are not harvesting. We allow
>> them to disperse because we've been ignorant of their value."
>>   --- Buckminster Fuller
>>
>>
>

[-- Attachment #1.2: Type: text/html, Size: 2753 bytes --]

[-- Attachment #2: Type: text/plain, Size: 204 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 0%]

* Re: Change line spacing for lists for LaTeX export
  2009-06-18 22:02 10% Change line spacing for lists for " Alan E. Davis
@ 2009-06-18 22:18  0% ` Alan E. Davis
  2009-06-18 22:19  0%   ` Alan E. Davis
  2009-06-26 15:41  0% ` Carsten Dominik
  1 sibling, 1 reply; 59+ results
From: Alan E. Davis @ 2009-06-18 22:18 UTC (permalink / raw)
  To: org-mode


[-- Attachment #1.1: Type: text/plain, Size: 1611 bytes --]

I can see now that the LaTeX source for my outline is not in list form, but
in sections.   When I reformat to use list notation in org, the following do
not change anything in the pdf that is output.  Interestingly, when I export
LaTeX into a buffer latex then complains about too many nested levels, while
the pdf is exported ok.

Perhaps there is another length parameter I can change to make the outlines
based on sectioning more compact.


Alan

"Pollution is nothing but the resources we are not harvesting. We allow them
to disperse because we've been ignorant of their value."
  --- Buckminster Fuller



On Fri, Jun 19, 2009 at 8:02 AM, Alan E. Davis <lngndvs@gmail.com> wrote:

> I need to print outlines in a more compact form than LaTeX lists ordinarily
> provide.  I often have used the paralist package, although it conflicts with
> some other packages.  How can I alter the line spacing for the lists
> directly, for export?
>
> I found this suggestion, and I was going to use #+LATEX_HEADER:, but then
> it occured to me that I don't have a way to specifiy that "my_enumerate"
> would be used instead of "enumerate".
>
> This is the code I found on line:
>
> %
> % this makes list spacing much better.
> %
> \newenvironment{my_enumerate}{
> \begin{enumerate}
>   \setlength{\itemsep}{1pt}
>   \setlength{\parskip}{0pt}
>   \setlength{\parsep}{0pt}}{\end{enumerate}
>
>
> }
>
> Thank you for any suggestions.
>
>
> Alan Davis
>
> "Pollution is nothing but the resources we are not harvesting. We allow
> them to disperse because we've been ignorant of their value."
>   --- Buckminster Fuller
>
>

[-- Attachment #1.2: Type: text/html, Size: 2052 bytes --]

[-- Attachment #2: Type: text/plain, Size: 204 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 0%]

* Change line spacing for lists for LaTeX export
@ 2009-06-18 22:02 10% Alan E. Davis
  2009-06-18 22:18  0% ` Alan E. Davis
  2009-06-26 15:41  0% ` Carsten Dominik
  0 siblings, 2 replies; 59+ results
From: Alan E. Davis @ 2009-06-18 22:02 UTC (permalink / raw)
  To: org-mode


[-- Attachment #1.1: Type: text/plain, Size: 866 bytes --]

I need to print outlines in a more compact form than LaTeX lists ordinarily
provide.  I often have used the paralist package, although it conflicts with
some other packages.  How can I alter the line spacing for the lists
directly, for export?

I found this suggestion, and I was going to use #+LATEX_HEADER:, but then it
occured to me that I don't have a way to specifiy that "my_enumerate" would
be used instead of "enumerate".

This is the code I found on line:

%
% this makes list spacing much better.
%
\newenvironment{my_enumerate}{
\begin{enumerate}
  \setlength{\itemsep}{1pt}
  \setlength{\parskip}{0pt}
  \setlength{\parsep}{0pt}}{\end{enumerate}

}

Thank you for any suggestions.


Alan Davis

"Pollution is nothing but the resources we are not harvesting. We allow them
to disperse because we've been ignorant of their value."
  --- Buckminster Fuller

[-- Attachment #1.2: Type: text/html, Size: 1052 bytes --]

[-- Attachment #2: Type: text/plain, Size: 204 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 10%]

* Re: Sectioning in LaTeX export
  @ 2009-04-08  6:17  2%   ` Manish
  0 siblings, 0 replies; 59+ results
From: Manish @ 2009-04-08  6:17 UTC (permalink / raw)
  To: Mark Elston; +Cc: Org Mode List

  On Wed, Apr 8, 2009 at 7:46 AM, Mark Elston wrote:
  > Mark Elston wrote:
  >>
  >> I have an org file I use specifically for exporting a collection of
  >> other org files to pdf (using LaTeX). However, the resulting output
  >> is not very much like I would like it to be.
  >>
  >> I am using the book class for now but will likely add my own LaTeX_CLASS
  >> entry later once I get this all figured out.
  >>
  >> Ideally, each included file should form its own chapter. Within that
  >> chapter each level 1 heading would be a section, level 2 headings would
  >> be subsections, etc.
  >>
  >> I cannot get this to happen. Every level 1 heading is always an itemize
  >> item and level 2 and below just show up as "** <heading>" lines.
  >>
  >> Currently, at the top of my top-level org file I have the following:
  >>
  >> #+TITLE: My Tasks
  >> #+OPTIONS: H:4 num:t d:t
  >> #+LaTeX_CLASS: book
  >>
  >> The title and class seem to work but the options line seems to be
  >> ignored.
  >>
  >> How can I enforce some structure to my resulting latex code?
  >>
  >> Mark
  >
  > I forgot to mention that, right now, I am including the 'chapter' org
  > files with the following approach:
  >
  > #+LaTeX: \chapter{Ch 1 Name}
  > #+INCLUDE: "~/org/ch1.org"
  >
  > #+LaTeX: \chapter{Ch 2 Name}
  > #+INCLUDE: "~/org/ch2.org"
  >
  > etc. This was the only way I could think of to get chapter divisions.

Hello Mike,

My setup is far from being ideal but it has been working for me
satisfactorily.  I am sharing it below.  Some large pieces have been
commented out during as part of my earlier experiments but I am
leaving them in.

- All content for a document is kept in a single file, each heading
  being a chapter.

- There is a header file I include to add packages, fonts, standard
  confidentiality notice, footer, page number information etc.

- I am using a report class but I wanted to title headings like
  chapters etc.  So a custom Latex class is defined using
  org-export-latex-classes in .emacs and is used in the document using
  #+LaTeX_Class directive.  I forgot where I picked this up from (may
  be it was a Russel Adam's post.)

- Disclaimer: I do not know Latex well at all.  I just managed to
  assemble a reasonably working system thing together.  Integration
  with Org made made it all worthwhile since I just have to adjust
  header.tex for each new document and write in super-intuitive Org
  style.  May be I can utilize new {{{TITLE}}} like macros sometime..

Sample document
--8<---------------cut here---------------start------------->8---
#+LaTeX_Class: myreport

* Executive summary
* Assumptions
*** Assumptions set 1
*** Assumption set 2
* Phase 1
* Phase 2
* Conclusion
--8<---------------cut here---------------end--------------->8---

The sample document above when published as PDF from Org:
- has each level 1 heading turned into a chapter, level 2 heading into
  a section and so on.  Section and subsections are marked in 1.1.1
  format.  Personally I found splitting a document in different files
  unnecessary with Org's folding goodness (splitting could still be
  useful if the pieces can be reused.)
- has a cover page with title and author name (pulled from
  header.tex - appears later in this email.)
- has a confidentiality notice and document version control page
  (mandatory at my workplace.)
- has footer marking document classification (again mandatory.)
- has page numbers in the right hand corner in "current of last"
  format except for on the chapter title pages.
- has a table of contents will page numbers as hyperlinks
- left top corner of the page prints the document title and right top
  corner prints current chapter.
- list of figures and tables can also be added by uncommenting a
  couple of lines near the end of the header.tex


header.tex
--8<---------------cut here---------------start------------->8---
%\documentclass[a4paper,11pt]{article}
\documentclass[a4paper,11pt]{report}
%\documentclass[a4paper,11pt]{memoir} % doesn't work yet

\makeatletter
\def\@makechapterhead#1{%
  \vspace*{50\p@}%
  {\parindent \z@ \raggedright \normalfont
    \ifnum \c@secnumdepth >\m@ne
%      \if@mainmatter% remove this line if using report
        \huge\bfseries \thechapter\space
%      \fi% remove this line if using report
    \fi
    \interlinepenalty\@M
    \Huge \bfseries #1\par\nobreak
    \vskip 40\p@
  }}
\makeatother

\usepackage[pdftex]{graphicx,color}
 \usepackage[lmargin=1.20in,%
             rmargin=1.20in,%
             tmargin=1.20in,%
             bmargin=1.20in,%
             pdftex]{geometry}
\usepackage{bookman}            % coolest font I have been able to make work
%\usepackage{kpfonts}           % part of TexLive not in Cygwin
%\usepackage[T1]{fontenc}
%\usepackage{pxfonts}
%\usepackage{palatino}
%\usepackage{pslatex}
%\usepackage{times}             % looks bad
%\usepackage{ae,aecompl}        % good, but too light
%\usepackage{helvet}
%\usepackage{lmodern}
%\usepackage{textcomp}
%\usepackage{palatcm}

% \usepackage{showkeys}         % shows label in final document..
useful when drafting a document.

\usepackage{makeidx}
\makeindex
\usepackage{colortbl}
\usepackage{longtable}
\usepackage[table]{xcolor}
\usepackage{lastpage}
%\usepackage{lscape}
\usepackage{pdflscape}
\usepackage{cmap}
\usepackage{chngpage}

\usepackage{fancyhdr}
\pagestyle{fancy}
\renewcommand{\headrulewidth}{1pt}
\renewcommand{\footrulewidth}{1pt}
\renewcommand{\chaptermark}[1]{\markboth{#1}{}}
\renewcommand{\sectionmark}[1]{\markright{#1}{}}
\lhead[lh-even]{\small{Cloud Computing}}
\lfoot[lf-even]{}
\chead[ch-even]{}
\cfoot[cf-even]{\small{Confidential}}
\rhead[rh-even]{\small{\rightmark}}
\rfoot[rf-even]{\small{\thepage~ of \pageref{LastPage}}}

\usepackage{float} % very cool package.. allows precise control of
floats.. even in multicol environments.
\floatstyle{plain}

\usepackage{indentfirst}        % to indent the first para (British style)
\usepackage{multicol}

\usepackage[plainpages=false,colorlinks,%
  pdftoolbar=true,%
  pdfmenubar=false,%
  pdftitle={Document title goes here},%
  pdfauthor={Your name},%
  linktocpage=true,%
  bookmarks=true,%
  plainpages=false,%
  pdffitwindow=false,%
  colorlinks=true,%
  linkcolor=blue,%
  urlcolor=blue,%
%  pdfpagemode=FullScreen,%
%  pdfstartpage=3,%
  pdfdisplaydoctitle=true,%
%  frenchlinks=true,%
  pdftex]{hyperref}
%=-=-=-=-=-=-=-=-=-=-=-=-
% for that huge landscaped image

\newenvironment{changemargin}[2]{%
  \begin{list}{}{%
    \setlength{\topsep}{0pt}%
    \setlength{\leftmargin}{#1}%
    \setlength{\rightmargin}{#2}%
    \setlength{\listparindent}{\parindent}%
    \setlength{\itemindent}{\parindent}%
    \setlength{\parsep}{\parskip}%
  }%
  \item[]}{\end{list}}

%=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
%% \usepackage{tikz}
%% %\usepackage[colorinlistoftodos]{todonotes}

%% % Command for inserting a todo item
%% \newcommand{\todo}[1]{%
%% % Add to todo list
%% \addcontentsline{tdo}{todo}{\protect{#1}}%
%% %
%% \begin{tikzpicture}[remember picture, baseline=-0.75ex]%
%% \node [coordinate] (inText) {};
%% \end{tikzpicture}%
%% %
%% % Make the margin par
%% \marginpar{%
%% \begin{tikzpicture}[remember picture]%
%% \definecolor{orange}{rgb}{1,0.5,0}
%% \draw node[draw=black, fill=orange, text width = 3cm] (inNote)
%% {#1};%
%% \end{tikzpicture}%
%% }%
%% %
%% \begin{tikzpicture}[remember picture, overlay]%
%% \draw[draw = orange, thick]
%% ([yshift=-0.2cm] inText)
%% -| ([xshift=-0.2cm] inNote.west)
%% -| (inNote.west);
%% \end{tikzpicture}%
%% %
%% }%

% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

% \usepackage[style=altlist,toc,number=section,hypertoc,acronym]{glossary}
% \makeglossary
% \makeacronym
% \storeglosentry{bt}{name=business transaction,
%   description={e.g. AP, AR etc.}}
% \storeglosentry{cp}{name=concurrent,
%   description={non-interactive and relatively long running program
submitted as a batch job}}

% \newacronym{CS}{Clinical Services}{description=Clinical Services}
% \newacronym{DI}{Digital Imaging}{description=Digital Imaging}
% \newacronym{US}{Ultra Sound}{description=Ultra Sound}
% \newacronym{TPM}{Transaction Per Minute}{description=Transactions Per Minute}
%\newacronym{}{}{description=}

% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\title{Document title goes here\\
\rule{\linewidth}{0.25cm}}
% \author{\href{http://www.yourcommany.com/}{Your Name}}
\author{Your Name}
\date{}

\renewcommand{\baselinestretch}{1.25}

\begin{document}
\maketitle

\begin{center}
 \textbf{\Large{NOTICE}}
\end{center}

{\large The information contained in this document is not to be used
  for any purpose other than the purposes for which this document is
  furnished by YourCompany, nor is this document (in whole or in part) to
  be reproduced or furnished to other YourCompany employees without a need
  to know, or to any third party or made public without the prior
  express written permission of YourCompany.  }

\begin{center}
\textbf{\Large{Version Control}}
\end{center}

\begin{center}
\begin{tabular}{|p{1.5cm}|p{2cm}|p{3cm}|p{2.5cm}|p{2.5cm}|} \hline
Version no. & Version Date & Type of changes & Author & Date of
review/expiry \\ \hline
\scriptsize{1.0} & \scriptsize{2009.04.05} & \scriptsize{Initial
creation} & \scriptsize{\href{http://www.yourcompany.com/}{Your Name}}
& \scriptsize{2009.05.01} \\ \hline
\end{tabular}
\end{center}

%\pagebreak
%\pagenumbering{roman}
\tableofcontents
% \listoffigures
% \listoftables
%\pagebreak

%% \chapter{Pending Items}
%% \listoftodos
--8<---------------cut here---------------end--------------->8---

excerpt from .emacs
--8<---------------cut here---------------start------------->8---
 '(org-export-latex-classes (quote (("myreport" "% BEGIN My Report Defaults
%\\documentclass[10pt,a4paper]{report}
\\input{/home/zms/personal.git/header.tex}
% END My Report Defaults

" ("\\chapter{%s}" . "\\chapter{%s}") ("\\section{%s}" .
"\\section{%s}") ("\\subsection{%s}" . "\\subsection{%s}")
("\\subsubsection{%s}" . "\\subsubsection{%s}") ("\\paragraph{%s}" .
"\\paragraph{%s}") ("\\subparagraph{%s}" . "\\subparagraph{%s}"))
("article" "\\documentclass[11pt,a4paper]{article}
\\usepackage[utf8]{inputenc}
\\usepackage[T1]{fontenc}
\\usepackage{hyperref}" ("\\section{%s}" . "\\section*{%s}")
("\\subsection{%s}" . "\\subsection*{%s}") ("\\subsubsection{%s}" .
"\\subsubsection*{%s}") ("\\paragraph{%s}" . "\\paragraph*{%s}")
("\\subparagraph{%s}" . "\\subparagraph*{%s}")) ("report"
"\\documentclass[11pt,a4paper]{report}
\\usepackage[utf8]{inputenc}
\\usepackage[T1]{fontenc}
\\usepackage{hyperref}" ("\\part{%s}" . "\\part*{%s}")
("\\chapter{%s}" . "\\chapter*{%s}") ("\\section{%s}" .
"\\section*{%s}") ("\\subsection{%s}" . "\\subsection*{%s}")
("\\subsubsection{%s}" . "\\subsubsection*{%s}")) ("book"
"\\documentclass[11pt,a4paper]{book}
\\usepackage[utf8]{inputenc}
\\usepackage[T1]{fontenc}
\\usepackage{hyperref}" ("\\part{%s}" . "\\part*{%s}")
("\\chapter{%s}" . "\\chapter*{%s}") ("\\section{%s}" .
"\\section*{%s}") ("\\subsection{%s}" . "\\subsection*{%s}")
("\\subsubsection{%s}" . "\\subsubsection*{%s}")))))
--8<---------------cut here---------------end--------------->8---

I also wanted to place images and charts appearing in the document in
the sequence they appear in my original document but LaTeX floated
them where it wished.  This was irritating.  Then I found
"\usepackage{float}".  With this I can add an image like below and it
would appear where I wanted it due to that new [H] option instead of
[htb].  I had to edit org-export-latex.el to add that as default
though since images added via org will automatically get [htb].

Org
--8<---------------cut here---------------start------------->8---
#+CAPTION: Hourly Trend of Concurrent Jobs
#+LABEL: fig:conc-trend-over-hours
[[./conc-trend-over-hours.png]]
#+ATTR_LaTeX: scale=0.65
--8<---------------cut here---------------end--------------->8---

LaTeX
--8<---------------cut here---------------start------------->8---
\begin{figure}[H]
  \centering \includegraphics[scale=0.65]{conc-trend-over-hours.png}
  \caption{Hourly Trend of Concurrent Jobs}\label{fig:conc-trend-over-hours}}
\end{figure}
--8<---------------cut here---------------end--------------->8---

Patch
--8<---------------cut here---------------start------------->8---
---
 lisp/org-export-latex.el |    4 ++--
 1 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/lisp/org-export-latex.el b/lisp/org-export-latex.el
index 06f9f0f..a120966 100644
--- a/lisp/org-export-latex.el
+++ b/lisp/org-export-latex.el
@@ -1179,7 +1179,7 @@ The conversion is made depending of
STRING-BEFORE and STRING-AFTER."
                     (concat
                      (if longtblp
                          (concat "\\begin{longtable}{" align "}\n")
-                       (if floatp "\\begin{table}[htb]\n"))
+                       (if floatp "\\begin{table}[H]\n"))
                      (if (or floatp longtblp)
                          (format
                           "\\caption{%s%s}"
@@ -1303,7 +1303,7 @@ The conversion is made depending of
STRING-BEFORE and STRING-AFTER."
        (cond ((and imgp (plist-get org-export-latex-options-plist
:inline-images))
              (insert
               (concat
-               (if floatp "\\begin{figure}[htb]\n")
+               (if floatp "\\begin{figure}[H]\n")
                (format "\\centerline{\\includegraphics[%s]{%s}}\n"
                        (or attr org-export-latex-image-default-option)
                        (if (file-name-absolute-p raw-path)
--
1.6.1.2
--8<---------------cut here---------------end--------------->8---

I realize it might look some Rube Goldgergian setup, probably more
complex and messy than it needs to be.  Sorry about that.  Comments
and suggestions will be highly appreciated.

HTH somehow.
-- 
Manish

^ permalink raw reply related	[relevance 2%]

* Re: Keeping Your Appointments in org
  @ 2009-01-08 22:33  0%   ` Shelagh Manton
  0 siblings, 0 replies; 59+ results
From: Shelagh Manton @ 2009-01-08 22:33 UTC (permalink / raw)
  To: emacs-orgmode

On Thu, 08 Jan 2009 08:47:37 -0200, Daniel Martins wrote:

> I have the same migration problem.
> 
> I still use Google Calendar to share appts with my students. Sometimes
> they mark an appt on certain dates etc...
> 
> My migration problem is threefold since I migrated from planner-el too
> and I use remind a lot. I like wyrd for remote operation and I had
> remind - diary - ical and planner-el very integrated.
> 
> I posted an email about this topíc a couple of weeks ago.
> 
> I sincerely think that org-mode would be improved from using remind. At
> least until org-mode have all the calendar niceties that remind provides
> for quite complex periodic dates and "strange" holidays and non working
> days. Remind is quite a powerful calendar parser.
> 
> 
> Wyrd (a remind interface) is a clean interface to see appts and schedule
> even remotely.
> 
> Org-mode however exceeds remind, wyrd and planner-el as tool for
> organization as a whole.
> 
> 
> An interesting aspect is that we can use the "remind path" to automate
> some of the conversion from ical (eg Google Calendar) to org-mode.
> 
> The ical -> org-mode could be done using the longer path
> 
> ical -> remind -> diary -> org-mode
> 
> Via
> 
> ical -> remind:  http://wiki.43folders.com/index.php/*ICal2Rem*
> 
> remind -> diary:   Sacha's rem2diary
> 
> diary -> org-mode:  (setq org-agenda-include-diary t)
> 
> 
> the reverse path could be directly
> 
> org-mode -> ical
> 
> .reminders.org.deadline
> .reminders.org.scheduled
> 
> However  to add all my appts in
> .reminders.org.deadline and
>  .reminders.org.scheduled
>   from inside org-mode
> 
> I think that
> 
> org2rem
> from Bastien
> 
> is lacking a few features such as timed reminders and generates a non
> completely compatible .reminders files
> 
> I have made some corrections and org2rem is working better now but it is
> still lacking to add appts with timestamps (ie with no SCHEDULED: or
> DEADLINE: tags)
> 
> If someone is also interested I cand send my version of org2rem

I am interested in your version of org2rem. I use remind quite regularly 
in conjunction with org-mode and tried a few months ago to work out how 
to improve org2rem myself, either stripping the org-mode priority cookies 
or changing them to something remind could use, but my lisp skills are 
too feeble to work out how to do it.

Shelagh 
> 
> I hope this helps,
> 
> Daniel
> 
> 2009/1/8 Ian Barton <lists@manor-farm.org>
> 
>> As it's the start of a new year, I want to move my appointments from
>> Google Calendar as the primary source to org. When my system in org is
>> running smoothly I will export to Google Calendar on a regular basis.
>>
>> Searching back through the list there are quite a lot of snippets
>> describing how people use org to keep appointments, but no overview. I
>> would like to write a tutorial on how you can keep your appointments in
>> org, so I thought that I would ask list members if they would post some
>> details of their system.
>>
>> I am intending to keep my appointments in a dedicated org file (
>> calendar.org). At the moment I am using a remember template which adds
>> them with a tag of APPT. I the use a custom agenda view if I only want
>> to see appointments.
>>
>> I am particularly interested in the best way to deal with repeating
>> appointments. For example how do you deal with a weekly appointment
>> that has a defined start and end date.
>>
>> Ian.
>>
>>
>> _______________________________________________ Emacs-orgmode mailing
>> list
>> Remember: use `Reply All' to send replies to the list.
>> Emacs-orgmode@gnu.org
>> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
>>
> I have the same migration problem.<br><br>I still use Google Calendar to
> share appts with my students. Sometimes they mark an appt on certain
> dates etc...<br><br>My migration problem is threefold since I migrated
> from planner-el too and&nbsp; I use remind a lot. I like wyrd for remote
> operation and I had remind - diary - ical and planner-el very
> integrated.<br>
> 
> <br>I posted an email about this topíc a couple of weeks ago.<br><br> I
> sincerely think that org-mode would be improved from using remind. At
> least until org-mode have all the calendar niceties that remind provides
> for quite complex periodic dates and &quot;strange&quot; holidays and
> non working days. Remind is quite a powerful calendar parser.<br>
> <br><br>Wyrd (a remind interface) is a clean interface to see appts and
> schedule even remotely.<br><br>Org-mode however exceeds remind, wyrd and
> planner-el as tool for organization as a whole.<br><br><br>An
> interesting aspect is that we can use the &quot;remind path&quot; to
> automate some of the conversion from ical (eg Google Calendar) to
> org-mode.<br> <br>The ical -&gt; org-mode could be done using the longer
> path<br><br>ical -&gt; remind -&gt; diary -&gt;
> org-mode<br><br>Via<br><br>ical -&gt; remind:&nbsp; <cite><a
> href="http://wiki.43folders.com/index.php/"
> target="_blank">http://wiki.43folders.com/index.php/</a><b>ICal2Rem</
b></cite><br>
> 
> <br>remind -&gt; diary: &nbsp; Sacha&#39;s rem2diary<br><br>diary -&gt;
> org-mode:&nbsp; (setq org-agenda-include-diary
> t)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br> <br><br>the reverse
> path could be directly<br><br>org-mode -&gt;
> 
ical<br><br>.reminders.org.deadline<br>.reminders.org.scheduled<br><br>However&nbsp;
> to add all my appts in <br>.reminders.org.deadline and<br>
> &nbsp;.reminders.org.scheduled<br>&nbsp; from inside org-mode <br><br>I
> think that <br> <br>org2rem <br>from Bastien<br><br>is lacking a few
> features such as timed reminders and generates a non completely
> compatible .reminders files<br><br>I have made some corrections and
> org2rem is working better now but it is still lacking to add appts with
> timestamps (ie with no SCHEDULED: or DEADLINE: tags)<br> <br>If someone
> is also interested I cand send my version of org2rem<br><br>I hope this
> helps,<br><br>Daniel<br><br><div class="gmail_quote">2009/1/8 Ian Barton
> <span dir="ltr">&lt;<a
> href="mailto:lists@manor-farm.org">lists@manor-farm.org</a>&gt;</
span><br>
> <blockquote class="gmail_quote" style="border-left: 1px solid rgb(204,
> 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">As it&#39;s
> the start of a new year, I want to move my appointments from Google
> Calendar as the primary source to org. When my system in org is running
> smoothly I will export to Google Calendar on a regular basis.<br>
> 
> <br>
> Searching back through the list there are quite a lot of snippets
> describing how people use org to keep appointments, but no overview. I
> would like to write a tutorial on how you can keep your appointments in
> org, so I thought that I would ask list members if they would post some
> details of their system.<br>
> 
> <br>
> I am intending to keep my appointments in a dedicated org file (<a
> href="http://calendar.org" target="_blank">calendar.org</a>). At the
> moment I am using a remember template which adds them with a tag of
> APPT. I the use a custom agenda view if I only want to see
> appointments.<br>
> 
> <br>
> I am particularly interested in the best way to deal with repeating
> appointments. For example how do you deal with a weekly appointment that
> has a defined start and end date.<br> <br>
> Ian.<br>
> <br>
> <br>
> _______________________________________________<br> Emacs-orgmode
> mailing list<br>
> Remember: use `Reply All&#39; to send replies to the list.<br> <a
> href="mailto:Emacs-orgmode@gnu.org"
> target="_blank">Emacs-orgmode@gnu.org</a><br> <a
> href="http://lists.gnu.org/mailman/listinfo/emacs-orgmode"
> target="_blank">http://lists.gnu.org/mailman/listinfo/emacs-orgmode</
a><br>
> </blockquote></div><br>
> _______________________________________________ Emacs-orgmode mailing
> list
> Remember: use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 0%]

* Re: Can drawers be embedded in org-mode?
  @ 2008-12-15  9:25 11%     ` Carsten Dominik
  0 siblings, 0 replies; 59+ results
From: Carsten Dominik @ 2008-12-15  9:25 UTC (permalink / raw)
  To: Jing Su; +Cc: emacs-orgmode


--Apple-Mail-1--229672533
Content-Type: text/plain;
	charset=US-ASCII;
	format=flowed;
	delsp=yes
Content-Transfer-Encoding: 7bit

Hi Jing,

No, this is not likely to be implemented.

- Carsten

On Dec 15, 2008, at 8:25 AM, Jing Su wrote:

> Thanks a lot, Carsten, I'm currently using your method.
>
> I was wondering if nest drawers would be a good idea in later  
> versions of org-mode.
>
> Best,
>
> Jing
>
>
> On Thu, Dec 4, 2008 at 3:02 AM, Carsten Dominik <dominik@science.uva.nl 
> > wrote:
> Hi Jing Su,
>
> Org-mode does not allow to nest drawers.  I guess you would simple  
> use outline structure for whay rou are tyring to do:
>
>
> * Topic I
> ** Refs
> *** ref A
> **** Abstract
>     blah blha
>
> *** ref B
> **** Abstract
>     blah blha
>
> HTH
>
> - Carsten
>
>
> On Dec 3, 2008, at 11:50 PM, Jing Su wrote:
>
> Hi there :)
>
> I tried embedded drawers but got weird results:
>
> I inputted:
>
> #+DRAWERS:  REF ABSTRACT
>
> * Topic I
>  :REF:
>   - ref A
>     :ABSTRACT:
>     blah blha
>     :END:
>   - ref B
>     :ABSTRACT:
>     blah blha
>     :END:
>   :END:
>
> and used TAB key to fold/unfold it. I expected:
>
> * Topic I
>  :REF:
>  - ref A
>    :ABSTRACT:...
>  - ref B
>    :ABSTRACT:...
>  :END:
>
> and
>
> * Topic I
>  :REF:...
>
> but found out the following:
>
> * Topic I
>  :REF:...
>  - ref B
>    :ABSTRACT:...
>  :END:
>
> am I wrong at some where, or org-mode just does not support embedded  
> drawers yet? if it's not supported, is it already in the wishing list?
>
> Thanks a lot :)
>
> JIng
>
> _______________________________________________
> Emacs-orgmode mailing list
> Remember: use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
>
>
>
>
> -- 
> Jing Su
> PhD, Georgia Tech & Emory
>


--Apple-Mail-1--229672533
Content-Type: text/html;
	charset=US-ASCII
Content-Transfer-Encoding: quoted-printable

<html><body style=3D"word-wrap: break-word; -webkit-nbsp-mode: space; =
-webkit-line-break: after-white-space; "><div>Hi =
Jing,</div><div><br></div>No, this is not likely to be =
implemented.<div><br></div><div>- Carsten</div><div><br><div><div>On Dec =
15, 2008, at 8:25 AM, Jing Su wrote:</div><br =
class=3D"Apple-interchange-newline"><blockquote type=3D"cite">Thanks a =
lot, Carsten, I'm currently using your method. <br><br>I was wondering =
if nest drawers would be a good idea in later versions of org-mode. =
<br><br>Best, <br><br>Jing<br><br><br><div class=3D"gmail_quote">On Thu, =
Dec 4, 2008 at 3:02 AM, Carsten Dominik <span dir=3D"ltr">&lt;<a =
href=3D"mailto:dominik@science.uva.nl">dominik@science.uva.nl</a>></span> =
wrote:<br> <blockquote class=3D"gmail_quote" style=3D"border-left: 1px =
solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: =
1ex;">Hi Jing Su,<br> <br> Org-mode does not allow to nest drawers. =
&nbsp;I guess you would simple use outline structure for whay rou are =
tyring to do:<br> <br> <br> * Topic I<br> ** Refs<br> *** ref A<br> **** =
Abstract<br> &nbsp; &nbsp; blah blha<br> <br> *** ref B<br> **** =
Abstract<br> &nbsp; &nbsp; blah blha<br> <br> HTH<br> <br> - =
Carsten<div><div></div><div class=3D"Wj3C7c"><br> <br> On Dec 3, 2008, =
at 11:50 PM, Jing Su wrote:<br> <br> </div></div><blockquote =
class=3D"gmail_quote" style=3D"border-left: 1px solid rgb(204, 204, =
204); margin: 0pt 0pt 0pt 0.8ex; padding-left: =
1ex;"><div><div></div><div class=3D"Wj3C7c"> Hi there :)<br> <br> I =
tried embedded drawers but got weird results:<br> <br> I inputted:<br> =
<br> #+DRAWERS: &nbsp;REF ABSTRACT<br> <br> * Topic I<br> =
&nbsp;:REF:<br> &nbsp; - ref A<br> &nbsp; &nbsp; :ABSTRACT:<br> &nbsp; =
&nbsp; blah blha<br> &nbsp; &nbsp; :END:<br> &nbsp; - ref B<br> &nbsp; =
&nbsp; :ABSTRACT:<br> &nbsp; &nbsp; blah blha<br> &nbsp; &nbsp; =
:END:<br> &nbsp; :END:<br> <br> and used TAB key to fold/unfold it. I =
expected:<br> <br> * Topic I<br> &nbsp;:REF:<br> &nbsp;- ref A<br> =
&nbsp; &nbsp;:ABSTRACT:...<br> &nbsp;- ref B<br> &nbsp; =
&nbsp;:ABSTRACT:...<br> &nbsp;:END:<br> <br> and<br> <br> * Topic I<br> =
&nbsp;:REF:...<br> <br> but found out the following:<br> <br> * Topic =
I<br> &nbsp;:REF:...<br> &nbsp;- ref B<br> &nbsp; =
&nbsp;:ABSTRACT:...<br> &nbsp;:END:<br> <br> am I wrong at some where, =
or org-mode just does not support embedded drawers yet? if it's not =
supported, is it already in the wishing list?<br> <br> Thanks a lot =
:)<br> <br> JIng<br> <br></div></div> =
_______________________________________________<br> Emacs-orgmode =
mailing list<br> Remember: use `Reply All' to send replies to the =
list.<br> <a href=3D"mailto:Emacs-orgmode@gnu.org" =
target=3D"_blank">Emacs-orgmode@gnu.org</a><br> <a =
href=3D"http://lists.gnu.org/mailman/listinfo/emacs-orgmode" =
target=3D"_blank">http://lists.gnu.org/mailman/listinfo/emacs-orgmode</a><=
br> </blockquote> <br> </blockquote></div><br><br clear=3D"all"><br>-- =
<br>Jing Su<br>PhD, Georgia Tech &amp; =
Emory<br><br></blockquote></div><br></div></body></html>=

--Apple-Mail-1--229672533--

^ permalink raw reply	[relevance 11%]

* Updated agenda printer script
@ 2007-06-03 20:44  4% Jason F. McBrayer
  0 siblings, 0 replies; 59+ results
From: Jason F. McBrayer @ 2007-06-03 20:44 UTC (permalink / raw)
  To: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 615 bytes --]

And, as promised, here's the updated version of the agenda printer
script.  This version has only bugfixes and compatibility fixes.
There are some more fundamental changes (listed in the TODOs in the
source comments) that need to be made, but I'm waiting on a round tuit
for them.  I hope people find this useful, and that it is more usable
for them than the previous version.

Changes:
  1. Uses os.popen3 rather than the subprocess module; as a result, it
     should work with python versions earlier than 2.4.
  2. Better quoting for characters in headlines that could cause
     problems in the LaTeX output.


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: Agenda printer script --]
[-- Type: text/x-python, Size: 5127 bytes --]

#!/usr/bin/python
#
# pyagenda -- export an org agenda to PDF
#
# (c) 2007, Jason F. McBrayer
# Version: 1.1
# This file is a stand-alone program.
#
# Legalese:
# pyagenda is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2, or (at your option)
# any later version.
#
# pyagenda is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# General Public License for more details.
#
# Documentation:
# pyagenda is a short python program for taking a formatted agenda
# from org-mode (via org-batch-agenda-csv) and producing a PDF-format
# planner page that can be inserted in a planner binder.  Run
# 'pyagenda --help' for usage.
#
# Currently, this is only a crude 'worksforme' implementation, with
# many things being hardcoded.  It produces an output file named
# cmdkey.pdf where 'cmdkey' is the key given to
# org-agenda-custom-commands. Not all arbitrary searches will work.
# Be aware that it may overwrite cmdkey.tex, cmdkey.log, cmdkey.aux,
# etc.  The output size is hardcoded to 5.5x8.0in, which is suitable
# for a Circa or Rollabind junior sized planner.  The output is not
# suitable for daily/weekly agenda views, and does not present all the
# information it could.  If you want to change any of the output, edit
# the TEX_* constants.
#
# TODO:
#   1. Use safer tmpfile handling.
#   2. Nicer command-line handling.
#   3. Prettier output, including use of more of the information
#      passed by org-batch-agenda-csv.
#

import csv
import sys
import os
#from subprocess import Popen, PIPE, call
from os import popen3
import re

EMACS = 'emacs'
INIT_FILE = "~/.emacs.d/init.el" # Most people should use "~/.emacs" instead
AGENDA_COMMAND = '(org-batch-agenda-csv "%s")'
REMOVE_INTERMEDIATES = True  # Remove generated latex & tex's log/aux files.

TEX_HEADER = """
\\documentclass[twoside, american]{article}
\\usepackage[T1]{fontenc}
\\usepackage[latin1]{inputenc}
\\usepackage{pslatex}
\\usepackage{geometry}
\\geometry{verbose,paperwidth=5.5in,paperheight=8in,tmargin=0.25in,bmargin=0.25in,lmargin=0.5in,rmargin=0.25in}
\\pagestyle{empty}
\\setlength{\\parskip}{\\medskipamount}
\\setlength{\\parindent}{0pt}
\\usepackage{calc}

\\makeatletter

\\newcommand{\\myline}[1]{
  {#1 \\hrule width \\columnwidth }
}

\\usepackage{babel}
\\makeatother
\\begin{document}

\\part*{\\textsf{Actions}\\hfill{}%%
\\framebox{\\begin{minipage}[t][1em][t]{0.25\\paperwidth}%%
\\textsf{%s} \\hfill{}%%
\\end{minipage}}%%
\\protect \\\\
}

\\myline{\\normalsize}


"""
TEX_FOOTER = """
\\end{document}
"""
TEX_ITEM = """
%%
\\framebox{\\begin{minipage}[c][0.5em][c]{0.5em}%%
\\hfill{}%%
\\end{minipage}}%%
%%
\\begin{minipage}[c][1em]{1em}%%
\\hfill{}%%
\\end{minipage}%%
\\textsf{%s}\\\\
\\myline{\\normalsize}
"""

class AgendaItem(object):
    def __init__(self, data=None):
        if data:
            self.category = data[0]
            self.headline = data[1]
            self.type = data[2]
            self.todo = data[3]
            self.tags = data[4].split(':')
            self.date = data[5]
            self.time = data[6]
            self.extra = data[7]
            self.prio = data[8]
            self.fullprio = data[9]

def get_agenda_items(cmdkey):
    #output = Popen([EMACS, "-batch", "-l", INIT_FILE,
    #                "-eval", AGENDA_COMMAND % cmdkey ],
    #               stdout=PIPE, stderr=PIPE)
    _, output, _ = popen3("'%s' -batch -l '%s' -eval '%s'" %
                          (EMACS, INIT_FILE, AGENDA_COMMAND % cmdkey))
    reader = csv.reader(output)
    items = []
    for row in reader:
        items.append(AgendaItem(row))
    return items

def usage():
    print "Usage: pyagenda 'cmd-key' [label]"
    print "  cmd-key is an org agenda custom command key, or an "
    print "   org-agenda tags/todo match string."
    print "  label (optional) is a context label to be printed "
    print "   at the top of your agenda page."

def main():
    try:
        search = sys.argv[1]
    except IndexError:
        usage()
        sys.exit(1)
    if search == "--help" or search == "-h":
        usage()
        sys.exit(0)
    try:
        label = sys.argv[2]
    except IndexError:
        label = ""
    texfile = file(search + ".tex", 'w')
    texfile.write(TEX_HEADER % label + "\n")
    for item in get_agenda_items(search):
        #texfile.write(TEX_ITEM %
        #              item.headline.replace('&', r'\&') + "\n" )
        texfile.write(TEX_ITEM %
                      re.sub(r'([&_#])', r'\\\1', item.headline))
    texfile.write(TEX_FOOTER)
    texfile.close()
    #call(['pdflatex', texfile.name], stdout=PIPE, stderr=PIPE)
    _, output, _ = popen3("pdflatex '%s'" % texfile.name)
    output.read() # pdflatex needs this in order to complete.
    if REMOVE_INTERMEDIATES:
        os.unlink(texfile.name)
        os.unlink(search + ".aux")
        os.unlink(search + ".log")


if __name__ == '__main__':
    main()

[-- Attachment #3: Type: text/plain, Size: 316 bytes --]



-- 
+-----------------------------------------------------------+
| Jason F. McBrayer                    jmcbray@carcosa.net  |
| If someone conquers a thousand times a thousand others in |
| battle, and someone else conquers himself, the latter one |
| is the greatest of all conquerors.  --- The Dhammapada    |

[-- Attachment #4: Type: text/plain, Size: 149 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 4%]

* Re: A little agenda printer script
  @ 2007-06-03 20:05  6%   ` Jason F. McBrayer
  0 siblings, 0 replies; 59+ results
From: Jason F. McBrayer @ 2007-06-03 20:05 UTC (permalink / raw)
  To: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 641 bytes --]

Xavier Maillard <xma@gnu.org> writes:

> I love the idea though I'd rather have it as an inside-emacs
> stuff.
> Is there a way to see what does it looks like when formatted ? (I
> do not have python installed here).

For those who have asked about the output from this script, I'm
attaching a sample of LaTeX output (1.5K) and a sample of PDF output
(17K).  Hope that isn't too big for the list.  I'll post an updated
copy of the script a bit later.  The new version does a bit better
escaping of characters that might be a problem in the produced LaTeX,
and should also work with older versions of python that lack the
subprocess module.


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: Example LaTeX output --]
[-- Type: text/x-tex, Size: 1466 bytes --]


\documentclass[twoside, american]{article}
\usepackage[T1]{fontenc}
\usepackage[latin1]{inputenc}
\usepackage{pslatex}
\usepackage{geometry}
\geometry{verbose,paperwidth=5.5in,paperheight=8in,tmargin=0.25in,bmargin=0.25in,lmargin=0.5in,rmargin=0.25in}
\pagestyle{empty}
\setlength{\parskip}{\medskipamount}
\setlength{\parindent}{0pt}
\usepackage{calc}

\makeatletter

\newcommand{\myline}[1]{
  {#1 \hrule width \columnwidth }
}

\usepackage{babel}
\makeatother
\begin{document}

\part*{\textsf{Actions}\hfill{}%
\framebox{\begin{minipage}[t][1em][t]{0.25\paperwidth}%
\textsf{@Example} \hfill{}%
\end{minipage}}%
\protect \\
}

\myline{\normalsize}




%
\framebox{\begin{minipage}[c][0.5em][c]{0.5em}%
\hfill{}%
\end{minipage}}%
%
\begin{minipage}[c][1em]{1em}%
\hfill{}%
\end{minipage}%
\textsf{Post LaTeX output to list}\\
\myline{\normalsize}

%
\framebox{\begin{minipage}[c][0.5em][c]{0.5em}%
\hfill{}%
\end{minipage}}%
%
\begin{minipage}[c][1em]{1em}%
\hfill{}%
\end{minipage}%
\textsf{Post PDF output to list or website}\\
\myline{\normalsize}

%
\framebox{\begin{minipage}[c][0.5em][c]{0.5em}%
\hfill{}%
\end{minipage}}%
%
\begin{minipage}[c][1em]{1em}%
\hfill{}%
\end{minipage}%
\textsf{Post updated pyagenda script to list}\\
\myline{\normalsize}

%
\framebox{\begin{minipage}[c][0.5em][c]{0.5em}%
\hfill{}%
\end{minipage}}%
%
\begin{minipage}[c][1em]{1em}%
\hfill{}%
\end{minipage}%
\textsf{Fill out TPS reports}\\
\myline{\normalsize}

\end{document}

[-- Attachment #3: Example PDF output --]
[-- Type: application/pdf, Size: 16983 bytes --]

[-- Attachment #4: Type: text/plain, Size: 316 bytes --]



-- 
+-----------------------------------------------------------+
| Jason F. McBrayer                    jmcbray@carcosa.net  |
| If someone conquers a thousand times a thousand others in |
| battle, and someone else conquers himself, the latter one |
| is the greatest of all conquerors.  --- The Dhammapada    |

[-- Attachment #5: Type: text/plain, Size: 149 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 6%]

* A little agenda printer script
@ 2007-05-21 13:39  4% Jason F. McBrayer
    0 siblings, 1 reply; 59+ results
From: Jason F. McBrayer @ 2007-05-21 13:39 UTC (permalink / raw)
  To: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 592 bytes --]

Taking advantage of the new org-batch-agenda-csv functionality, I've
written a little Python script for exporting an org agenda to PDF,
using LaTeX as an intermediary.  Currently, it's a bit of a crude
'worksforme' implementation that could be cleaned up a lot and made
more general.  Quite a bit of stuff is hardcoded into some LaTeX
headers/footers that are stored as python strings at the top of the
file.  Still, it's at the point that it is, in principle, useful, and
I thought I'd post it here for some feedback before putting it on my
website, announcing on the 43Folders board, etc.


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: org agenda to pdf python script --]
[-- Type: text/x-python, Size: 4626 bytes --]

#!/usr/bin/python
#
# pyagenda -- export an org agenda to PDF
#
# (c) 2007, Jason F. McBrayer
# Version: 1.0
# This file is a stand-alone program.
#
# Legalese:
# pyagenda is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2, or (at your option)
# any later version.
#
# pyagenda is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# General Public License for more details.
#
# Documentation:
# pyagenda is a short python program for taking a formatted agenda
# from org-mode (via org-batch-agenda-csv) and producing a PDF-format
# planner page that can be inserted in a planner binder.  Run
# 'pyagenda --help' for usage.
#
# Currently, this is only a crude 'worksforme' implementation, with
# many things being hardcoded.  It produces an output file named
# cmdkey.pdf where 'cmdkey' is the key given to
# org-agenda-custom-commands. Not all arbitrary searches will work.
# Be aware that it may overwrite cmdkey.tex, cmdkey.log, cmdkey.aux,
# etc.  The output size is hardcoded to 5.5x8.0in, which is suitable
# for a Circa or Rollabind junior sized planner.  The output is not
# suitable for daily/weekly agenda views, and does not present all the
# information it could.  If you want to change any of the output, edit
# the TEX_* constants.
#
# TODO:
#   1. Use safer tmpfile handling.
#   2. Nicer command-line handling.
#   3. Prettier output, including use of more of the information
#      passed by org-batch-agenda-csv.
#

import csv
import sys
import os
from subprocess import Popen, PIPE, call

EMACS = 'emacs'
INIT_FILE = "~/.emacs.d/init.el" # Most people should use "~/.emacs" instead
AGENDA_COMMAND = '(org-batch-agenda-csv "%s")'
TEX_HEADER = """
\\documentclass[twoside, american]{article}
\\usepackage[T1]{fontenc}
\\usepackage[latin1]{inputenc}
\\usepackage{pslatex}
\\usepackage{geometry}
\\geometry{verbose,paperwidth=5.5in,paperheight=8in,tmargin=0.25in,bmargin=0.25in,lmargin=0.5in,rmargin=0.25in}
\\pagestyle{empty}
\\setlength{\\parskip}{\\medskipamount}
\\setlength{\\parindent}{0pt}
\\usepackage{calc}

\\makeatletter

\\newcommand{\\myline}[1]{
  {#1 \\hrule width \\columnwidth }
}

\\usepackage{babel}
\\makeatother
\\begin{document}

\\part*{\\textsf{Actions}\\hfill{}%%
\\framebox{\\begin{minipage}[t][1em][t]{0.25\\paperwidth}%%
\\textsf{%s} \\hfill{}%%
\\end{minipage}}%%
\\protect \\\\
}

\\myline{\\normalsize}


"""
TEX_FOOTER = """
\\end{document}
"""
TEX_ITEM = """
%%
\\framebox{\\begin{minipage}[c][0.5em][c]{0.5em}%%
\\hfill{}%%
\\end{minipage}}%%
%%
\\begin{minipage}[c][1em]{1em}%%
\\hfill{}%%
\\end{minipage}%%
\\textsf{%s}\\\\
\\myline{\\normalsize}
"""

class AgendaItem(object):
    def __init__(self, data=None):
        if data:
            self.category = data[0]
            self.headline = data[1]
            self.type = data[2]
            self.todo = data[3]
            self.tags = data[4].split(':')
            self.date = data[5]
            self.time = data[6]
            self.extra = data[7]
            self.prio = data[8]
            self.fullprio = data[9]

def get_agenda_items(cmdkey):
    output = Popen([EMACS, "-batch", "-l", INIT_FILE,
                    "-eval", AGENDA_COMMAND % cmdkey ],
                   stdout=PIPE, stderr=PIPE)

    reader = csv.reader(output.stdout)
    items = []
    for row in reader:
        items.append(AgendaItem(row))
    return items

def usage():
    print "Usage: pyagenda 'cmd-key' [label]"
    print "  cmd-key is an org agenda custom command key, or an "
    print "   org-agenda tags/todo match string."
    print "  label (optional) is a context label to be printed "
    print "   at the top of your agenda page."

def main():
    try:
        search = sys.argv[1]
    except IndexError:
        usage()
        sys.exit(1)
    if search == "--help" or search == "-h":
        usage()
        sys.exit(0)
    try:
        label = sys.argv[2]
    except IndexError:
        label = ""
    texfile = file(search + ".tex", 'w')
    texfile.write(TEX_HEADER % label + "\n")
    for item in get_agenda_items(search):
        texfile.write(TEX_ITEM %
                      item.headline.replace('&', r'\&') + "\n" )
    texfile.write(TEX_FOOTER)
    texfile.close()
    call(['pdflatex', texfile.name], stdout=PIPE, stderr=PIPE)
    os.unlink(texfile.name)
    os.unlink(search + ".aux")
    os.unlink(search + ".log")


if __name__ == '__main__':
    main()

[-- Attachment #3: Type: text/plain, Size: 316 bytes --]



-- 
+-----------------------------------------------------------+
| Jason F. McBrayer                    jmcbray@carcosa.net  |
| If someone conquers a thousand times a thousand others in |
| battle, and someone else conquers himself, the latter one |
| is the greatest of all conquerors.  --- The Dhammapada    |

[-- Attachment #4: Type: text/plain, Size: 149 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[relevance 4%]

* Re: Specifying style sheets for HTML Export. ... error in documentation
  2006-12-09  0:16  8% Specifying style sheets for HTML Export. ... error in documentation Charles Cave
@ 2006-12-12  7:19  0% ` Carsten Dominik
  0 siblings, 0 replies; 59+ results
From: Carsten Dominik @ 2006-12-12  7:19 UTC (permalink / raw)
  To: Charles Cave; +Cc: emacs-orgmode

This is an issue between Emacs 21 and Emacs 22, and was discussed
on this group before.  I'll make a footnote in the documentation.

- Carsten

On Dec 9, 2006, at 1:16, Charles Cave wrote:

> On the bottom of page 61 of the Org Mode 4.57 manual
> there is an example of including a style sheet for
> HTML export.
>
> Each of the lines is prefixed with # but I found it
> is necessary to remove these for the style sheet to
> work. The documentation needs to be corrected!
>
> My style sheet section looks like this:
>
>
> * COMMENT HTML style specifications
>
> # Local Variables:
> # org-export-html-style: " <style type=\"text/css\">
>  html {
>      font-family: Verdana, Times, serif;
>      font-size: 10pt;
>      margin-left: 20pt;
>      margin-right: 50pt;
>    }
>  pre {
>        border: 1pt solid #AEBDCC;
>        background-color: #F3F5F7;
>        padding: 5pt;
>        font-family: courier, monospace;
>       font-size: 10pt;
>       margin-left: 45pt;
>       margin-right: 45pt;
>    }
>  p,li {
>      margin-left: 1.5 cm;
>      margin-right: 1.5 cm;
>     }
>  .author, .date {
>       font-size: 8pt;
>       margin-left: 0pt;
>     }
>    h1 {color: darkblue;
>        margin-top: 3.0 cm;
>       }
>
>   </style>"
> # End:
>
>
>
> Charles
>
>
> _______________________________________________
> Emacs-orgmode mailing list
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
>
>

--
Carsten Dominik
Sterrenkundig Instituut "Anton Pannekoek"
Universiteit van Amsterdam
Kruislaan 403
NL-1098SJ Amsterdam
phone: +31 20 525 7477

^ permalink raw reply	[relevance 0%]

* Specifying style sheets for HTML Export. ... error in documentation
@ 2006-12-09  0:16  8% Charles Cave
  2006-12-12  7:19  0% ` Carsten Dominik
  0 siblings, 1 reply; 59+ results
From: Charles Cave @ 2006-12-09  0:16 UTC (permalink / raw)
  To: emacs-orgmode

On the bottom of page 61 of the Org Mode 4.57 manual
there is an example of including a style sheet for
HTML export.

Each of the lines is prefixed with # but I found it
is necessary to remove these for the style sheet to
work. The documentation needs to be corrected!

My style sheet section looks like this:


* COMMENT HTML style specifications

# Local Variables:
# org-export-html-style: " <style type=\"text/css\">
  html {
      font-family: Verdana, Times, serif;
      font-size: 10pt;
      margin-left: 20pt;
      margin-right: 50pt;
    }
  pre {
        border: 1pt solid #AEBDCC;
        background-color: #F3F5F7;
        padding: 5pt;
        font-family: courier, monospace;
       font-size: 10pt;
       margin-left: 45pt;
       margin-right: 45pt;
    }
  p,li {
      margin-left: 1.5 cm;
      margin-right: 1.5 cm;
     }
  .author, .date {
       font-size: 8pt;
       margin-left: 0pt;
     }
    h1 {color: darkblue;
        margin-top: 3.0 cm;
       }

   </style>"
# End:



Charles

^ permalink raw reply	[relevance 8%]

Results 201-259 of 259	 | reverse | options above
-- pct% links below jump to the message on this page, permalinks otherwise --
2006-12-09  0:16  8% Specifying style sheets for HTML Export. ... error in documentation Charles Cave
2006-12-12  7:19  0% ` Carsten Dominik
2007-05-21 13:39  4% A little agenda printer script Jason F. McBrayer
2007-05-24 21:45     ` Xavier Maillard
2007-06-03 20:05  6%   ` Jason F. McBrayer
2007-06-03 20:44  4% Updated " Jason F. McBrayer
2008-12-03 22:50     Can drawers be embedded in org-mode? Jing Su
2008-12-04  8:02     ` Carsten Dominik
2008-12-15  7:25       ` Jing Su
2008-12-15  9:25 11%     ` Carsten Dominik
2009-01-08  9:37     Keeping Your Appointments in org Ian Barton
2009-01-08 10:47     ` Daniel Martins
2009-01-08 22:33  0%   ` Shelagh Manton
2009-04-08  1:52     Sectioning in LaTeX export Mark Elston
2009-04-08  2:16     ` Mark Elston
2009-04-08  6:17  2%   ` Manish
2009-06-18 22:02 10% Change line spacing for lists for " Alan E. Davis
2009-06-18 22:18  0% ` Alan E. Davis
2009-06-18 22:19  0%   ` Alan E. Davis
2009-06-18 23:09 10%     ` Alan E. Davis
2009-06-26 15:41  0% ` Carsten Dominik
2009-12-17  0:05  6% Bug: Incorrect escaping of braces on LaTeX export [6.33trans (release_6.33f.122.g7062a.dirty)] Mark Elston
2009-12-17 19:27  0% ` Carsten Dominik
2009-12-17 23:16  0%   ` Mark Elston
2009-12-18  8:08  0%     ` Carsten Dominik
2009-12-18 18:13  0%       ` Mark Elston
2009-12-21  9:48  2% Request for guidance: Export ONLY headlines matching occur search? Alan E. Davis
2010-06-01 13:34     latex-export + columnview: misinterpretation of section prefixes as emphasis Carsten Dominik
2010-06-01 14:52  8% ` tcburt
2010-06-05 23:13     day-agenda: show whole-day-events first Eraldo Helal
2010-06-06  4:24     ` Carsten Dominik
2010-06-06 23:54       ` Daniel Martins
2010-06-07  0:10  0%     ` Nick Dokos
2010-06-23 21:30  6% Tables and environment with parameters Sébastien Vauban
2010-06-24  6:15  0% ` Carsten Dominik
2010-07-08  2:38     org-babel-tangle-lang-exts must be initialized? how to get syntax coloring? Nicholas Putnam
2010-07-08  3:29     ` Eric Schulte
2010-07-08  4:44       ` Nicholas Putnam
2010-07-08  5:41         ` Eric Schulte
2010-07-08 15:45           ` Nicholas Putnam
2010-07-08 18:33             ` Eric Schulte
2010-07-08 20:07  8%           ` Nicholas Putnam
2010-07-08 20:28  0%             ` Eric Schulte
2010-07-12 19:50     footer for latex export Buck Brody
2010-07-12 20:57  7% ` Nick Dokos
2010-07-19 16:41  0%   ` Buck Brody
2010-07-28 19:36     keys and command name info Andreas Röhler
2010-08-02  6:32     ` Carsten Dominik
2010-08-08 22:26       ` Gregor Zattler
2010-08-09  6:43         ` Carsten Dominik
2010-08-09  9:37           ` Andreas Burtzlaff
2010-08-09 10:19             ` Gregor Zattler
2010-08-09 18:32               ` Dan Davison
2010-08-09 19:28                 ` Dan Davison
2010-08-11 10:05                   ` Carsten Dominik
2010-08-13 19:30                     ` Andreas Röhler
2010-08-15  7:37                       ` Carsten Dominik
2010-08-15  7:39                         ` Carsten Dominik
2010-08-15 19:07                           ` Andreas Röhler
2010-08-16  8:57                             ` Carsten Dominik
2010-08-17 12:43                               ` Andreas Röhler
2010-08-18  8:38  6%                             ` Carsten Dominik
2010-08-20  6:27  0%                               ` Andreas Röhler
2010-08-20  7:31  0%                                 ` Carsten Dominik
2010-08-20  8:13  0%                                   ` Andreas Röhler
     [not found]     <moptop99@gmail.com>
2010-09-01 22:59     ` gnash crunch... latex whitespace defaults! + numbering in only some subheadings Matt Price
2010-09-02  5:18 11%   ` Nick Dokos
2010-09-02 15:12  7%     ` [PARTIALLY SOLVED] " Matt Price
2010-09-02 22:24  0%       ` Shelagh Manton
2010-09-03 14:18  5% possible tex export bug? Matt Price
2010-09-03 14:21  2% ` Matt Price
2010-09-03 16:08  5% horiontal alignment of tables in latex export? Matt Price
2010-10-07  4:24     conditional export based on target Ezequiel Birman
2010-10-23 23:46     ` Juan Pechiar
2010-11-02 19:41 10%   ` Ezequiel Birman
2011-03-16 11:04     Professional PDF LaTeX templates? 'Mash
2011-03-16 14:54     ` Nick Dokos
2011-03-17 12:06  6%   ` Russell Adams
2011-04-06  2:02     Using orgmode to take "inline notes" for research John Hendy
2011-04-06  3:21     ` Jeff Horn
2011-04-06 16:33       ` John Hendy
2011-04-07  4:19         ` Jeff Horn
2011-04-07  9:20           ` Sébastien Vauban
2011-04-07 15:26             ` John Hendy
2011-04-07 15:33               ` Jeff Horn
2011-04-07 15:48                 ` John Hendy
2011-04-08 20:53                   ` Sébastien Vauban
2011-04-12 16:30                     ` John Hendy
2011-04-12 18:20                       ` Eric S Fraga
2011-04-17 23:36  8%                     ` Rasmus
2011-04-20 17:46  0%                       ` Eric S Fraga
2011-09-22 13:27  7% Bug: File Links [6.33x] Edward N. Lewis
2011-10-19 15:27     how to do footers Mehul Sanghvi
2011-10-19 15:35 10% ` John Hendy
2011-10-19 15:38  0%   ` Mehul Sanghvi
2011-12-12 23:39     Refresh of http://orgmode.org Bastien
2011-12-13 21:50     ` Viktor Rosenfeld
2011-12-14  1:19       ` Eric Schulte
2011-12-14 10:07         ` Bastien
2011-12-14 18:45           ` Eric Schulte
2011-12-15  4:11  9%         ` Eric Schulte
2012-03-02  4:26  6% spot the LaTeX error Peter Salazar
2012-03-02  4:34  0% ` Peter Salazar
2012-03-02  9:33  0% ` Peter Salazar
2012-05-24 19:49     listings and the new LaTeX exporter Andreas Leha
2012-05-24 20:13     ` Jambunathan K
2012-05-24 20:58  7%   ` Andreas Leha
2012-07-20  0:29  1% Export to Texinfo Jonathan Leech-Pepin
2012-07-20  9:32     ` Nicolas Goaziou
2012-07-20 13:34       ` Jonathan Leech-Pepin
2012-07-20 13:42         ` Nicolas Goaziou
2012-07-31 21:03  1%       ` Jonathan Leech-Pepin
2012-08-02 15:34             ` Bastien
     [not found]               ` <CAHRqSkQTzE-OYmTFs+BRjrER=jgS3=2BE5Yi4A6v8ipaZ1kWQA@mail.gmail.com>
2012-08-02 22:24  1%             ` Fwd: " Jonathan Leech-Pepin
2012-11-13 21:39     org-version.inc missing davidam
2012-11-13 21:43     ` Bastien
2012-11-13 21:59       ` David Arroyo Menéndez
2012-11-13 22:15  1%     ` David Arroyo Menéndez
2013-02-13  7:31  7% latex exporter: different itemize environment Andreas Leha
2013-03-24  6:44     plotting tables Eric Abrahamsen
2013-03-24 17:33     ` John Hendy
2013-03-26  3:09       ` Eric Abrahamsen
2013-03-26 15:19  5%     ` John Hendy
2013-07-11 21:33     Embedded Tikz Picture Julien Cubizolles
2013-07-14 15:35  8% ` Myles English
2013-07-31 12:27     LaTex Adjustments for Org-Export Jeff Rush
2013-07-31 14:01  6% ` Nick Dokos
2013-07-31 16:24  6% ` Nick Dokos
2013-08-04 14:51 10% ` Anthony Lander

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).