index for HTML export

index for HTML export

[Fraga, Eric]

Hello all,

I know (well, I believe as I haven't tried yet) I can /publish/ a
project and generate an index using the #+index entries in the org
files.  However, for a single file, is it possible to generate the index
as part of the export process directly (or even separately from the
export process)?  I can do this when I export to LaTeX, for instance.

Thank you,
eric

-- 
: Eric S Fraga, with org release_9.5.4-623-gc66bdb in Emacs 29.0.50

Re: index for HTML export

[Fraga, Eric]

... and following up on this, when trying to /publish/ instead of just
export, I am failing miserably.  I created a simple project definition
but every time I try to publish either a specific file or the project, I
get (with file name partly elided):

--8<---------------cut here---------------start------------->8---
Debugger entered--Lisp error: (wrong-type-argument stringp 101)
expand-file-name(101 "/home/ucecesf/...")
  #f(compiled-function (f) #<bytecode 0x1a85d5a52409b4e8>)(101)
  mapcar(#f(compiled-function (f) #<bytecode 0x1a85d5a52409b4e8>) "export.org")
  #f(compiled-function (p) #<bytecode 0x39f8919f842a987>)(("test" :base-directory "/home/ucecesf/..." :publishing-function org-html-publish-to-html :publishing-directory "/home/ucecesf/..." :include "export.org" :makeindex t))
  cl-some(#f(compiled-function (p) #<bytecode 0x39f8919f842a987>) (("test" :base-directory "/home/ucecesf/..." :publishing-function org-html-publish-to-html :publishing-directory "/home/ucecesf/..." :include "export.org" :makeindex t)))
  org-publish-get-project-from-filename("/home/ucecesf/...")
  org-publish-file("/home/ucecesf/...")
  org-publish-current-file(nil nil)
  org-export-dispatch(nil)
  funcall-interactively(org-export-dispatch nil)
  command-execute(org-export-dispatch)
--8<---------------cut here---------------end--------------->8---

I will try to create a minimal example and with emacs -Q later but I
have used publishing fine in the past for my website.  The example here
is based on the very simple example in the org info manual.

Thank you,
eric
-- 
Eric S Fraga, @ericsfraga:matrix.org, GnuPG: 0xc89193d8fffcf67d

Re: index for HTML export

[Fraga, Eric]

So publishing cannot have the target directory be the same as the source
directory, it would seem?  Having a different directory for
:publishing-directory makes publishing work.  I still do not understand
the error, however.

My original question remains: can we create an index for HTML export
without using publishing?

Thank you,
eric

-- 
: Eric S Fraga, with org release_9.5.4-623-gc66bdb in Emacs 29.0.50

Re: index for HTML export

[Fraga, Eric]

(apologies for flurry of emails)

Publishing works, in the sense that my org file is exported to HTML just
fine.  An index file is created but is not populated with any index
links.  What am I missing?  The info page is less than helpful
unfortunately.  Are index lines, e.g.

#+index: test!org publishing

processed in any way?

Thank you,
eric

PS -it's a lovely day here in the SE of England so time to enjoy a beer
in the garden!  Talk to you all tomorrow. :-)

-- 
: Eric S Fraga, with org release_9.5.4-623-gc66bdb in Emacs 29.0.50

Re: index for HTML export

[Ihor Radchenko]

"Fraga, Eric" <e.fraga@ucl.ac.uk> writes:

> I know (well, I believe as I haven't tried yet) I can /publish/ a
> project and generate an index using the #+index entries in the org
> files.  However, for a single file, is it possible to generate the index
> as part of the export process directly (or even separately from the
> export process)?  I can do this when I export to LaTeX, for instance.

Timothy is working on this feature. See
https://github.com/tecosaur/org-glossary

Best,
Ihor

Re: index for HTML export

[Jens Lechtenboerger]

On 2022-07-13, Fraga, Eric wrote:

> Publishing works, in the sense that my org file is exported to HTML just
> fine.  An index file is created but is not populated with any index
> links.  What am I missing?  The info page is less than helpful
> unfortunately.  Are index lines, e.g.
>
> #+index: test!org publishing
>
> processed in any way?

Over here, yes: https://oer.gitlab.io/OS/index-terms.html

I use this in my publish code:

	   (list "org-presentations"
		 :base-directory "."
		 :base-extension "org"
		 :makeindex oer-reveal-publish-makeindex
		 :exclude "index\\|backmatter\\|config\\|course-list\\|license-template\\|imprint\\|privacy\\|README\\|CONTRIBUTING\\|CHANGELOG"
		 :publishing-function oer-reveal-publish-org-publishing-functions
		 :publishing-directory "./public")

where oer-reveal-publish-makeindex is t and my publish.el makes sure
to publish to HTML:
https://gitlab.com/oer/OS/-/blob/master/elisp/publish.el

  (list "index-terms"
	:base-directory "."
	;; A file theindex.org (which includes theindex.inc)
	;; is created due to assignment to
	;; oer-reveal-publish-makeindex above.
	;; Using that setting, the file is automatically published with
	;; org-re-reveal, which is useless.
	;; Thus, publish as HTML here.  For this to work, index-terms.org
	;; is a manually created file including theindex.inc.
	;; The preparation and completion functions below set up an
	;; advice on org-html-link to rewrite links into presentations
	;; using org-re-reveal's anchor format.
	:include '("index-terms.org")
	:exclude ".*"
	:preparation-function 'oer-reveal--add-advice-link
	:completion-function 'oer-reveal--remove-advice-link
	:publishing-function '(org-html-publish-to-html)
	:publishing-directory "./public")

So, do you see theindex.org and theindex.inc?  Do you publish the
former?

Best wishes
Jens

Re: index for HTML export

[Fraga, Eric]

On Thursday, 14 Jul 2022 at 08:13, Jens Lechtenboerger wrote:
>   (list "index-terms"

[...]

>         :preparation-function 'oer-reveal--add-advice-link
>         :completion-function 'oer-reveal--remove-advice-link
>         :publishing-function '(org-html-publish-to-html)
>         :publishing-directory "./public")
>
> So, do you see theindex.org and theindex.inc?  Do you publish the
> former?

Yes, I do see theindex.org and theindex.inc but there are no index
entries.  What do the first two functions listed above do?

-- 
: Eric S Fraga, with org release_9.5.4-623-gc66bdb in Emacs 29.0.50

Re: index for HTML export

[Jens Lechtenboerger]

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

On 2022-07-14, Fraga, Eric wrote:

> On Thursday, 14 Jul 2022 at 08:13, Jens Lechtenboerger wrote:
>>   (list "index-terms"
>
> [...]
>
>>         :preparation-function 'oer-reveal--add-advice-link
>>         :completion-function 'oer-reveal--remove-advice-link
>>         :publishing-function '(org-html-publish-to-html)
>>         :publishing-directory "./public")
>>
>> So, do you see theindex.org and theindex.inc?  Do you publish the
>> former?
>
> Yes, I do see theindex.org and theindex.inc but there are no index
> entries.

That is strange.  File theindex.inc should contain the index entries.
I believe that “:makeindex t” on the Org source files with #+INDEX:
entries should do the job.

> What do the first two functions listed above do?

They adapt the link format for my specific export backend (to point
to slides of presentations).  That is not relevant in your case.

Best wishes
Jens

[-- Attachment #2: smime.p7s --]
[-- Type: application/pkcs7-signature, Size: 6187 bytes --]

Re: index for HTML export

[Fraga, Eric]

On Thursday, 14 Jul 2022 at 09:18, Jens Lechtenboerger wrote:
> That is strange.  File theindex.inc should contain the index entries.
> I believe that “:makeindex t” on the Org source files with #+INDEX:
> entries should do the job.

Well, it seems that index generation by publishing works with "emacs -Q"
so there's something in my configuration that is stopping things
working.  Time to drill down in my init files...

Thank you,
eric
-- 
: Eric S Fraga, with org release_9.5.4-623-gc66bdb in Emacs 29.0.50