Skip to content

Latest commit

 

History

History
115 lines (65 loc) · 6.44 KB

readme.md

File metadata and controls

115 lines (65 loc) · 6.44 KB
Raw

Hain's Point Theme

A customizable newsletter-focused theme for Micro.blog. Includes featured posts, asides, and more!

Homepage

Written for Micro.blog by Jason Dettbarn @endonend.

My site currently uses this theme, if you'd like to see it in action.

Homepage 2

Single Page

How to install

Hain's Point for Micro.blog is freely available to members of Micro.blog. Log into your account, choose Plugins in your settings, click on Find Plug-ins, and choose to install Hain's Point as your theme.

Note: This theme was built and tested with Hugo 0.54. Make sure that is set on your Micro.blog Design settings page. If you installed via plug-in, the Custom Theme on that page should be set to None.

Once installed, visit the theme's Settings screen to customize for your site. Settings available:

  • Social usernames: Twitter, Instagram
  • Set newsletter name and homepage subscribe blurbs
  • Set Micro.blog newsletter ID (see the tips section below)
  • Set the "about" blurb on the sidebar and About page URL
  • Set header logo (see the tips section below)
  • Customize the "Latest Issues" text above your two featured posts
  • Customize the icon next to your newsletter/featured category (default is currently 'music-player') above your two featured posts. For the icon, use the icon name from Bootstrap Icons
  • Customize the header/footer background color; subscribe box, about box - backgrounds, buttons, and text! Bootstrap values can be found here: Text Colors, Button Colors, Background Colors

Also, you will need to create the following categories:

  • Featured (the two latest posts in this category show above the subscribe box on the homepage)
  • Asides (the posts in this category get an Aside tag and show in the sidebar in post pages)

Theme Install Tips

  • Get your newsletter ID on the Subscribe page created when you enable Newsletters for your micro.blog account. The ID is in the form action URL it adds to that page. In this example the ID is 61826: https://micro.blog/users/subscribe/61826

  • For your header logo, upload a PNG file to your Uploads and grab the Micro.blog URL for that image. For my site, the image was 600x120 pixels with white text on a transparent background. You can also use a black background (in this case the file can be a JPEG) or what ever color you want if you choose to customize the theme.

Plugin Support

Hain's Point currently supports these plugins:

These are all tested and confirmed by me. Others may work, though!

Note: I am working on support for the Photos plugin and Photos page. (as of 3/1/22)

Note on Plausible Analytics: the theme supports Goals, specifically the Newsletter subscription form. In Plausible, simply add a Goal > Custom Event named "Newsletter" to your site and the Newsletter subscription form submissions will be tracked.

Note on Upgrading

After installing via plug-in, you will be prompted for upgrades in the future as I make changes to the theme. Please note, when you upgrade (as of 3/2/22), your settings will not be saved, so please document these settings prior to upgrading until this is fixed. You will need to go into Settings and re-enter your settings after each upgrade.

Donations

If you use the theme (and like it) you can donate to support its development. Thanks in advance!

Version History

2022.1 - February 23, 2022

  • Initial release

2022.1.1 - March 1, 2022

  • Quick Fix - changed Flickr to Twitter, poor copy + paste!

2022.1.2 - March 2, 2022

  • Added upgrade note to Readme (save your settings prior to upgrading!)
  • Added some CSS for blockquote captions (wrap your blockquote captions/citations and add the class .blockquote-footer), pre styling, horizontal rule styling, and image captions (wrap your image captions and add the class .image-footer)

2022.1.3 - March 2, 2022

  • Fixed an issue with empty Featured and Asides categories causing build errors.

2022.1.4 - March 3, 2022

  • Fixed an issue with the Page template. Sidebar and header now show properly.

2022.1.5 - March 3, 2022

  • New! Customize the "Latest Issues" text and the icon next to your newsletter/featured category (default is currently 'music-player') above your two featured posts. For the icon, use the icon name from Bootstrap Icons

2022.1.6 - March 3, 2022

  • New! Added support for Plausible Analytics form custom event tracking - specifically for the Newsletter form

2022.1.7 - March 8, 2022

  • New! Added support for color customization: header/footer background color; subscribe box, about box - backgrounds, buttons, and text!

2022.1.8 - March 8, 2022

  • New! Added support for the Reply by Email plugin. Install the plugin, set it up, then make sure to turn it on in the Hain's Point settings.

2022.1.9 - March 9, 2022

  • New! Added support for On this Day by adding microformats to the single post page.
  • New! Added a toggle for Plausible Analytics form tracking to the Settings. See note above on setting it up, if you want to toggle this on. (Should be off by default, since some browsers block this tracking.)

Base theme files forked from Cypress for Micro.blog by Colin Devroe -- to learn Hugo templating.