emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Thorsten Jolitz <tjolitz@gmail.com>
To: emacs-orgmode@gnu.org
Subject: Re: Org equivalent to \chapter*
Date: Wed, 06 Aug 2014 03:11:01 +0200	[thread overview]
Message-ID: <87lhr2v2vu.fsf@gmail.com> (raw)
In-Reply-To: 53E172B1.5020101@gmail.com

Alan L Tyree <alantyree@gmail.com> writes:

> I'm sure this has been asked before, but I can't seem to find it. Is
> there an org markup that produces a starred latex heading?
>
> In a book, for example, I want the Preface to be at chapter level, but
> not included in the numbering. Same for HTML export, of course.

,----[ C-h v org-latex-classes RET ]
| org-latex-classes is a variable defined in `ox-latex.el'.
| Its value is shown below.
| 
| Documentation:
| Alist of LaTeX classes and associated header and structure.
| If #+LATEX_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 header string
| -----------------
| 
| The HEADER-STRING is the header that will be inserted into the
| LaTeX file.  It should contain the \documentclass macro, and
| anything else that is needed for this setup.  To this header, the
| following commands will be added:
| 
| - Calls to \usepackage for all packages mentioned in the
|   variables `org-latex-default-packages-alist' and
|   `org-latex-packages-alist'.  Thus, your header definitions
|   should avoid to also request these packages.
| 
| - Lines specified via "#+LATEX_HEADER:" and
|   "#+LATEX_HEADER_EXTRA:" keywords.
| 
| If you need more control about the sequence in which the header
| is built up, or if you want to exclude one of these building
| blocks for a particular class, you can use the following
| macro-like placeholders.
| 
|  [DEFAULT-PACKAGES]      \usepackage statements for default packages
|  [NO-DEFAULT-PACKAGES]   do not include any of the default packages
|  [PACKAGES]              \usepackage statements for packages
|  [NO-PACKAGES]           do not include the packages
|  [EXTRA]                 the stuff from #+LATEX_HEADER(_EXTRA)
|  [NO-EXTRA]              do not include #+LATEX_HEADER(_EXTRA) stuff
| 
| So a header like
| 
|   \documentclass{article}
|   [NO-DEFAULT-PACKAGES]
|   [EXTRA]
|   \providecommand{\alert}[1]{\textbf{#1}}
|   [PACKAGES]
| 
| will omit the default packages, and will include the
| #+LATEX_HEADER and #+LATEX_HEADER_EXTRA lines, then have a call
| to \providecommand, and then place \usepackage commands based
| on the content of `org-latex-packages-alist'.
| 
| If your header, `org-latex-default-packages-alist' or
| `org-latex-packages-alist' inserts "\usepackage[AUTO]{inputenc}",
| AUTO will automatically be replaced with a coding system derived
| from `buffer-file-coding-system'.  See also the variable
| `org-latex-inputenc-alist' for a way to influence this mechanism.
| 
| Likewise, if your header contains "\usepackage[AUTO]{babel}",
| AUTO will be replaced with the language related to the language
| code specified by `org-export-default-language', which see.  Note
| that constructions such as "\usepackage[french,AUTO,english]{babel}"
| are permitted.
| 
| 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 LaTeX 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.
| 
| You can customize this variable.
| 
| Value: (("koma-book" "\\documentclass{scrbook}"
|   ("\\part{%s}" . "\\part*{%s}")
|   ("\\chapter{%s}" . "\\chapter*{%s}")
|   ("\\section{%s}" . "\\section*{%s}")
|   ("\\subsection{%s}" . "\\subsection*{%s}")
|   ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
|   ("\\paragraph{%s}" . "\\paragraph*{%s}")
|   ("\\subparagraph{%s}" . "\\subparagraph*{%s}"))
|  ("koma-article" "\\documentclass{scrartcl}"
|   ("\\section{%s}" . "\\section*{%s}")
|   ("\\subsection{%s}" . "\\subsection*{%s}")
|   ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
|   ("\\paragraph{%s}" . "\\paragraph*{%s}")
|   ("\\subparagraph{%s}" . "\\subparagraph*{%s}"))
|  ("article" "\\documentclass[11pt]{article}"
|   ("\\section{%s}" . "\\section*{%s}")
|   ("\\subsection{%s}" . "\\subsection*{%s}")
|   ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
|   ("\\paragraph{%s}" . "\\paragraph*{%s}")
|   ("\\subparagraph{%s}" . "\\subparagraph*{%s}"))
|  ("report" "\\documentclass[11pt]{report}"
|   ("\\part{%s}" . "\\part*{%s}")
|   ("\\chapter{%s}" . "\\chapter*{%s}")
|   ("\\section{%s}" . "\\section*{%s}")
|   ("\\subsection{%s}" . "\\subsection*{%s}")
|   ("\\subsubsection{%s}" . "\\subsubsection*{%s}"))
|  ("book" "\\documentclass[11pt]{book}"
|   ("\\part{%s}" . "\\part*{%s}")
|   ("\\chapter{%s}" . "\\chapter*{%s}")
|   ("\\section{%s}" . "\\section*{%s}")
|   ("\\subsection{%s}" . "\\subsection*{%s}")
|   ("\\subsubsection{%s}" . "\\subsubsection*{%s}")))
| 
| Original value was 
| (("article" "\\documentclass[11pt]{article}"
|   ("\\section{%s}" . "\\section*{%s}")
|   ("\\subsection{%s}" . "\\subsection*{%s}")
|   ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
|   ("\\paragraph{%s}" . "\\paragraph*{%s}")
|   ("\\subparagraph{%s}" . "\\subparagraph*{%s}"))
|  ("report" "\\documentclass[11pt]{report}"
|   ("\\part{%s}" . "\\part*{%s}")
|   ("\\chapter{%s}" . "\\chapter*{%s}")
|   ("\\section{%s}" . "\\section*{%s}")
|   ("\\subsection{%s}" . "\\subsection*{%s}")
|   ("\\subsubsection{%s}" . "\\subsubsection*{%s}"))
|  ("book" "\\documentclass[11pt]{book}"
|   ("\\part{%s}" . "\\part*{%s}")
|   ("\\chapter{%s}" . "\\chapter*{%s}")
|   ("\\section{%s}" . "\\section*{%s}")
|   ("\\subsection{%s}" . "\\subsection*{%s}")
|   ("\\subsubsection{%s}" . "\\subsubsection*{%s}")))
| 
| [back]
`----

-- 
cheers,
Thorsten

  reply	other threads:[~2014-08-06  1:11 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2014-08-06  0:11 Org equivalent to \chapter* Alan L Tyree
2014-08-06  1:11 ` Thorsten Jolitz [this message]
2014-08-06  2:28   ` Nick Dokos
2014-08-06  8:09     ` Thorsten Jolitz
2014-08-06  9:18 ` Rasmus
2014-08-06 17:15   ` Thomas S. Dye
2014-08-06 17:38     ` Rasmus
2014-08-06 19:52       ` Thomas S. Dye
2014-08-06 22:46         ` Alan L Tyree
2014-08-07 10:05           ` Rasmus
2014-08-07 22:07             ` Alan L Tyree
2014-08-08  8:42               ` Rasmus

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87lhr2v2vu.fsf@gmail.com \
    --to=tjolitz@gmail.com \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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).