Org is exporting to tex an asterisk between "section" and "{"

Org is exporting to tex an asterisk between "section" and "{"

[Eduardo Mercovich]

Hello evoryone.

Troubleshooting a lack of ToC content in a exported PDF from org, I
found this issue.

Please forgive me if it's inaccurate. But I tried searching the web,
some org and latex lists and my local .emacs configuration and didn't
found anything related, so it must be a local issue or it would have
been reported before. 

Starting with a simple org file like this:

--8<---------------cut here---------------start------------->8---
* Section A, level 1
** Section AA, level 2
Some AA text. 
** Section AB, level 2
Some AB text. 
* Section B, level 1
** Section BA, level 2
Some BA text. 
** Section BB, level 2
Some BB text. 
--8<---------------cut here---------------end--------------->8---

and exporting to latex as latex file (C-c C-e l l), gives me:

--8<---------------cut here---------------start------------->8---
\begin{document}

\maketitle
\tableofcontents

\section*{Section A, level 1}
\label{sec:orgheadline3}
\subsection*{Section AA, level 2}
\label{sec:orgheadline1}
Some AA text. 
\subsection*{Section AB, level 2}
\label{sec:orgheadline2}
Some AB text. 
\section*{Section B, level 1}
\label{sec:orgheadline6}
\subsection*{Section BA, level 2}
\label{sec:orgheadline4}
Some BA text. 
\subsection*{Section BB, level 2}
\label{sec:orgheadline5}
Some BB text. 
\end{document}
--8<---------------cut here---------------end--------------->8---

Please note the asterisks between section and it's next {.

In short, Org exports this:
\section*{

instead of this:
\section{

Of course, it breaks the syntax (as I understood it, I'm new to latex)
and messes up the latex to pdf transformation, at least with the 2
classes I tried (standard article and tufte-handout).

I'm running
+ GNU Emacs 24.5.1 compiled on 2015-11-09
+ Org-mode version 8.3.1 (8.3.1-95-g1dbb25-elpaplus @
~/.emacs.d/elpa/org-plus-contrib-20150831/)

I have nothing in my .emacs that sounds related to latex or latex export
except the tufte-latex classes declarations. 

The packages I have enabled are:
+ org-bullets-20140918.1137
+ helm-mu-20151019.944
+ helm-core-20150831.933
+ helm-20151117.2303
+ org-caldav-20150131.152
+ google-maps-20130412.230
+ calfw-20150831.1847
+ calfw-gcal-20120111.200
+ async-20150818.1154
+ table-20140721.2215
+ pdf-tools-20150716.643
+ let-alist-1.0.4
+ mu4e

Does anyone suffered something similar? Is there more information I can
provide to troubleshoot the root of this export issue? 

In every case, thank you very much. :)

Best...


-- 
eduardo mercovich 

 Donde se cruzan tus talentos 
 con las necesidades del mundo, 
 ahí está tu vocación.

Re: Org is exporting to tex an asterisk between "section" and "{"

[Eric S Fraga]

On Friday,  4 Mar 2016 at 16:15, Eduardo Mercovich wrote:
> Hello evoryone.
>
> Troubleshooting a lack of ToC content in a exported PDF from org, I
> found this issue.

Make sure you have

#+options: num:t

set.  Otherwise, sections are unnumbered.  I'm not sure what the default
is.  Maybe you have "num:nil"?
-- 
: Eric S Fraga (0xFFFCF67D), Emacs 25.0.91.1, Org release_8.3.4-626-gb62d55

Re: Org is exporting to tex an asterisk between "section" and "{"

[Eduardo Mercovich]

Hi Eric.

>> Troubleshooting a lack of ToC content in a exported PDF from org, I
>> found this issue. [...]

> Make sure you have
> #+options: num:t
> set.  Otherwise, sections are unnumbered.  I'm not sure what the default
> is.  Maybe you have "num:nil"?

I had nothing in the document, and your suggestion did the trick.
Thank you! :)

However, I can't find this in the documentation... shouldn't something
like this be the default? If not, the ToC and the links are not rendered
or non-functional.

Best.


-- 
eduardo mercovich 

 Donde se cruzan tus talentos 
 con las necesidades del mundo, 
 ahí está tu vocación.

Re: Org is exporting to tex an asterisk between "section" and "{"

[Eric S Fraga]

On Friday,  4 Mar 2016 at 18:26, Eduardo Mercovich wrote:
> Hi Eric.
>
>>> Troubleshooting a lack of ToC content in a exported PDF from org, I
>>> found this issue. [...]
>
>> Make sure you have
>> #+options: num:t
>> set.  Otherwise, sections are unnumbered.  I'm not sure what the default
>> is.  Maybe you have "num:nil"?
>
> I had nothing in the document, and your suggestion did the trick.
> Thank you! :)
>
> However, I can't find this in the documentation... shouldn't something
> like this be the default? If not, the ToC and the links are not rendered
> or non-functional.

It is documented, in [[info:org#Export%20settings][info:org#Export settings]],

,----
| ‘num:’
|      Toggle section-numbers (‘org-export-with-section-numbers’).  It can
|      also be set to a number ‘n’, so only headlines at that level or
|      above will be numbered.  Finally, irrespective of the level of a
|      specific headline, the numbering of it can be disabled by setting
|      the ‘UNNUMBERED’ property to non-‘nil’.  This also affects
|      subheadings.
`----

Easy to miss as it is not LaTeX specific, of course.  It's a general
setting that affects potentially any export engine but is obviously only
relevant to some.

-- 
: Eric S Fraga (0xFFFCF67D), Emacs 25.0.91.1, Org release_8.3.4-626-gb62d55

Re: Org is exporting to tex an asterisk between "section" and "{"

[Eduardo Mercovich]

Dear Eric.

>>>> Troubleshooting a lack of ToC content in a exported PDF from org, I
>>>> found this issue. [...]

>>> Make sure you have
>>> #+options: num:t
>>> set.  Otherwise, sections are unnumbered.  I'm not sure what the default
>>> is.  Maybe you have "num:nil"?

>> I had nothing in the document, and your suggestion did the trick. [...]

>> However, I can't find this in the documentation... shouldn't something
>> like this be the default? If not, the ToC and the links are not rendered
>> or non-functional.

> It is documented, in [[info:org#Export%20settings][info:org#Export
> settings]], [...]
> Easy to miss as it is not LaTeX specific, of course.  It's a general
> setting that affects potentially any export engine but is obviously only
> relevant to some.

Sorry, I was totally unclear...

Being a total newbie I can't say that the resulting syntax is incorrect
(is it?), but at least in the case of latex, *not expressing this
specific option creates a non-functional latex file*. 

Shouldn't the exporter take care of this? Or at least, never export the
asterisk between the "section" and the brace (just in case, "{" since
I'm not an English native speaker).

Sorry if the case is irrelevant, I tried reading before posting but
found nothing to reassure me.

Thanks... :)


-- 
eduardo mercovich 

 Donde se cruzan tus talentos 
 con las necesidades del mundo, 
 ahí está tu vocación.

Re: Org is exporting to tex an asterisk between "section" and "{"

[Eric S Fraga]

On Tuesday,  8 Mar 2016 at 09:30, Eduardo Mercovich wrote:

[...]

> Being a total newbie I can't say that the resulting syntax is incorrect
> (is it?), but at least in the case of latex, *not expressing this
> specific option creates a non-functional latex file*. 
>
> Shouldn't the exporter take care of this? Or at least, never export the
> asterisk between the "section" and the brace (just in case, "{" since
> I'm not an English native speaker).

The * between section and the brace indicates an unnumbered section
heading and is perfectly valid LaTeX syntax for the article class.  I am
not sure why you think the syntax is incorrect.

num:t tells org to export numbered headlines so the * won't be there in
that case.

-- 
: Eric S Fraga (0xFFFCF67D), Emacs 25.0.90.1, Org release_8.3.3-535-g7213aa

Re: Org is exporting to tex an asterisk between "section" and "{"

[Eduardo Mercovich]

Dear Eric.

> [...]
>> Being a total newbie I can't say that the resulting syntax is incorrect
>> (is it?), but at least in the case of latex, *not expressing this
>> specific option creates a non-functional latex file*. [...]

> The * between section and the brace indicates an unnumbered section
> heading and is perfectly valid LaTeX syntax for the article class.  I am
> not sure why you think the syntax is incorrect.

Sorry, I found the references after the mail.

It is exactly as you said, valid. However, and I may be getting
something else incorrectly, pdflatex has problems with those as it works
out of the box (C-c C-e l o in org), since internal links are broken and
the ToC is not generated. 

It seems a special export case and it's documented, just not obvious for
the begginer. 

> num:t tells org to export numbered headlines so the * won't be there in
> that case.

With that option, it works wonderfully. :)))

Thanks a lot...


-- 
eduardo mercovich 

 Donde se cruzan tus talentos 
 con las necesidades del mundo, 
 ahí está tu vocación.

Re: Org is exporting to tex an asterisk between "section" and "{"

[Eric S Fraga]

On Tuesday, 15 Mar 2016 at 13:07, Eduardo Mercovich wrote:

[...]

> It is exactly as you said, valid. However, and I may be getting
> something else incorrectly, pdflatex has problems with those as it works
> out of the box (C-c C-e l o in org), since internal links are broken and
> the ToC is not generated. 

A table of contents cannot be generated if the sections are not
numbered.  This is a LaTeX "feature".  Maybe org should check for
consistency between num: and toc: but every export target is potentially
different.

-- 
: Eric S Fraga (0xFFFCF67D), Emacs 25.0.91.1, Org release_8.3.4-626-gb62d55

Re: Org is exporting to tex an asterisk between "section" and "{"

[Nicolas Goaziou]

Hello,

Eduardo Mercovich <eduardo@mercovich.net> writes:

> Being a total newbie I can't say that the resulting syntax is incorrect
> (is it?), but at least in the case of latex, *not expressing this
> specific option creates a non-functional latex file*. 
>
> Shouldn't the exporter take care of this? Or at least, never export the
> asterisk between the "section" and the brace (just in case, "{" since
> I'm not an English native speaker).

By default, no asterisk is inserted (see
`org-export-with-section-numbers'). Something in your config is doing
it.

Regards,

-- 
Nicolas Goaziou

Re: Org is exporting to tex an asterisk between "section" and "{"

[Eduardo Mercovich]

Dear Nicolas.

>> Being a total newbie I can't say that the resulting syntax is incorrect
>> (is it?), but at least in the case of latex, *not expressing this
>> specific option creates a non-functional latex file*. 

>> Shouldn't the exporter take care of this? Or at least, never export the
>> asterisk between the "section" and the brace (just in case, "{" since
>> I'm not an English native speaker).

> By default, no asterisk is inserted (see
> `org-export-with-section-numbers'). Something in your config is doing
> it.

I still didn't found it, but will keep searching.
I'm sure it's only my newbieness... :)

Thanks a lot.

Best...


-- 
eduardo mercovich 

 Donde se cruzan tus talentos 
 con las necesidades del mundo, 
 ahí está tu vocación.