Skip to content

doc: add html_lookup template for the CGI keyserver UI#5

Open
mneme-2026 wants to merge 2 commits into
u1f35c:mainfrom
mneme-2026:mneme/upstream-add-html-lookup
Open

doc: add html_lookup template for the CGI keyserver UI#5
mneme-2026 wants to merge 2 commits into
u1f35c:mainfrom
mneme-2026:mneme/upstream-add-html-lookup

Conversation

@mneme-2026

Copy link
Copy Markdown

A small standalone HTML lookup page using milligram.min.css that can be mounted in front of the onak CGI to give end users a clean search form for op=index / op=vindex / op=get.

Original author: Sébastien Picardeau (then a foopgp contributor), who first shipped it in our Debian packaging under debian/extra/doc/html_lookup/ (commit 86a3a82 in our foopgp/onak fork on Codeberg). The page is repackaged here under doc/html_lookup/ so it ships in every distribution build rather than only the Debian one — but if you prefer a different layout (e.g. examples/, or staying debian-only), say so and I'll relocate.

Submitted on behalf of foopgp (Friends of OpenPGP).

A small standalone HTML lookup page (using milligram.min.css) that
can be mounted in front of the onak CGI to give end users a clean
search form for op=index / op=vindex / op=get. Original author:
piseb <piseb@mailo.com> (October 2025), shipped initially under
debian/extra/doc/html_lookup/ in the foopgp Debian packaging of
onak. Repackaged here under doc/html_lookup/ so it is available
upstream and ships in every distribution-side build.

Forwarded by Mnêmê <mneme@foopgp.org> on behalf of foopgp.

@u1f35c u1f35c left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like the idea of a nice lookup page being shipped, but I think it needs a couple of cleanups before I can merge it.

Comment thread doc/html_lookup/index.html Outdated
<body>
<div class="container">

<h1><a href="https://the.earth.li">Onak</a> Public Key Server</h1>

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd rather not default to linking to this top level link for onak. Possibly the GitHub page instead?

@@ -0,0 +1,56 @@
<head>

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a generated file without source, so I can't include it in the Debian packaging as is. However I note that there's a libjs-milligram package so perhaps we can drop this file and just Suggests that instead?

Per u1f35c review on PR u1f35c#5 :

- Drop the embedded milligram.min.css. It's a generated (minified)
  artifact without source, which precludes Debian packaging. Replace
  by a <link> to the libjs-milligram package's milligram.css served at
  /javascript/milligram/milligram.css (path provided by the standard
  javascript-common alias). Suggest adding `libjs-milligram` to
  Suggests: in debian/control.
- Move the four custom CSS rules (form label, .container, #keytext,
  .display-block) from the bottom of the dropped CSS file into a
  short inline <style> block in the document head, where they're
  trivially reviewable.
- Replace the h1 link from https://the.earth.li (u1f35c's personal
  site) to https://github.com/u1f35c/onak per the reviewer's preference.
@mneme-2026

Copy link
Copy Markdown
Author

Both points addressed in ac0c343, thanks for the review !

  • Embedded milligram.min.css dropped ; the template now links to /javascript/milligram/milligram.css (the standard alias provided by javascript-common). Adding Suggests: libjs-milligram to debian/control on your side would complete the loop.
  • The four custom CSS rules (form label, .container, #keytext, .display-block) are now inline in a short <style> block in the document head, so they're trivially reviewable.
  • The h1 link now points to https://github.com/u1f35c/onak.

Happy to move the inline overrides into a separate onak.css file if you'd prefer that over an inline <style> block.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants