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 ,* Acknowledgments [[mailto:mywife@example.com][my wife]] ,* Chapter one Fa la la ls ,* Chapter two La di di ,* Finally, here is a table of contents! ,#+TOC: #+END_SRC ---------------------------------------------- ....Then exporting to html gives me a webpage with what I think are still a few issues: * I would expect the 2nd line not to display as an emacs link text. I am trying to display the contents of the emacs buffer. * There is not table of contents. As in this screen shot. Thanks for you TIPS! > -----Original Message----- > From: Charles C. Berry [mailto:ccberry@ucsd.edu] > Sent: Wednesday, August 03, 2016 9:16 PM > To: Cook, Malcolm > Cc: 'emacs-orgmode@gnu.org' > Subject: Re: seeking good practices for writing about org using org > > On Wed, 3 Aug 2016, Cook, Malcolm wrote: > > > Hi, > > > > I am seeking good practices for writing about org using , erhm, well, > > org itself. (doh!) > > > > I'd use these practices, for example, when writing examples of using > > org, or lessons in using org, or bug reports about org. > > > > I reached of ob-org thinking this is what it was for, and wrote the > > following > > > > --------------------------------------- (beginning of example) > > Here is simple org book structure with chapters and a table of > > contents at the end: > > > > #+BEGIN_SRC org :exports both :results value > > > > * chapter one > > > > Fa la la > > > > * chapter two > > > > La di di > > > > * table of contents > > > > #+TOC: > > > > #+END_SRC > > --------------------------------------- (end of example) > > > > My dashed expectations were that when executed and exported, this > would > > produce a block of the org source, appropriately quoted, followed be the > > RESULTS, being, well, the rendered org. > > > > Are your expectations the same as mine? > > > > No. Run `M-x org-lint RET' and you will see that this is malformed. The > org code needs to be escaped. > > > What do YOU do in such cases? > > Edit the src block in an edit buffer. You'll need to kill the contents of > that src block first, then C-c ' to open the src edit buffer, then yank, then C-c > ' > again. The resulting buffer will be properly escaped. > > See (info "(org) Literal examples"), especially footnote 4. > > -- > > Then specify `:results replace' to override `:results silent' which > `org-babel-default-header-args:org' sets. > > -- > > Then the export should be what you expect. > > HTH, > > Chuck