Re: [O] seeking good practices for writing about org using org

[Charles C. Berry]

On Wed, 3 Aug 2016, Cook, Malcolm wrote:

> Thanks.  Much closer.  Still some issues.  Mind taking another 
> gander....  (hoping the attached jpeg of the webpage rendered comes 
> through as an attachment)....
>
> If my emacs buffer holds...
> ----------------------------------------------
> #+BEGIN_SRC org :exports both :results value ascii

...............................................^^^^^

what is the `ascii' doing?

Can you provide a link to documentation in the manual or a 
docstring describing its function?

Why don't you have 'replace' in the :results args?

> ,* Acknowledgments

This bit behaves as you might expect in plain text export, markdown, and 
latex export:

>  [[mailto:address@hidden wife]]

but in html it does create `<a href="mailto:...'.

That is because of what `org-babel-exp-code-template' leads 
`org-html-src-block' to do. You might try dropping `%lang' from the 
template, but a better solution is to rewrite `org-html-src-block' and 
create a derived exporter.


> ,* Chapter one
>
> Fa la la ls
>
> ,* Chapter two
>
> La di di
>
> ,* Finally, here is a table of contents!
>
> ,#+TOC:

What does this idiom do?

Precisely, where does the documentation say what

#+TOC:

read as "<hash> <plus> T O C <colon> <newline>"

should create??

---

Re your next post, I suggest spending some time reading

(info "(org) results")

to grasp what the various options actually do. It is probably a good idea 
to execute src blocks to see the RESULTS before you try to export them.

Reading

(info "(org) wrap")

might also help and certainly a quick breeze thru

(info "(org) Specific header arguments")

to remind yourself of what all the possibilities are is something I have 
to do from time to time.

HTH,

Chuck