Reference cannot be resolved without publishing

Reference cannot be resolved without publishing

[Alan Schmitt]

[-- 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 --]

Re: Reference cannot be resolved without publishing

[Nicolas Goaziou]

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

Re: Reference cannot be resolved without publishing

[Alan Schmitt]

[-- 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 --]

Re: Reference cannot be resolved without publishing

[Nicolas Goaziou]

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

Re: Reference cannot be resolved without publishing

[Alan Schmitt]

[-- 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 --]