Not possible to provide custom link text for internal links

msnoigrs / ox-rst

reStructuredText Back-End for Org-Mode Export Engine

116 stars 18 forks source link

Not possible to provide custom link text for internal links #33

Open edgimar opened 7 years ago

edgimar commented 7 years ago

When using a CUSTOM_ID property, if a reference like [[#myid][text to display]] is used, then instead of the exported document having text to display appear for the link, only myid appears. Also, when just [[#myid]] is used, the exported link only displays myid and not the name of the headline possessing this id.

msnoigrs commented 7 years ago

If you can use :ref: role, Please try to set this: (setq org-rst-link-use-ref-role t)

edgimar commented 7 years ago

Aha! I didn't see that -- maybe should be added to README. But I wonder why this isn't the default -- make people do (setq org-rst-link-use-ref-role nil) if they don't want it.

msnoigrs commented 7 years ago

The vanilla docutils doesn't have :ref: role, this role provided by Sphinx. The main target of ox-rst is the vanilla docutils for now. I don't know the future.