68 Commits

Author	SHA1	Message	Date
Alan Orth	b637dd5eb1	layouts/partials/head-meta.html: Use Hugo's templates ... Instead of writing my own logic for metadata and Twitter cards, I should be using Hugo's own. This makes my theme code cleaner, but means I have to adjust some of the configuration conventions that I have been using. An added bonus is that my theme will work with more sites now, as long as they are using Hugo's config conventions.	2016-10-14 23:07:39 -04:00
Alan Orth	c49fa721ec	layouts/_default/baseof.html: Add support for Google Analytics ... Sites only need to add their Google Analytics tracking ID to their config: googleAnalytics = "UA-123-45" This uses the async version of the Google Analytics code.	2016-10-14 22:10:01 -04:00
Alan Orth	6e84974d2a	layouts/_default/baseof.html: Add "back to top" link in footer	2016-10-09 13:45:38 +03:00
Alan Orth	142d330048	layouts/_default/baseof.html: Give credit to @mdo for theme	2016-10-09 13:38:49 +03:00
Alan Orth	77b2cf9955	layouts/_default/baseof.html: Allow configuration of footer text ... Uses the "copyright" parameter from the site's config that is pretty standard among Hugo themes. Content can contain Markdown.	2016-10-09 13:36:07 +03:00
Alan Orth	7194b5926d	layouts/partials/head-meta.html: Add site verification support ... I had added Google Webmaster verify support but it got lost when I was re-organizing the head meta stuff. I'm adding it back now plus support for Bing and Yandex.	2016-10-08 16:57:10 +03:00
Alan Orth	577fdd75ce	layouts/_default/single.html: Markdownify page title ... In a multilingual context a post's title could be "Title" in English but «Title» in Bulgarian, and if we apply the Markdown filter to the title tag, then the language's Black Friday configuration is used, in this example it would be for the angled quotes. We already do this everywhere else we can in the post's content, so let's match it in the page title.	2016-10-06 15:05:44 +03:00
Alan Orth	d6328c34df	Remove anchor titles ... I had only added these for accessibility, but after some research it seems that assistive technologies don't use these.	2016-10-06 14:21:30 +03:00
Alan Orth	3a6bed5be7	layouts: Use Markdown filter on titles ... This makes it possible to have Black Friday config options like quote style also affect post titles.	2016-10-06 14:17:59 +03:00
Alan Orth	36a8a28d4c	layouts/_default/list.html: Remove debug code from pagination	2016-10-05 17:28:08 +03:00
Alan Orth	a8d694d08c	Add pagination logic + i18n strings for en	2016-10-05 17:21:53 +03:00
Alan Orth	70b4844c63	layouts/_default/list.html: Use paginator for page lists instead of custom stuff ... Hugo's own pagination stuff works just as well and probably covers even more corner cases. Also, this is one less config variable to have to check because you can just use Paginate (Default: 10).	2016-10-05 15:45:38 +03:00
Alan Orth	98a8c2b234	layouts/_default/baseof.html: Use template variable for RSS link ... This is the whole site's RSS feed, not just posts. I suppose this is better for multilingual sites, and sites with many pages.	2016-10-05 15:31:30 +03:00
Alan Orth	f873452e6c	layouts/_default/baseof.html: Use current language for html element's lang attribute ... You know you gotta specify the page content's language if possible, right? https://www.w3.org/International/questions/qa-http-and-lang	2016-10-04 11:22:53 +03:00
Alan Orth	577e168da5	Use i18n to translate some strings ... Hugo 0.17 allows for easy multi-lingual sites. Strings can be translated either in the theme or in the site, and missing strings will fall back to the default language. See: https://github.com/spf13/hugo/blob/master/docs/content/content/multilingual.md	2016-10-03 22:58:22 +03:00
Alan Orth	d99cf5df11	layouts/partials/meta-terms.html: use relLangURL for categories/tags ... Fixes generation of links to language-specific tags.	2016-10-03 22:28:35 +03:00
Alan Orth	1a3ff61ef6	layouts/_default/single.html: Add basic support for multi-language content ... Hugo 0.17 will allow you to write content and user interface strings in multiple languages. Requires the user to amend their config a bit though. See: https://github.com/spf13/hugo/blob/master/docs/content/content/multilingual.md	2016-10-03 17:57:08 +03:00
Alan Orth	48a6a82dcc	layouts/_default/summary.html: Remove extraneous spaces	2016-09-27 23:22:46 +03:00
Alan Orth	d16fe216a5	layouts: Remove link from author name in summary/posts ... There is no author archive yet, so this link doesn't go anywhere!	2016-09-27 23:21:01 +03:00
Alan Orth	6a25f3eef1	layouts: Move all meta tags to head-meta.html partial	2016-09-26 09:26:00 +03:00
Alan Orth	71413f55b6	layouts: Rename metadata partial	2016-09-26 09:23:13 +03:00
Alan Orth	884713fc2a	layouts: Add theme support for categories and tags ... Add categories/tags to front matter and they will be displayed on summary and post pages, with links to taxonomy pages. Example: +++ date = "2016-09-24T21:28:31+03:00" title = "Post title" categories = ["Nature"] tags = ["Wetland", "Oasis"] +++ For some reason if you add tags singularly, like: categories = "Nature" you get index errors from Hugo. Not sure if I need to parse the tags differently or just add more logic to test if the terms are singular or not.	2016-09-26 08:32:46 +03:00
Alan Orth	acde63b34f	layouts/_default/baseof.html: Make sidebar logic more robust ... Check if the params.sidebar is defined before checking to see if params.sidebar.hide is true or false. New sites might not have their config set up properly, so this avoids an error in the case that params.sidebar isn't defined yet.	2016-09-22 09:19:20 +03:00
Alan Orth	d6d94ff087	Add robots.txt template ... Advertises the XML sitemap and allows all user agents, but is only enabled if the site sets this property in their config: enableRobotsTXT = true See: https://gohugo.io/extras/robots-txt/	2016-09-21 22:37:39 +03:00
Alan Orth	9bb8294089	Add RSS feed for posts to base layout ... Not sure who uses RSS anymore but Hugo automatically generates the feed so we might as well advertise it.	2016-09-19 10:00:28 +03:00
Alan Orth	72d5c94cc5	Add basic sharing icons to the bottom of posts ... By default they are on, but you can disable them by adding the following configuration value: [params.sharingicons] hide = true If this parameter is undefined (or "false") then the icons will be shown. Furthermore, you can disable specific icons by setting their value to "false", ie: [params.sharingicons] facebook = false Any icons not named will be shown. Currently there a four icons configureg: facebook, googleplus, linkedin, and twitter.	2016-09-18 17:11:08 +03:00
Alan Orth	731af8c564	layouts: Add basic support for OpenGraph and Twitter card metadata ... Uses basic data like title, description, author, and date that we are using with existing vanilla meta tags, but extends them to OG and Twitter Card tags. See [0] and [1]. For the Twitter summary cards specifically, you can optionally add attribution for your username by adding something like this to your configuration: [params.social] twitter_username = "@mralanorth" ... and for posts with images, you can specify an "image" in the post's front matter like so: image = "/2016/09/IMG_20160916_174409.jpg" And then the theme will opt to use Twitter's "large" summary card. [0] http://ogp.me/ [1] https://dev.twitter.com/cards/getting-started	2016-09-17 18:05:22 +03:00
Alan Orth	826bd2de54	layouts/partials/sidebar.html: Use "Type" instead of "Section" ... Both work similarly here, but "Type" is more obvious to me.	2016-09-17 16:56:27 +03:00
Alan Orth	4427040041	layouts/_default/baseof.html: Enumerate non-post pages in header nav menu ... Still need to figure out how to determine which page we're on so we can set the "active" class accordingly (for Home we have the IsHome variable the we can check).	2016-09-14 23:43:26 +03:00
Alan Orth	d31626c5a3	layouts/_default/list.html: Check for page type instead of "section" ... Both work effectively the same for my use case, but the "type" is more obvious when looking at the code. See the documentation for Hugo's page variables for more info[0]. [0] http://gohugo.io/templates/variables/#page-variables	2016-09-14 23:39:39 +03:00
Alan Orth	42c06c260c	layouts: Only list posts on front page and sidebar ... We don't want to list other top-level pages like "About" here, they will be enumerated in the header.	2016-09-14 16:35:04 +03:00
Alan Orth	2bb9509bbb	layouts/_default/baseof.html: Add "active" class to nav if page is home ... Not sure how to do this for other pages yet, but I'll solve that once I start enumerating pages into the nav.	2016-09-14 14:55:29 +03:00
Alan Orth	e8ee0c68b7	layouts/_default/baseof.html: Smarter meta author tag ... Use the post's author from frontmatter, or else use the author from the site's config. You MUST have one of these set or else you will get an error during site generation. I think it's better to force the user to define an author tag rather than only printing it if it is defined because it is a good practice to help bots understand content.	2016-09-14 14:05:36 +03:00
Alan Orth	c5bacecad6	layouts/_default/baseof.html: Smarter meta description ... Use the post's meta description if it exists, otherwise use the one from the site's config. Set them using the "description" key in frontmatter or site config. Note: this means there is no way to NOT have a description. You must have *at least* a site-wide description and *optionally* a description for each page/post's front matter.	2016-09-14 13:45:34 +03:00
Alan Orth	cd3e327553	layouts: Use HTML5-compatible datetime format for posts ... The W3C validator was complaining. See: https://validator.w3.org See: https://html.spec.whatwg.org/multipage/semantics.html#the-time-element	2016-09-14 13:12:27 +03:00
Alan Orth	8c4b423173	layouts/_default/summary.html: Fix W3C validation error ... The validator[0] says: Element nobr not allowed as child of element a in this context. ... so I'll just remove it. [0] https://validator.w3.org	2016-09-14 12:39:40 +03:00
Alan Orth	d37e111ff4	Adjust header levels for post summary and page ... The W3C's HTML5 documentation says that header strength (h1–h6) is only important per section, but their validator[0] recommends only using one h1. [0] https://validator.w3.org/	2016-09-14 12:28:15 +03:00
Alan Orth	c94335a193	Make site header text clickable (to home) ... This is a pretty standard convention in blogs.	2016-09-14 12:24:38 +03:00
Alan Orth	2bb33145db	Allow optional addition of Google Webmaster Tools verification string ... Add to the site's configuration like so: [params] google_verify_meta = "BAi69DROASu2b2mkVNA_EyUsobfH7Mq8BmSg2Rn-Zp4"	2016-09-13 16:26:30 +03:00
Alan Orth	192d0bbee6	Allow configuration of optional sidebar links ... Add something like the following to your config: [[menu.sidebar]] name = "Link 1" url = "https://link1.com" [[menu.sidebar]] name = "Link 2" url = "https://link2.com" See the Hugo docs for more examples: https://gohugo.io/extras/menus/	2016-09-08 15:00:23 +03:00
Alan Orth	d214834089	Allow configuration of recent posts on sidebar ... By default it shows the latest five posts, but you can set this property in your config to override it: [params.sidebar] num_recent_posts = 7 Still no way to disable it, as I don't understand golang's HTML templating stuff yet. The Hugo docs are a bit confusing, but it seems like conditionals are a bit tricky because both false and 0 return a boolean false... hmm. See: https://gohugo.io/templates/go-templates/	2016-09-07 23:54:55 +03:00
Alan Orth	ba25b91d94	Allow site description to be Markdown	2016-09-07 16:47:59 +03:00
Alan Orth	15a41a86a2	Allow optional configuration of "About" block in sidebar ... Add something like the following to your config to enable the about block in the sidebar: [params.sidebar] about = "*My site* is really cool. Adios!" Can be formatted in Markdown.	2016-09-07 16:41:04 +03:00
Alan Orth	f7b4f0a819	Allow configuration of how many posts to show on the homepage ... You can set this property in your site's config to override: [params] num_recent_posts = 7 Defaults to five (5) if unset.	2016-09-03 20:21:40 +03:00
Alan Orth	a942707278	Remove static archives from sidebar ... I need to figure out how to generate a list of posts grouped by month, ie "August 2016", as well as a list template to show the posts for each month for when the user clicks the link.	2016-09-03 19:15:09 +03:00
Alan Orth	47b200578e	Use HTML5 header tag for blog header ... Makes it easier for computers to understand content by using tags that have explicit meaning. See: http://diveinto.html5doctor.com/semantics.html	2016-09-02 15:56:40 +03:00
Alan Orth	6059f6cbea	Use HTML5 aside and section tags for sidebar ... The HTML5 aside tag is for content that is tangentially related to the content around the aside tag, but is considered separate from that content. Section tags are semantic HTML5 elements that inform computers about content structure, as opposed to div tags which can be used for structure OR style. See: http://diveinto.html5doctor.com/semantics.html	2016-09-02 10:18:18 +03:00
Alan Orth	1f0799b9f1	Use H1 headers in <article> sections ... Headers are a semantic element that help computers understand the content. In general, header tags should follow rank order, but the most important is that the first header inside a section will serve as the title in a table of contents, etc, but since article sections stand alone as independent documents, I like the idea of explicitly starting with H1 tags. See: http://diveinto.html5doctor.com/semantics.html	2016-09-02 10:12:36 +03:00
Alan Orth	54ba5518d2	Use HTML5 <header> tags in articles ... The HTML5 <article> tag represents a complete, or self-contained, composition in a document. Headers are a semantic HTML5 element that helps computers understand the content.	2016-09-02 10:09:17 +03:00
Alan Orth	9b9226ca99	Use "|" for title separator instead of ndash ... A survey of a handful of websites shows that this is a more common separator of article and site title than the ndash.	2016-09-01 23:08:39 +03:00