Earl Chase <[email protected]> writes: > ... When I looked into `org-html-link-home' and > `org-html-link-use-abs-url' as options for verbatim link export for > ox-html and ox-md, I saw that verbatim link export had already been > implemented for ox-publish. For ox-publish, if `org-html-link-home' > and `org-html-link-use-abs-url' are set then any files URIs that > resolve to your project's base-directory will be converted to relative > URIs and then the value of `org-html-link-home' will be appended to > these URIs. So, I thought that the easiest way to implement verbatim > link export. But there was one issue. > ... > In summary, `org-html-export-directory' allows you to set the > base-directory key of `org-publish-project-alist' even when you are > not publishing. But if you forgot or choose to not set that variable, > a valid link will still be exported even when you have set > `org-html-link-use-abs-url' and `org-html-link-home' to non-nil > values.
The idea looks reasonable in general. However, I think that the :base-directory should take precedence over the new customization. Consider someone who wants to export the same Org file to multiple websites. That would make more sense to use :base-directory, even if the proposed `org-html-export-directory' is set. > +*** New custom variable ~ox-html-export-directory~ *org-html-export-directory Also, org-html-export-directory name is a bit confusing. One may think that it is setting where the current Org file should be exported to. > +This option, nil by default, allows you to set the directory > +of the project that you intend to export. This variable is the > +equivalent of the ~:base-directory~ key of ~org-publish-project-alist~. > +It is intended for people who use ox-html simply for exporting as > +opposed to publishing. When used in conjunction with ~org-html-link-home~ > +and ~org-html-link-use-abs-url~, file links to files in your export directory > +will have the value of ~org-html-link-home~ appended to them. *prepended -- Ihor Radchenko // yantar92, Org mode maintainer, Learn more about Org mode at <https://orgmode.org/>. Support Org development at <https://liberapay.com/org-mode>, or support my work at <https://liberapay.com/yantar92>
