Org-mode latex pdf export issue: Underlined lines not breaking properly

Org-mode latex pdf export issue: Underlined lines not breaking properly

[Sanjib Sikder]

[-- Attachment #1: Type: text/plain, Size: 293 bytes --]

Hi,

While PDF exporting a .org file, the underlined lines which are at the
right end of the page (in PDF) or underlined lines which are large and
spans to next line (in pdf) are not breaking properly.

How do I solve this problem ?

Thanks.
-----------------------------
*Sanjib Sikder
**

*

[-- Attachment #2: Type: text/html, Size: 512 bytes --]

Re: Org-mode latex pdf export issue: Underlined lines not breaking properly

[Suvayu Ali]

Hello Sanjib,

On Wed, Mar 06, 2013 at 05:07:44PM +0530, Sanjib Sikder wrote:
> Hi,
> 
> While PDF exporting a .org file, the underlined lines which are at the
> right end of the page (in PDF) or underlined lines which are large and
> spans to next line (in pdf) are not breaking properly.
> 
> How do I solve this problem ?

When asking questions, please include complete information.  In this
case, the corresponding lines in the org file and the exported tex file
would be helpful.  If you are using any non-standard LaTeX package for
underlining, you should include that information too.

That said, I have a feeling this is a LaTeX issue, not Org.  So
dedicated LaTeX forum/list might be more appropriate for your questions.

Cheers,

-- 
Suvayu

Open source is the future. It sets us free.

Re: Org-mode latex pdf export issue: Underlined lines not breaking properly

[Sanjib Sikder]

[-- Attachment #1.1: Type: text/plain, Size: 617 bytes --]

Hi Suvayu,

 > In this case, the corresponding lines in the org file and the exported
tex file would be helpful.

Please find two sets of files, one set named 'test' and the other set
'test1', attached herewith this email. In 'test' files, no preambles has
been used (only texts) and in 'test1' files few packages and other details
are there.

In the .org files, few lines have been underlined using underscore and the
files have been pdf exported.

If you feel that the problem is not related to org-mode, then ignore this
email and thanks for your time and patience.

-----------------------------
*Sanjib Sikder
*

[-- Attachment #1.2: Type: text/html, Size: 813 bytes --]

[-- Attachment #2: test.pdf --]
[-- Type: application/pdf, Size: 52240 bytes --]

[-- Attachment #3: test.tex --]
[-- Type: application/x-tex, Size: 2507 bytes --]

[-- Attachment #4: test.org --]
[-- Type: application/octet-stream, Size: 1825 bytes --]

This line is just for testing purpose to show that while trying to pdf export from orgmode, _the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the_ underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. _This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are_ not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. 

[-- Attachment #5: test1.pdf --]
[-- Type: application/pdf, Size: 21357 bytes --]

[-- Attachment #6: test1.tex --]
[-- Type: application/x-tex, Size: 2742 bytes --]

[-- Attachment #7: test1.org --]
[-- Type: application/octet-stream, Size: 2511 bytes --]

#+OPTIONS:    H:3 num:nil toc:t \n:nil @:t ::t |:t ^:t -:t f:t *:t TeX:t LaTeX:t skip:nil d:(HIDE) tags:not-in-toc
#+STARTUP:    align fold nodlcheck hidestars oddeven lognotestate
#+STARTUP: indent
#+LaTeX_CLASS: article
#+LaTeX_CLASS_OPTIONS: [article, 11pt]
#+LATEX_HEADER: \usepackage{natbib,amsmath}
#+LATEX_HEADER: \usepackage[doublespacing]{setspace}
#+LATEX_HEADER: \usepackage[nocites, norefs]{refcheck}
#+LATEX_HEADER: \usepackage[intoc]{nomencl}
#+LATEX_HEADER: \usepackage[top=1.0in, bottom=1in, left=1in, right=1in]{geometry}%for margins
#+LATEX_HEADER: \usepackage{float,subfig,pdflscape, booktabs,placeins} 
#+LATEX_HEADER: \hypersetup{colorlinks=true}
#+TITLE:
#+DATE:

This line is just for testing purpose to show that while trying to pdf export from orgmode, _the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the_ underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. _This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are_ not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. This line is just for testing purpose to show that while trying to pdf export from orgmode, the underlined lines are not breaking properly. 

Re: Org-mode latex pdf export issue: Underlined lines not breaking properly

[Michael Strey]

Hi Sanjib,

This is a known LaTeX issue that has nothing to do with Org.  Please
check the LaTeX packages ulem.sty and soul.sty or simply don't use
underlining -- it's anyway ugly.

Best regards
-- 
Michael Strey 
www.strey.biz

Re: Org-mode latex pdf export issue: Underlined lines not breaking properly

[Suvayu Ali]

Hello Sanjib,

On Wed, Mar 06, 2013 at 06:55:36PM +0530, Sanjib Sikder wrote:
> 
> If you feel that the problem is not related to org-mode, then ignore this
> email and thanks for your time and patience.

It is indeed a LaTeX issue!  And I have an answer too :).  Org mode
translates _underlined text_ to \underline{underlined text}, however if
you read the TeX.sx question referenced below you will see that it
doesn't support line breaks and the TeX community recommends \uline{..}
from the ulem package.

  <http://TeX.stackexchange.com/a/13382/4416>

For now you can write a filter to alter the LaTeX source[1]; for the
long haul you should start a separate thread asking to change the
defaults in Org mode.  However I'm not sure if that is desirable since
it introduces an extra LaTeX package dependency to handle corner cases.

Hope this helps,


Footnotes:

[1] A nice example can be found here:
    <http://orgmode.org/worg/exporters/beamer/ox-beamer.html#sec-2-3>

-- 
Suvayu

Open source is the future. It sets us free.

Re: Org-mode latex pdf export issue: Underlined lines not breaking properly

[Sanjib Sikder]

[-- Attachment #1: Type: text/plain, Size: 490 bytes --]

Hi,

Thanks for the suggestions.

For an user like me, who depends heavily on org-mode for several purposes,
a basic feature like this (underline) is frequently used. Though it is ugly
or (may be) not used for serious published materials, but for personal
usage, this is very handy and very often I do pdf export my .org files.

I wish, org-mode provides an easier solution as not everybody is familiar
with lisp codes.

Again, thanks a lot.

-----------------------------
*Sanjib Sikder
*

[-- Attachment #2: Type: text/html, Size: 699 bytes --]

Re: Org-mode latex pdf export issue: Underlined lines not breaking properly

[Nathaniel Cunningham]

Suvayu Ali <fatkasuvayu+linux <at> gmail.com> writes:

> 
> Org mode
> translates _underlined text_ to \underline{underlined text}, however if
> you read the TeX.sx question referenced below you will see that it
> doesn't support line breaks and the TeX community recommends \uline{..}
> from the ulem package.
> 
>   <http://TeX.stackexchange.com/a/13382/4416>

The \ul{..} command from the soul package also supports underlining across
line breaks.
*And soul is included by default in org's list of loaded latex packages* -- see
org-latex-default-packages-alist.

Therefore it would be painless for org users if \underline in
org-latex-text-markup-alist were replaced with \ul -- and it would provide
more complete support of underlining!  

Thanks,
Nathaniel

Re: Org-mode latex pdf export issue: Underlined lines not breaking properly

[Nicolas Goaziou]

Hello,

Nathaniel Cunningham <nathaniel.cunningham@gmail.com> writes:

> Suvayu Ali <fatkasuvayu+linux <at> gmail.com> writes:
>
>> 
>> Org mode
>> translates _underlined text_ to \underline{underlined text}, however if
>> you read the TeX.sx question referenced below you will see that it
>> doesn't support line breaks and the TeX community recommends \uline{..}
>> from the ulem package.
>> 
>>   <http://TeX.stackexchange.com/a/13382/4416>
>
> The \ul{..} command from the soul package also supports underlining across
> line breaks.
> *And soul is included by default in org's list of loaded latex packages* -- see
> org-latex-default-packages-alist.
>
> Therefore it would be painless for org users if \underline in
> org-latex-text-markup-alist were replaced with \ul -- and it would provide
> more complete support of underlining!  

Indeed. According to

  http://orgmode.org/worg/org-dependencies.html

introducing "soul" package in default packages list was meant to provide
underline and strike-through features. I fixed it in maint.

Thanks for the heads up.


Regards,

-- 
Nicolas Goaziou

Re: Org-mode latex pdf export issue: Underlined lines not breaking properly

[Feng Shu]

Nicolas Goaziou <n.goaziou@gmail.com> writes:

> Hello,
>
> Nathaniel Cunningham <nathaniel.cunningham@gmail.com> writes:
>
>> Suvayu Ali <fatkasuvayu+linux <at> gmail.com> writes:
>>
>>> 
>>> Org mode
>>> translates _underlined text_ to \underline{underlined text}, however if
>>> you read the TeX.sx question referenced below you will see that it
>>> doesn't support line breaks and the TeX community recommends \uline{..}
>>> from the ulem package.
>>> 
>>>   <http://TeX.stackexchange.com/a/13382/4416>>
>> The \ul{..} command from the soul package also supports underlining across
>> line breaks.
>> *And soul is included by default in org's list of loaded latex packages* -- see
>> org-latex-default-packages-alist.
>>
>> Therefore it would be painless for org users if \underline in
>> org-latex-text-markup-alist were replaced with \ul -- and it would provide
>> more complete support of underlining!  
>
> Indeed. According to
>
>   http://orgmode.org/worg/org-dependencies.html
>
> introducing "soul" package in default packages list was meant to provide
> underline and strike-through features. I fixed it in maint.
>
> Thanks for the heads up.

When the article is writen with Chinese,  soul will output:

#+begin_src
soul Error: Reconstruction failed.
#+end_src

and underline word will dispear from  the output pdf file!

A tmp solution is :


\ul{\mbox{中文测试}}

but，when it can't break lines properly too.

>
>
> Regards,

-- 

Re: Org-mode latex pdf export issue: Underlined lines not breaking properly

[Nicolas Goaziou]

Hello,

Feng Shu <tumashu@gmail.com> writes:

> When the article is writen with Chinese,  soul will output:
>
> #+begin_src
> soul Error: Reconstruction failed.
> #+end_src
>
> and underline word will dispear from  the output pdf file!
>
> A tmp solution is :
>
>
> \ul{\mbox{中文测试}}
>
> but，when it can't break lines properly too.

  1. Does \underline{中文测试} work properly (notwithstanding the line
     breaks)?
  2. Does \uline from "ulem" package handle it correctly, including the
     line breaks?


Regards,

-- 
Nicolas Goaziou

Re: Org-mode latex pdf export issue: Underlined lines not breaking properly

[Feng Shu]

Nicolas Goaziou <n.goaziou@gmail.com> writes:

> Hello,
>
> Feng Shu <tumashu@gmail.com> writes:
>
>> When the article is writen with Chinese,  soul will output:
>>
>> #+begin_src
>> soul Error: Reconstruction failed.
>> #+end_src
>>
>> and underline word will dispear from  the output pdf file!
>>
>> A tmp solution is :
>>
>>
>> \ul{\mbox{中文测试}}
>>
>> but，when it can't break lines properly too.
>
>   1. Does \underline{中文测试} work properly (notwithstanding the line
>      breaks)?

\underline can show chinese, but the command can't resolve lines
breaking properly.

>   2. Does \uline from "ulem" package handle it correctly, including the
>      line breaks?

\uline seem to work properly.


>
>
> Regards,

-- 

Re: Org-mode latex pdf export issue: Underlined lines not breaking properly

[Nicolas Goaziou]

Feng Shu <tumashu@gmail.com> writes:

> Nicolas Goaziou <n.goaziou@gmail.com> writes:
>>   1. Does \underline{中文测试} work properly (notwithstanding the line
>>      breaks)?
>
> \underline can show chinese, but the command can't resolve lines
> breaking properly.
>
>>   2. Does \uline from "ulem" package handle it correctly, including the
>>      line breaks?
>
> \uline seem to work properly.

Then, the best solution seems to add "ulem" package to
`org-latex-default-packages-alist' and use \ulem for underline. "soul"
will only be used for strike-through.

Is there any objection to this change?


Regards,

-- 
Nicolas Goaziou

Re: Org-mode latex pdf export issue: Underlined lines not breaking properly

[Feng Shu]

Nicolas Goaziou <n.goaziou@gmail.com> writes:

> Feng Shu <tumashu@gmail.com> writes:
>
>> Nicolas Goaziou <n.goaziou@gmail.com> writes:
>>>   1. Does \underline{中文测试} work properly (notwithstanding the line
>>>      breaks)?
>>
>> \underline can show chinese, but the command can't resolve lines
>> breaking properly.
>>
>>>   2. Does \uline from "ulem" package handle it correctly, including the
>>>      line breaks?
>>
>> \uline seem to work properly.
>
> Then, the best solution seems to add "ulem" package to
> `org-latex-default-packages-alist' and use \ulem for underline. "soul"
> will only be used for strike-through.
>
> Is there any objection to this change?

May be \ulem should be used for strike-through too! 

>
>
> Regards,

-- 

Re: Org-mode latex pdf export issue: Underlined lines not breaking properly

[Nicolas Goaziou]

Hello,

Feng Shu <tumashu@gmail.com> writes:

> Nicolas Goaziou <n.goaziou@gmail.com> writes:
>
>> Feng Shu <tumashu@gmail.com> writes:
>>
>>> Nicolas Goaziou <n.goaziou@gmail.com> writes:
>>>>   1. Does \underline{中文测试} work properly (notwithstanding the line
>>>>      breaks)?
>>>
>>> \underline can show chinese, but the command can't resolve lines
>>> breaking properly.
>>>
>>>>   2. Does \uline from "ulem" package handle it correctly, including the
>>>>      line breaks?
>>>
>>> \uline seem to work properly.
>>
>> Then, the best solution seems to add "ulem" package to
>> `org-latex-default-packages-alist' and use \ulem for underline. "soul"
>> will only be used for strike-through.
>>
>> Is there any objection to this change?
>
> May be \ulem should be used for strike-through too!

Done.


Regards,

-- 
Nicolas Goaziou

Re: Org-mode latex pdf export issue: Underlined lines not breaking properly

[Gustavo Barros]

Hi all,

On Fri, Jun 14 2013, Nicolas Goaziou wrote:

>>>> Nicolas Goaziou <n.goaziou@gmail.com> writes:
>>>>>   1. Does \underline{中文测试} work properly (notwithstanding the line
>>>>>      breaks)?
>>>>
>>>> \underline can show chinese, but the command can't resolve lines
>>>> breaking properly.
>>>>
>>>>>   2. Does \uline from "ulem" package handle it correctly, including the
>>>>>      line breaks?
>>>>
>>>> \uline seem to work properly.
>>>
>>> Then, the best solution seems to add "ulem" package to
>>> `org-latex-default-packages-alist' and use \ulem for underline. "soul"
>>> will only be used for strike-through.
>>>
>>> Is there any objection to this change?
>>
>> May be \ulem should be used for strike-through too!
>
> Done.
>

I know this is a very old thread, and that perhaps this boat has sailed
definitely.

But it seems to me that the attempt to use soul back then eventually
backfired because soul does not handle utf8 properly, as Feng Shu’s
issue demonstrated.  Indeed it does not.  But there is a patch to soul,
by Heiko Oberdiek, to handle this precise issue, and it is the package
soulutf8.

I’ve checked the commit history around the time of this thread, and it
seems soul, rather than soulutf8, was the attempt
(https://code.orgmode.org/bzg/org-mode/commit/95eeefa9bca1b6c57fe62c248a0a35302cd7374d).

Neither soul nor ulem is very active nowadays, but are used quite
extensively, as far as I know (from following TeX.SX).  And both have
their limitations.  But the ability to have line breaks is a clear edge
of soul, and the reason of the original request which started this
thread.

So, if the only reason to prefer ulem back in 2013 was utf8 support,
perhaps soulutf8 might be worthy of your reconsideration.


Best regards,
Gustavo Barros.

Re: Org-mode latex pdf export issue: Underlined lines not breaking properly

[Gustavo Barros]

On Mon, Jul 29 2019, Gustavo Barros wrote:

>
> But the ability to have line breaks is a clear edge
> of soul, and the reason of the original request which started this
> thread.
>

I must correct myself, the difference between ulem and soul is not that 
one allows line breaks while the other does not.  More precisely, both 
handle line breaks, but soul is able to honor hyphenation patterns, 
while ulem is not.  If one wants a (underlined/stricken-through) word to 
break with ulem, the hyphenation has to be done manually.

Best,
Gustavo.