> 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.
Yeah, I was unsure what to name this variable. Should I just go with `org-html-base-directory'? I thought that could be confusing as well, but I think the docstring and news entry that I have written make the difference between `org-html-base-directory' and `:base-directory' clear. Le sam. 18 juil. 2026 à 04:32, Ihor Radchenko <[email protected]> a écrit : > > 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>
