* Babel language "org"? @ 2015-04-04 15:41 Lawrence Bottorff 2015-04-04 15:47 ` Ken Mankoff 0 siblings, 1 reply; 3+ messages in thread From: Lawrence Bottorff @ 2015-04-04 15:41 UTC (permalink / raw) To: emacs-orgmode [-- Attachment #1: Type: text/plain, Size: 993 bytes --] I'm taking a closer look at Eric Neilsen's "Emacs org-mode examples and cookbook," specifically the org file Eric sent me. And right off the bat I see something interesting: ** General metadata An initial group sets the metadata used in any title pages, headers, footers, etc. used by the various exporters: #+NAME: orgmode-header-metadata #+BEGIN_SRC org #+TITLE: Emacs org-mode examples #+AUTHOR: Eric H. Neilsen, Jr. #+EMAIL: neilsen@fnal.gov #+END_SRC . . . which shows up in the final html version as just #+TITLE: Emacs org-mode examples #+AUTHOR: Eric H. Neilsen, Jr. #+EMAIL: neilsen@fnal.gov Why did he use what looks like babel source formatting? What is gained from having org "code" as literate programming? Any docs talking specifically about this, best practices? My first guess is he's just using this as an org-to-html formatting convention, but, again, how much of "org code" (whatever we call "org code") can I put in babel source containers? LB [-- Attachment #2: Type: text/html, Size: 1431 bytes --] ^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: Babel language "org"? 2015-04-04 15:41 Babel language "org"? Lawrence Bottorff @ 2015-04-04 15:47 ` Ken Mankoff 2015-04-04 16:40 ` Lawrence Bottorff 0 siblings, 1 reply; 3+ messages in thread From: Ken Mankoff @ 2015-04-04 15:47 UTC (permalink / raw) To: Lawrence Bottorff; +Cc: emacs-orgmode If it weren't wrapped, it would be exported and not show up in the document text. -k. On 2015-04-04 at 11:41, Lawrence Bottorff <borgauf@gmail.com> wrote: > I'm taking a closer look at Eric Neilsen's "Emacs org-mode examples and > cookbook," specifically the org file Eric sent me. And right off the bat I > see something interesting: > > ** General metadata > > An initial group sets the metadata used in any title pages, headers, > footers, etc. used by the various exporters: > > #+NAME: orgmode-header-metadata > #+BEGIN_SRC org > #+TITLE: Emacs org-mode examples > #+AUTHOR: Eric H. Neilsen, Jr. > #+EMAIL: neilsen@fnal.gov > #+END_SRC > > . . . which shows up in the final html version as just > > #+TITLE: Emacs org-mode examples > #+AUTHOR: Eric H. Neilsen, Jr. > #+EMAIL: neilsen@fnal.gov > > Why did he use what looks like babel source formatting? What is gained from > having org "code" as literate programming? Any docs talking specifically > about this, best practices? My first guess is he's just using this as an > org-to-html formatting convention, but, again, how much of "org code" > (whatever we call "org code") can I put in babel source containers? > > LB ^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: Babel language "org"? 2015-04-04 15:47 ` Ken Mankoff @ 2015-04-04 16:40 ` Lawrence Bottorff 0 siblings, 0 replies; 3+ messages in thread From: Lawrence Bottorff @ 2015-04-04 16:40 UTC (permalink / raw) To: emacs-orgmode [-- Attachment #1: Type: text/plain, Size: 2270 bytes --] Yes, it's being used as a sort of escape backslash, sort of like when you do \" to have the quotation mark actually show up, or like the <pre> tag in html. That's what I thought at first too, i.e., so the #+TITLE: etc. won't be taken literally by org-mode. But I guess I meant to ask, Is this orgmode's "official escape backslash" mechanism? What about #+BEGIN_EXAMPLE ... #+END_EXAMPLE or #+BEGIN_QUOTE ... #+END_QUOTE? It seems like putting org-mode "code" inside of babel code wrapper would be something about writing a(n eventual) second, "external" org file while still the first org file. Or, simpler, I might create a library, i.e., an org file with useful org-mode templates etc. and have them accessible a la "linked data," the unique key being the #+NAME: field. But again, I'm very curious, what exactly is babel's relationship to "org code"? What qualifies as "org code," as far as babel is concerned? On Sat, Apr 4, 2015 at 11:47 AM, Ken Mankoff <mankoff@gmail.com> wrote: > > If it weren't wrapped, it would be exported and not show up in the > document text. > > -k. > > On 2015-04-04 at 11:41, Lawrence Bottorff <borgauf@gmail.com> wrote: > > I'm taking a closer look at Eric Neilsen's "Emacs org-mode examples and > > cookbook," specifically the org file Eric sent me. And right off the bat > I > > see something interesting: > > > > ** General metadata > > > > An initial group sets the metadata used in any title pages, headers, > > footers, etc. used by the various exporters: > > > > #+NAME: orgmode-header-metadata > > #+BEGIN_SRC org > > #+TITLE: Emacs org-mode examples > > #+AUTHOR: Eric H. Neilsen, Jr. > > #+EMAIL: neilsen@fnal.gov > > #+END_SRC > > > > . . . which shows up in the final html version as just > > > > #+TITLE: Emacs org-mode examples > > #+AUTHOR: Eric H. Neilsen, Jr. > > #+EMAIL: neilsen@fnal.gov > > > > Why did he use what looks like babel source formatting? What is gained > from > > having org "code" as literate programming? Any docs talking specifically > > about this, best practices? My first guess is he's just using this as an > > org-to-html formatting convention, but, again, how much of "org code" > > (whatever we call "org code") can I put in babel source containers? > > > > LB > > [-- Attachment #2: Type: text/html, Size: 3187 bytes --] ^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2015-04-04 16:40 UTC | newest] Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2015-04-04 15:41 Babel language "org"? Lawrence Bottorff 2015-04-04 15:47 ` Ken Mankoff 2015-04-04 16:40 ` Lawrence Bottorff
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).