Re: [PATCH] Improve configurability of ox-koma-letter

[Viktor Rosenfeld <listuser36@gmail.com>]

Hi Rasmus,

Rasmus wrote:

>    "Optionally download an up-to-date KOMA letter exporter"
> Is this something we want to encourage people to do?

We probably shouldn't. The problem is that the tutorial depends on
a version that has not yet been released. Once Org-mode 8.1 arrives the
best thing to do is to only refer to released functionality. Until then,
I've changed the text somewhat and put a bold *Note* in front of it.
 
> I think that 
> 
>    "1. Add the path containing ox-koma-letter.el to Emacs' load path...."
> 
> is so common that it need not be included.  If anything it should link
> to another wiki page explaining how to add stuff to the load path as
> to not add a step that (what I'd guess) a high percentage of the
> readers would know.  

I'd rather have the minimal guide to be complete so newbies do not have
to go hunting for information.

>   "download the KOMA letter example and you can also download the
>    example PDF letter."
> 
> Links aren't working here.

Somehow the source of the Org file isn't served by the webserver and
neither is the PDF I've checked in. Not really sure what the problem is,
maybe it has something to do with the change in the exporter.

>    "Letter meta data can be configured in one of three ways, listed
>    below from the most specific to the most general:"
> 
> 4. through org-latex-classes (e.g. defining my-business-letter and
>    my-love-letter).  But perhaps this is considered bad practice?

I haven't thought about this at all. It's somewhat orthogonal to the
other configuration options. I've trimmed the latex class definition
down because configuration options which are set there are fairly fixed.
But it's a valid approach. I've added some text to this effect.

>    "Custom LCO files must be placed in a directory where LaTeX will
>    find them. On Linux, this defaults to ~/texmf/tex/latex. On OS X,
>    use ~/Library/texmf/tex/latex instead. These paths can be
>    configured using the following command:"
> 
> Mayhaps one could add:
> 
>    In TeXLive you can test whether foo.lco is recognized by TeXLive by
>    typing =kpsewhich foo.lco=.  After adding a file to the TeXLive
>    path you may have to run =mktexlsr=.

Thanks, I've added that.

Cheers,
Viktor

> 
> –Rasmus
> 
> -- 
> This is the kind of tedious nonsense up with which I will not put
>