oubiwann/blog

A 21st century .plan for Duncan McGreggor

blog's Issues

Create a theme/templates based upon Darkly

Also, take inspiration from the Dark Hugo theme.

Tasks:

• Add SASS files
• Add custom SASS for overrides
• Add scripts/lein aliases for easy generation
• Add the Darkly Wrapbootstrap theme demo page to /design
• Update the /design's blog post sample
• Update the /design's blog home sample
• Tweak the theme and sample pages for æsthetics
• Update the static-page generation templates to use the new theme
  • update the "About" section templates
  • update the "Design" section templates
• More fully use the theme and Bootstrap 4:
  • update the home page template
  • update the authors page template
  • update the archives page template
  • update the tags page template
  • update the categories page template
  • update the post page template

Update configuration to override dragon's default config

This will mean building the configuration in components.core instead of passing a builder function to the dragon system config constructor.

Get content generator working with latest Dragon

Supporting tickets:

• clojusc/dragon#60
• clojusc/dragon#62

Blog code tasks:

• Generate about pages
• Generate design pages
• Generate listing pages
  • authors
  • categories
  • tags
  • archives
• Generate Atom/RSS feed
• Generate sitemaps
• Generate front page
  • Create multiple tiers of headline content:
    • Headliner - heaviest emphasis, full width
    • Supporting - 3 next most recent headlines, almost as much emphasis, full width
    • Middle - 4 next most recent, much less emphasis, smaller excerpts, full width
    • Trailing - 9 next most recent, no excerpt, 3x3 grid
  • Update imagery for posts
    • Random choice of 8 images for headliner default, 750x300
    • Create small circle images for posts (e.g., 150x150) in Supporting and Middle headlines
    • Create circle thumbnails for posts (e.g., 50x50) in Trailing headlines grid
    • Create images for actual posts at 900x300
  • Update "Categories" widget
  • Add "Tags" cloud widget

Add hook to publish new Github posts to Blogger

Can use clj-blogger for this ...

Edit all old posts for streamlined tags

There are too many tags that bring little (or negative) value to the blog.

Only LFE category is being stored right now

At the very least there should also be:

• Clojang
• Clozhang

Related: #12

Add links for "Featured" and "Most Read" posts

Re-ingest Blogger Data

It looks like some miscellaneous extra data has made it into the posts imported from Blogger (namely some excerpt data). The XML parsing needs to be re-examined (clj-blogger) and then the data needs to be re-ingested.

Update ob CLI for Dragon 1.0

Depends upon clojusc/dragon#73

Update remaining posts for new image support

This is follow-up work from ticket #30

Update footer copyright to include Darkly credits

Edit all old posts to add a category

Add support for paging through blog archives

This will be used on the front page (buttons older posts/newer posts).

• Use full pager (old/new/page numbers)
• Add button below the pages that links to the Archive page
• Support page links of the form /blog/headlines/page/1
• Generate routes dynamically for however many pages there are

Create posts for old project announcements

Add Clozhang posts

Release 5.0.0

Create posts for various software releases (key projects)

Blog Post: Homage to Advogato.org

Post about advogato:

• became a user in 2001
• referred by fuzzyping, fellow Perl hacker at the time (members of the Maryland web hosting community, e.g., DiGEX/USi)
• stated using their blogging plaform 2 Mar 2005 (http://www.advogato.org/person/oubiwann/diary.html?start=9), last post was 19 Dec 2006
• On 27 Dec 2006, started blogging with Blogger/blogspot, but syndicated posts from there to advogato
• regularly updated my profile, projects, etc. on advogato
• site decommissioned 22 Jun 2017 (https://web.archive.org/web/20170715120119/http://advogato.org/)

Dates are missing from headlines on front page

Update tags display

• Add font-awesome in content area, then tags comma separated
• Update tags in metadata to be comma-separated

Use system-manager

Link headlines to posts

Style as it is currently (no underlines, no color).

Add Clojang posts

Update important posts for new image support

Once the Dragon ticket clojusc/dragon#69 has landed, go through the most visited posts to update their images.

Top posts:

• An Interview with Robert Virding on Lisp - LFE Logo
• The Secret History of Lambda - Lambda
• Prefix Operators in Haskell - Haskell Logo
• NASA/EOSDIS Earthdata - NASA Logo
• Mastering matplotlib: Acknowledgments - Book Cover
• Async Batching with Twisted: A Walkthrough - Twisted Logo
• Scientific Computing with Hy and IPython - Hy Logo

Add Old Blogspot Posts

This will require parsing the XML dump of the old blog, probably most of the work will be done in https://github.com/clojusc/clj-blogger.

Support below-the-fold articles on front page

Tasks:

• Add configuration for above-fold and below-fold counts
• Add corresponding cfg component functions
• Divide into two sections "middle" and "trailing"
  • Style middle like "supporting", but with less emphasis
    • 1 per row
    • Just title, date, and thumbnail (no or limited metadata)
  • Style trailing in a more condensed manner, e.g.:
    • 2 or 3 per row (square in appearance)
    • Just title, date, and thumbnail (no or limited metadata)

Fix MathJAX support

Update all page templates to use new Dragon 1.0.0 post data structure

Templates:

• Design
  • blog post example
  • bootstrap example
  • front page
  • design home
• Listings
  • archives
  • authors
  • categories
  • tags
• Pages
• Home
• Posts
• RSS/Atom feed

Random default article image

Dev tasks:

• Generate a hash from post data that will change the least
• Generate a repeatable random number with a seed that is based on the hash
• multiply by 9, floor it, and select the image for that index

Post announcing the new blog home

Convert from less to sass/scss

Remove old, unused code from previous iteration of generator

Add LFE posts

For this, will need to convert Jekyll file header metadata to Dragon RFC5322 metadata. Markdown should be usable as-is ... might need to add MathJax support to Dragon, if it doesn't already have it.

Blog Post: Release History of "Electric Duncan"

Share release history with a note about the new blog home ... maybe make that it's own post, with a note about syndicating to blogger ...

Enable "Next" and "Previous" post linke on post pages

Release 5.1.0

Document past releases

Once doc'ed, create releases in Github complete with old dates.

Update post-generation code to respect the `Public?` header

Edit all old, imported posts for bad content, formatting, etc.

• Use unicode chars instead of html entities in post titles (e.g. pi-calculus)
• Add missing category for each post
• Update tags in each post for clarity, information value. and consistency (the goal is to reduce the number of tags and make it easier to find posts in a given topic)
• Add missing post, headline, small, and thumb images for most-read posts

Replace project.clj-based config with edn config

This should mean we can also drop the lein library dependency.

Depends upon clojusc/dragon#55

Add Twitter link to post

• Add font-awesome in content area
• Add link in metadata area