forgotten-roads / blog Goto Github PK

View Code? Open in Web Editor NEW

1.0 2.0 0.0 32.71 MB

The Blog of Forgotten Roads MX

License: Apache License 2.0

Makefile 0.41% Clojure 2.78% Shell 0.01% CSS 4.63% HTML 92.17%

blog motorcycle riding adventure camping folk-art diy howtos travelog

blog's People

Contributors

Stargazers

Watchers

blog's Issues

Improve tag padding in aside widget

As you can see below, the "updates" tag is too close to the widget border:

Generate all posts by author

In addition to primary blog posts (see ticket #8), all posts need to be saved by author.

Tasks:

save pages to /docs/authors/FIRST_LAST/YYYY-MM/DD-HHMMSS-TITLE.html
create /docs/authors.html - iterate all author names with links
create /docs/authors/FIRST_LAST.html - iterate all author posts with links
regenerate all authors sidebars

Add `frmx new post` command

Add support for generating stubbed content files, ready for editing.

The following commands should be supported:

frmx new - alias for frmx new post
frmx new post - new stubbed placeholder post of default content type
frmx new post md - new stubbed placeholder post of Markdown content type
frmx new post clj - new stubbed placeholder post of Clojure content type
frmx new post edn - new stubbed placeholder post of EDN content type
frmx new post html - new stubbed placeholder post of HTML content type
frmx new post rfc - alias for frmx new post rfc5322
frmx new post 5322 - alias for frmx new post rfc5322
frmx new post rfc5322 - new stubbed placeholder post of RFC 5322 content type

All commands will generate a content file and a metadata file. The content file will be of the form specified in the command or will use the default type. The metadata file fill be in EDN format have have all supported keys stubbed with required fields indicated and optional fields set to an empty string, list, map, etc.

See ticket #1 for more details on these files.

Create header background image

It might be nice to have a header background image ...

Add meta tags

Google-search-friendly meta tags:

description

General:

author
generator

Dublin Core:

Example:

<head profile="http://dublincore.org/documents/dcq-html/">
<title>Expressing Dublin Core in HTML/XHTML meta and link elements</title>
<link rel="schema.DC" href="http://purl.org/dc/elements/1.1/" />
<link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

<meta name="DC.title" lang="en" content="Expressing Dublin Core
in HTML/XHTML meta and link elements" />
<meta name="DC.creator" content="Andy Powell, UKOLN, University of Bath" />
<meta name="DCTERMS.issued" scheme="DCTERMS.W3CDTF" content="2003-11-01" />
<meta name="DC.identifier" scheme="DCTERMS.URI"
content="http://dublincore.org/documents/dcq-html/" />
<link rel="DCTERMS.replaces" hreflang="en"
href="http://dublincore.org/documents/2000/08/15/dcq-html/" />
<meta name="DCTERMS.abstract" content="This document describes how
qualified Dublin Core metadata can be encoded
in HTML/XHTML &lt;meta&gt; elements" />
<meta name="DC.format" scheme="DCTERMS.IMT" content="text/html" />
<meta name="DC.type" scheme="DCTERMS.DCMIType" content="Text" />
</head>

Open Graph (Facebook):

Twitter:

<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:site" content="@nytimes">
<meta name="twitter:creator" content="@SarahMaslinNir">
<meta name="twitter:title" content="Parade of Fans for Houston’s Funeral">
<meta name="twitter:description" content="NEWARK - The guest list and parade of limousines with celebrities emerging from them seemed more suited to a red carpet event in Hollywood or New York than than a gritty stretch of Sussex Avenue near the former site of the James M. Baxter Terrace public housing project here.">
<meta name="twitter:image" content="http://graphics8.nytimes.com/images/2012/02/19/us/19whitney-span/19whitney-span-articleLarge.jpg">

See:

Add Google+ social icon

Decide upon blog entry structure

What about this:

posts/YYYY-MM/dd-hhmmss/content.[clj | edn | html | md]
posts/YYYY-MM/dd-hhmmss/meta.edn

For the file endings, if:

clj - there must be a content function defined that takes no arguments - this will be called
edn - there must be a top-level map data structure with the content key - this will be used
html - the entire content of the file will be used as-is
md - the entire content of the file will be parsed as Markdown

Where the meta.edn file would have a structure something like:

{:title "..."
 :subtitle "..."
 :excerpt "..."
 :author "..."
 :category "..."
 :tags ["..." "..." ...]
 :comment-link "..."}

Generate all posts by tags

In addition to primary blog posts (see ticket #8), all posts need to be saved by tags.

Tasks:

save pages to /docs/tags/TAG/YYYY-MM/DD-HHMMSS-TITLE.html
create /docs/tags.html - iterate all tag names with links
create /docs/categories/TAG.html - iterate all tag posts with links
regenerate all tags sidebars

Make tag colors a heatmap

Tasks:

when generating a site, return tag data that is not only the tag name, but also the tag count (number of posts that use that tag)
divide the current tag color and a lighter color into four sections (five boundaries) and use the edges between them as the color range
rank each tag count on scale of 1 to 5 and assign the appropriate color

Note: some of theses tasks will need to be done in Dragon.

Style "neighboring posts" arrows in siedbar widget

The post navigation arrows that appear at the bottom post the longer posts are styled properly: you can easily tell when there are more posts and when there aren't, based on the styles. The ones in the sidebar widget are missing their styles.

Add log level to project.clj :blog configuration

Also update config namespace to provide a function for this.

Then update logger calls to use it.

Add `frmx add comments` command

Add support for updating adding the comments URL for any post that doesn't have one.

The following commands should be supported:

frmx add comments url [POST] - update the entry in the meta.edn file for the given post

Tasks:

Use the Clojure Github API to create a "comments" issue for all posts that are missing one
Update the entry in the meta.edn file
Shell out with git commit POST/meta.edn -m "Added commit URL."
Regenerate post so that a link to the comment URL shows up

Move latest CSS changes into LESS files

Optionally hide some articles from the front page

After some exposure on the front page, it will be desirable for some articles with lower interest levels to not be displayed there. This change introduces support for this.

Tasks:

Update post source files with a boolean metadata element (e.g., an rfc5322 header) like "Show-In-Headlines: True"
Convert headline boolean to idiomatic Clojure upon parse: Show-In-Headlines -> headline?
If empty/nil set to true
If false, when building list of headline stories, don't include in the top-X (10, by default)

Enable search for site

Look at some of these:

Generate all posts in archives

In addition to primary blog posts (see ticket #8), all posts need to be saved in the date archive.

Tasks:

save pages to /docs/archives/YYYY-MM/DD-HHMMSS-TITLE.html
create /docs/archives/years.html - iterate all years
create /docs/archives/YEAR/months.html - iterate all months for the year
create /docs/archives/YEAR/MONTH/DD-HHMMSS-TITLE.html - iterate all posts for the month
regenerate all archive sidebars

Generate all posts by category

In addition to primary blog posts (see ticket #8), all posts need to be saved by category.

Tasks:

save pages to /docs/categories/CATEGORY/YYYY-MM/DD-HHMMSS-TITLE.html
create /docs/categories.html - iterate all category names with links
create /docs/categories/CATEGORY.html - iterate all category posts with links
regenerate all category sidebars

Add drop-down menu to "About" top-nav pill

Provide links to privacy policy, disclosure policy, contact page, powered-by, about frmx.

Subtitles on post pages need styling

The subtitles don't stand out. Maybe italics with a less dark font color ...

Add post about themes, categories, and tags

Add thumbnails to front-page posts

Add support for RFC 5322 content type

Tasks:

Create rfc5322-content stub
Ensure stub is properly generated
Add postal dependency
Parse generated RFC 5322 content
Ensure standard fields are parsed and accessible via keys defined by the blog metadata
Ensure RFC-5322-optional fields are parsed and accessible via keys defined by the blog metadata

Add contact page

Add featured articles widget to front page

Add `frmx check comments` command

Before publishing, posts should be checked for content and the presence of required metadata fields (see tickets #1 and #3).

Commands:

frmx check comments

This command needs to do the following:

Use the Clojure Github API to get a list of issues tagged with the comment label
Identify all posts that don't have a "comments" issue created for them

Use header logo instead of text

This will, of course, mean creating a header logo ...

Create Bash auto-complete file for `frmx`

New logo

Add new header logo

Add a segment beflow the first 5 articles on front page

A nicely formatted list of another 5 for a total of a "top ten" ...

Convert Bootstrap blog entry HTML to template

Missing favicon in tab

In Google Chrome, the favicon does not display in the tab.

Markdown-based pages have too much header spacing

For example, the space between the "About" heading and the page header is greater than on the other pages (e.g., "tags", "categories").

Phone view of front-page is bad

In particular:

some of the top-5 stories are forced together in xs mode; they need to be displayed in their own rows in xs mode, not two side-by-side
the social links collection is so long now that in md mode and smaller, the menu is bumped down to where it shouldn't be
- at all sizes, the main menu should remain in the same location, until it goes to hamburger mode
- at all sizes, the social menu should not cause display issues with other components

Overlay title and metadata on main image for blog posts

Increase total number of posts on front page to 5

Make the first one span the two columns and give it more oomph, as this will be the headline/most recent post.

Add `frmx check posts` command

Before publishing, posts should be checked for content and the presence of required metadata fields (see tickets #1 and #3).

Commands:

frmx check - alias for frmx check all
frmx check content - alias for frmx check posts
frmx check posts
frmx check all

Add `frmx show metadata` command

Add support for showing post metadata.

The following commands should be supported:

frmx show metadata - alias for frmx show metadata all
frmx show metadata all - show metadata for all posts
frmx show metadata [POST] - show the metadata for a particular post

Add `frmx publish` command

Under the hood, the command needs to do the following:

Run frmx check content
Run frmx check comments
If any of the checks fail, halt the publish process
Shell out with git push origin master

Add `frmx show content-type` command

Planned subcommands:

frmx show content-type POST

Planned aliases:

frmx show comments POST - use the Github API to get a list of comments for a given post

Update Footer

Tasks:

Add copyright, C&B|Books, BilloSystems, Ltd. Co.
Changes "stats" section
Change "hall of fame" section
Update "contact" section

Create data function for blog entries

Should return data structure that has the following keys:

:content
:metadata

Update README to use the `frmx gen` command

This may mean tweaking the frmx gen command to perform additional tasks that the make blog target currently does ...

Disable Jekyll builds on Github

Got an error last night from Github because it's trying to build some of the repo's content.

Integrate comments service

Disqus?

Provide a bit more organization on the front page

Add a heading after the title and tagline, maybe "Headlines"
Add a brief description of the recent posts, e.g., "Below are the most recent posts created on Forgotten Roads. If you are looking for older posts, be sure to visit the archives, listed chronological order (most recent to earliest)."
Change the button at the bottom from "Read More" to "List All Posts"

Generate all posts by date

Primary content for posts need to be generated and saved,

Tasks:

save pages to /docs/posts/YYYY-MM/DD-HHMMSS-TITLE.html
regenerate all archive pages
regenerate all archive sidebars

forgotten-roads / blog Goto Github PK

blog's People

Contributors

Stargazers

Watchers

blog's Issues

Recommend Projects

Recommend Topics

Recommend Org