themes/brutalist-minimalist/TODO.org

   1 The following is a list of open tasks for the gohugo
   2 brutalist-minimalist theme (as used by the author internally).
   3
   4 * [3/5] Bugs
   5 ** TODO TOC vanishes as mobile response (BM-1)
   6
   7 This is b/c currently site menu and toc are nav elements and
   8 responsiveness is done via nav. Need to change this.
   9
  10 For test see http://localhost:1313/lorem/ipsum
  11
  12 It might make sense to let the toc vanish at smaller screen sizes or
  13 also make an hamburger from it, though. Regardless this is for later:
  14 First we must remove the responsiveness response here.
  15
  16 ** DONE Printing style partially ignored by Safari on IPadOS (BM-2)
  17 :PROPERTIES:
  18 :ID:       748e2dff-ddd7-4660-8fb0-f38e89ca14f8
  19 :END:
  20
  21 Need to rebuild the printing style incrementally with Safari. Maybe
  22 also move the printing style in own asset to allow for easy user
  23 override (currently fix part of beyond-minimalism)
  24
  25 ** DONE Frame around the header has now vanished in printing style (BM-3)
  26
  27 ** TODO Code styling hacks need cleanup (BM-4)
  28 Monospace code styling is "improved" in beyond-minimalism.css, but
  29 then needs to be overridden in a rather fargile fashion in
  30 bm-printing.css. This needs to be refactored from ground up.
  31
  32 ** DONE Warning: .File.Path on zero object (BM-5)
  33 "WARN 2022/03/13 23:50:09 .File.Path on zero object. Wrap it in if or with: {{ with .File }}{{ .Path }}{{ end }"
  34
  35 * [18/19] Release Readiness
  36 ** DONE Try: Use conditional imports for responsiveness, then produce responsiveness.css via assets, dependent on title length.
  37 ** DONE Glitzersachen needs an overhaul of the resonsive limits? => don't work w/o probs, why?
  38 => responsiveness limits are more complicated, require substracting menus width etc, which in turn a comlicated to calculate.
  39 => Best approach posisbly: Make all 5 of them to be set set in config.toml (since I cannot use
  40    css variables, AFAIK).
  41
  42 Also: We do not seem to have a multiply function in the templates, so we're limited anyway (But: examine that).
  43
  44 ** DONE Clean this file up (!)
  45 ** DONE Rename -narrowish to compact-margins
  46 ** DONE Rename Example Site
  47 => This now really requires to calculate the responsiveness limits from the Site title
  48 ** DONE Make copyright notice optional dep on having the string given in params
  49 If there is a page.Date, it should easily be possibly using with, otherwise a
  50 bit of a problem occurs.
  51
  52 ** DONE Test with various Browsers
  53 *** DONE Fennec on Android
  54 *** DONE DuckDuck Privacy Browser on Android
  55 *** DONE Safari on IPad OS (failing at printing), see [[id:748e2dff-ddd7-4660-8fb0-f38e89ca14f8][Printing style partially ignored by Safari on IPadOS]]
  56 *** DONE Firefox on IPad OS
  57
  58 ** DONE [3/3] Make Release Ready (conforming to expectations on https://gohugo.io/contribute/themes/)
  59 *** DONE lorem/lorem.md must show off math, inline and block code. => example-short.md
  60 *** DONE README.md
  61 *** DONE /images/screenshot.png and /images/tn.png
  62
  63 ** DONE Extend sample site, better example pages.
  64 ** DONE KaTeX and highlighting should be included earlier
  65 ** DONE Check license notes again
  66 ** DONE make a thumbnail and a screenshot
  67 ** DONE Configure Example Site online, deploy mechs
  68
  69 Note: I can only release after I
  70
  71 *** DONE Configure Example Site on server and in DNS
  72 *** DONE Test Manual Deployment
  73 *** DONE Deployment Script with temp hardcoded targets
  74 *** DONE Deployment Script Reading from config.toml
  75 (Restriction not to read the full config system of hugo is accepted FTM)
  76 ** DONE Lets Encrypt for brutalist-minimalist.glitzersachen.de
  77 ** DONE Public version also need the german TMG/DSGVO declarations. What a nuisance
  78 Git version can be published earlier, but example site will be dead
  79 ** DONE Sample pages should follow a different order than day - attribute order?
  80 ** DONE Create first git version (local, publish to github and gitlabs)
  81 ** DONE Publish at https://github.com/gohugoio/hugoThemesSiteBuilder
  82
  83 ** TODO [0/3] Manual Regression Testing (specifically printing + markup), 0.1.1rc
  84 *** TODO Fennec @ Android
  85 *** TODO Safari @ IPad
  86 *** TODO Firefox @ IPad
  87
  88
  89 * [3/26] Post Release, Pre Production Improvements
  90
  91 ** DONE Book record template
  92 ** DONE Add document date to source line
  93 ** DONE Change books listing (use topic as separator)
  94 - Topic is subheading, group by them
  95 - Use bib style listing (Author/Title/Year only, last tags) => factor out as partial.
  96 ** TODO Blog post lists should show the date (in ISO)
  97 ** TODO Every mape should show the tags. Where?
  98 ** TODO Add a next edition/version field to the book records
  99 - a: in the template
 100 - b: book/single.html
 101 ** TODO Docs for books database.
 102 ** TODO List tags in pages and blog posts (where?)
 103 ** TODO Shortcode to create links to tags, use this in tag/prolog to link to "logic programming"
 104 ** TODO For the books/media database: Render the list more bib style. Shall we render by some major category?
 105 Also: Change to partials, passing the record (page) as parameter. Dito for the table format itself.
 106 ** TODO Fix list and tags templates
 107 - Show "type" of listed items: Article, Book, Blogpost, list in bib or
 108   other style, handle missin summary proper.
 109 - See also TODOs in current templates.
 110 ** TODO Update field, missing date field
 111 - Missing date => Don't render a source line
 112 - Update set   => Render this as a date.
 113 ** TODO Document responsiveness vars properly in config.toml (we still have the old vars there!)
 114 ** TODO Make clalculated limits overrideable as well
 115 ** TODO Think about reducing H-sizes (and replace by fat/grey) in narrow and very-narrow mode.
 116 ** TODO Factor out partials: Subpages by order, Subpages by date
 117 ** TODO Extend the README, show of some highlights.
 118 ** TODO Complete Documentation
 119 ** TODO Integrate footer in responsiveness
 120 - around activation of narrow (when copyright and footer links don't fit in a line) => witch to flushleft and stack footer links
 121   Make copyright and footer links smaller.
 122 ** TODO Describe Responsiveness (see Screenshots)
 123 ** TODO Test with Chrome
 124 ** TODO Consider effect of box drawing hacks on "normal" code display w/o known language.
 125 Maybe we need a shortcode for the boxdrawing to wrap a specific class around that.
 126 ** TODO Create some screenshots of the example site + put into \
 127 example site + readme.
 128 ** TODO Complete documentation on/in example site
 129 ** TODO Explain the brutalism aspect a bit
 130 There are actually 2 web brutalism movements meaning radically
 131 different things. I only mean one of them.
 132 ** TODO Make params.subtitle and siteBasename optional
 133 ** TODO Explain config variables (well, that's optional FTM)
 134 ** TODO Configurable footer links (like nav-links)
 135 ** TODO Configurable footer next (new)
 136
 137 ** TODO Parameters for styling of <code> => refactor
 138
 139 ** TODO in katex.html explain choice of delimiters
 140
 141
 142 * [0/9] Post Production Improvements
 143
 144 ** TODO Version descriptor in scripts should be read from CHANGELOG.md (!)
 145 ** TODO The print style needs to be refactored to variables (at least partially)
 146 ** TODO ASCII Graphics should become a short code!
 147 so that we can adjust the line high appropriately there and remove/avoid the frame in print styling.
 148 ** TODO Examine possibilities of inline highlighted code
 149
 150 This requires more than modifying:
 151
 152 : <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-html" data-lang="html"> foobar </code></pre></div>
 153
 154 ** TODO Style a maximum width for the body (ca 100 ex)
 155 ** TODO Try to pass H level to recent-posts as parameter (is that even possible?)
 156 Would also need to be able to produce raw html tokens (not: Strings).
 157 ** TODO Configurable fonts, maybe use default helvetica
 158 I, personally, find that ATM not this important). Is there a way to
 159 expand CSSes, so we can can render a css/font.css dependend on site
 160 variables? That would be good for having the ability to remove the
 161 fonts again in a tar ball after rendering. "Unstyling the site".
 162
 163 ** TODO Allow to switch away from the h1/h2 use
 164
 165 Allow to switch away from the h1/h2 use as enforced currently to
 166 s.th. that does allow to use the headings as the headings on the
 167 page (of course, now page titles could be different from h1, but
 168 that would be intended).
 169
 170 ** TODO Allow switching back to loading katex from the internet
 171 ** TODO Calculate (approx) responsive limits from title and subtitle
 172
 173 ** TODO Char Graphics characters experiments and recommendations
 174 Also: Is there enough material to systematize this sort of drawing?
 175 Can I have "half-lines?" Can I write an emacs package to support
 176 creating line drawings?
 177
 178 ╹ <- yes, possibly. So I can draw/remove lines with a half-box granularity ...
 179
 180 ** TODO Consider older browsers again - typically \
 181 ... we'd rather turn off all stylesheets for browsers that don't support css3 and fall back to default html.
 182 Should also have an FAQ on this, linked from the footer or below.
 183
 184 ** TODO Is it possible to embed plantuml?
 185
 186 * [0/1] Backend/Frontend stuff
 187
 188 Strictly not about hugo, but using hugo as a backend and pulling pages
 189 from some upstream collection (also do some preprocessing, e.g. adjust
 190 heading levels accordingly) => put into scripts.
 191
 192 ** TODO Implement a simple (single file preprocessing only) front-end mech
 193