emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Reference cannot be resolved without publishing
@ 2015-12-11  7:36 Alan Schmitt
  2015-12-12  9:01 ` Nicolas Goaziou
  0 siblings, 1 reply; 5+ messages in thread
From: Alan Schmitt @ 2015-12-11  7:36 UTC (permalink / raw)
  To: emacs-orgmode

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

Hello,

I have the following files I want to export to html:

common.org:
--8<---------------cut here---------------start------------->8---
#+TITLE: Unison Binaries
#+OPTIONS: toc:nil num:nil
#+HTML_HEAD: <link rel="stylesheet" type="text/css" href="style.css" />

* sidebar
  :PROPERTIES:
  :CUSTOM_ID: sidebar
  :HTML_CONTAINER_CLASS: container-sidebar
  :END:

- [[file:index.org::#OSX][Mac OS X]]
--8<---------------cut here---------------end--------------->8---

index.org (extract)
--8<---------------cut here---------------start------------->8---
#+INCLUDE: "common.org"

* body
  :PROPERTIES:
  :CUSTOM_ID: mainbody
  :HTML_CONTAINER_CLASS: container-mainbody
  :END:

** Unison Binaries

*** Mac OS X
    :PROPERTIES:
    :CUSTOM_ID: OSX
    :END:
--8<---------------cut here---------------end--------------->8---

When I try to export index.org to index.html, I get:

Reference "#OSX" in file "index.org" cannot be resolved without
publishing

What does it mean? And why can't the reference be resolved? Should I not
use CUSTOM_ID for relative links?

Thanks,

Alan


-- 
OpenPGP Key ID : 040D0A3B4ED2E5C7
Athmospheric CO₂ (Updated December 6, 2015, Mauna Loa Obs.): 400.80 ppm

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 472 bytes --]

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Reference cannot be resolved without publishing
  2015-12-11  7:36 Reference cannot be resolved without publishing Alan Schmitt
@ 2015-12-12  9:01 ` Nicolas Goaziou
  2015-12-14 12:01   ` Alan Schmitt
  0 siblings, 1 reply; 5+ messages in thread
From: Nicolas Goaziou @ 2015-12-12  9:01 UTC (permalink / raw)
  To: Alan Schmitt; +Cc: emacs-orgmode

Hello,

Alan Schmitt <alan.schmitt@polytechnique.org> writes:

> I have the following files I want to export to html:
>
> common.org:
> #+TITLE: Unison Binaries
> #+OPTIONS: toc:nil num:nil
> #+HTML_HEAD: <link rel="stylesheet" type="text/css" href="style.css" />
>
> * sidebar
>   :PROPERTIES:
>   :CUSTOM_ID: sidebar
>   :HTML_CONTAINER_CLASS: container-sidebar
>   :END:
>
> - [[file:index.org::#OSX][Mac OS X]]
>
> index.org (extract)
> #+INCLUDE: "common.org"
>
> * body
>   :PROPERTIES:
>   :CUSTOM_ID: mainbody
>   :HTML_CONTAINER_CLASS: container-mainbody
>   :END:
>
> ** Unison Binaries
>
> *** Mac OS X
>     :PROPERTIES:
>     :CUSTOM_ID: OSX
>     :END:
>
> When I try to export index.org to index.html, I get:
>
> Reference "#OSX" in file "index.org" cannot be resolved without
> publishing
>
> What does it mean? And why can't the reference be resolved? Should I not
> use CUSTOM_ID for relative links?

Usually, Org cannot resolve an external link if it doesn't know about
the external file, i.e., if it doesn't publish it.

HTML export is a special case because resolving custom-id links is
trivial (the back-end doesn't alter them). So I guess we can use that to
make it work in this special case, even though it will fail in other
back-ends.

I pushed the change in master. Let me know if it works for you.


Regards,

-- 
Nicolas Goaziou

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Reference cannot be resolved without publishing
  2015-12-12  9:01 ` Nicolas Goaziou
@ 2015-12-14 12:01   ` Alan Schmitt
  2015-12-14 22:53     ` Nicolas Goaziou
  0 siblings, 1 reply; 5+ messages in thread
From: Alan Schmitt @ 2015-12-14 12:01 UTC (permalink / raw)
  To: emacs-orgmode

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

Hello Nicolas,

On 2015-12-12 10:01, Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:

> Hello,
>
> Alan Schmitt <alan.schmitt@polytechnique.org> writes:
>
>> I have the following files I want to export to html:
>>
>> common.org:
>> #+TITLE: Unison Binaries
>> #+OPTIONS: toc:nil num:nil
>> #+HTML_HEAD: <link rel="stylesheet" type="text/css" href="style.css" />
>>
>> * sidebar
>>   :PROPERTIES:
>>   :CUSTOM_ID: sidebar
>>   :HTML_CONTAINER_CLASS: container-sidebar
>>   :END:
>>
>> - [[file:index.org::#OSX][Mac OS X]]
>>
>> index.org (extract)
>> #+INCLUDE: "common.org"
>>
>> * body
>>   :PROPERTIES:
>>   :CUSTOM_ID: mainbody
>>   :HTML_CONTAINER_CLASS: container-mainbody
>>   :END:
>>
>> ** Unison Binaries
>>
>> *** Mac OS X
>>     :PROPERTIES:
>>     :CUSTOM_ID: OSX
>>     :END:
>>
>> When I try to export index.org to index.html, I get:
>>
>> Reference "#OSX" in file "index.org" cannot be resolved without
>> publishing
>>
>> What does it mean? And why can't the reference be resolved? Should I not
>> use CUSTOM_ID for relative links?
>
> Usually, Org cannot resolve an external link if it doesn't know about
> the external file, i.e., if it doesn't publish it.

I see.

> HTML export is a special case because resolving custom-id links is
> trivial (the back-end doesn't alter them). So I guess we can use that to
> make it work in this special case, even though it will fail in other
> back-ends.
>
> I pushed the change in master. Let me know if it works for you.

It almost works: the generated html uses two '#' instead of one:

<li><a href="index.html##OSX">Mac OS X</a></li>

Should I remove the '#' from the link?

Thanks a lot,

Alan

-- 
OpenPGP Key ID : 040D0A3B4ED2E5C7
Athmospheric CO₂ (Updated December 13, 2015, Mauna Loa Obs.): 401.31 ppm

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 472 bytes --]

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Reference cannot be resolved without publishing
  2015-12-14 12:01   ` Alan Schmitt
@ 2015-12-14 22:53     ` Nicolas Goaziou
  2015-12-15 13:35       ` Alan Schmitt
  0 siblings, 1 reply; 5+ messages in thread
From: Nicolas Goaziou @ 2015-12-14 22:53 UTC (permalink / raw)
  To: Alan Schmitt; +Cc: emacs-orgmode

Hello,

Alan Schmitt <alan.schmitt@polytechnique.org> writes:

> It almost works: the generated html uses two '#' instead of one:
>
> <li><a href="index.html##OSX">Mac OS X</a></li>

Fixed. Thank you.

Regards,

-- 
Nicolas Goaziou

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Reference cannot be resolved without publishing
  2015-12-14 22:53     ` Nicolas Goaziou
@ 2015-12-15 13:35       ` Alan Schmitt
  0 siblings, 0 replies; 5+ messages in thread
From: Alan Schmitt @ 2015-12-15 13:35 UTC (permalink / raw)
  To: emacs-orgmode

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

On 2015-12-14 23:53, Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:

> Hello,
>
> Alan Schmitt <alan.schmitt@polytechnique.org> writes:
>
>> It almost works: the generated html uses two '#' instead of one:
>>
>> <li><a href="index.html##OSX">Mac OS X</a></li>
>
> Fixed. Thank you.

It's working great, thanks.

Alan

-- 
OpenPGP Key ID : 040D0A3B4ED2E5C7
Athmospheric CO₂ (Updated December 13, 2015, Mauna Loa Obs.): 401.31 ppm

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 472 bytes --]

^ permalink raw reply	[flat|nested] 5+ messages in thread

end of thread, other threads:[~2015-12-15 13:35 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2015-12-11  7:36 Reference cannot be resolved without publishing Alan Schmitt
2015-12-12  9:01 ` Nicolas Goaziou
2015-12-14 12:01   ` Alan Schmitt
2015-12-14 22:53     ` Nicolas Goaziou
2015-12-15 13:35       ` Alan Schmitt

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).