⚒Anvil
Sign in

clo / cl-site public

closed

FAQ index page generator 28

opened by common-lisp.net

Administrator (@root) on GitLab, 2018-10-27.

Currently, there is a faq/index.html page. This page contains a manually maintained index into the other faq/*.* files. This issue is about replacing the manually maintained index page with an aggregator which compiles the index (and summaries) into the current faq/index.html file.

I'm thinking that each of the FAQ files either holds a summary YAML element in the "metadata" section, or that we add "

" tags (which will be hidden through CSS).

common-lisp.net changed milestone to %3
Ccommon-lisp.net

Philipp Marek (@pmarek) on GitLab, 2018-11-10.

Well, my first thought was to take the first sentence that starts with "This page" ;/

Ccommon-lisp.net

Erik Huelsmann (@ehuelsmann) on GitLab, 2018-11-10.

@pmarek actually, that works too.

I don't have a clear view on how to integrate the index generator in the existing code. Do you?

Ccommon-lisp.net

Philipp Marek (@pmarek) on GitLab, 2018-11-11.

Well, one problem with that idea is that 1 out of 2 FAQs don't start with that text.

Ccommon-lisp.net

Dave Cooper (@dcooper) on GitLab, 2026-10-01.

There are four FAQ entries, and /faq/ lists them by hand in content/faq/index.md. At that size a generator costs more than it saves. Closing; reopen if the FAQ grows.

Sign in to comment.