cdevroe
cdevroe

Micro.blog launches Discourse help center: cdevroe.com

|
Embed
Progress spinner
cdevroe
cdevroe

@peterimoore Can you point me to a repository on Github for the theme(s) you've tried with M.b? Maybe I'll notice something quickly.

|
Embed
Progress spinner
Miraz
Miraz

@peterimoore @cdevroe It would also be helpful info to have available at custom.micro.blog . 😀

|
Embed
Progress spinner
cdevroe
cdevroe

@Miraz This is a nice resource as well. I wonder if you should consider taking all of the resources you've collected and put them into help.micro.blog? And then custom.micro.blog could be for sharing news and updates re: themes/plugins?

|
Embed
Progress spinner
gregmoore
gregmoore

@peterimoore You’re not alone in this. I spent hours importing and trying Hugo themes on my test account last week and all of them seemed to have major incompatibilities so I gave up.

|
Embed
Progress spinner
cdevroe
cdevroe

@gregmoore @peterimoore I spent some time yesterday on a Zoom call with @manton. He understands the need to spend more time on themes and from what I can tell they will be. Once Cypress is out and bug free, I plan on releasing a second M.b theme as well to help out.

|
Embed
Progress spinner
cdevroe
cdevroe

@Miraz Something I noticed is that much of the code isn't able to be copied and pasted. Example

|
Embed
Progress spinner
gregmoore
gregmoore

@cdevroe That's exciting news. It sounds lazy but part of why I love Micro.blog is because I don't have to put my developer hat on just to use it. I'm ready to pay for all your hard work. 😄

|
Embed
Progress spinner
Miraz
Miraz

@cdevroe That seems like a smart idea, with the new Help system. I just wanted to do what I could to make something useful. Under Help would be a logical place for it. @help

|
Embed
Progress spinner
Miraz
Miraz

@cdevroe Thanks for mentioning this, but I just visited that page on my Mac and copied and pasted a bunch of the code examples… ??

|
Embed
Progress spinner
jsonbecker
jsonbecker

@peterimoore I have done this work before, and would be happy to help. I’d for sure take it as a post on the Discourse (or write it up on custom) so that others can benefit.

It’s actually pretty easy to do most Jekyll themes, I’d imagine. But Hugo is easiest, where you really just have to add a few magic things to the header and you’re 95% there. My own site was originally a custom Hugo blog I tweaked a little to bring over to M.b.

|
Embed
Progress spinner
jsonbecker
jsonbecker

@peterimoore so for Hugo, all the official M.b themes are on the M.b GitHub. I basically just compared and figured it out. Some of those are forks from Jekyll that I think even have the diffs. While it’s true the template engines are different, they organizationally are accomplishing the same things so it’s 95% just small syntax tweaks.

|
Embed
Progress spinner
jsonbecker
jsonbecker

@peterimoore if you point me in the direction of one you like, I can peek at whether it’s one I think would be easy to convert and start blogging about the steps.

|
Embed
Progress spinner
jsonbecker
jsonbecker

@peterimoore quick look at tufte looks super easy, exception for the MathJax part I'm less sure of. The basic page/post layouts though are very straight forward and most of the work is in the css anyway.

|
Embed
Progress spinner
In reply to
jsonbecker
jsonbecker

@peterimoore looks like some folks from the R world already made a Tufte Hugo theme

This would work out of the box, though you might need/want to add this to the header:

<link rel="authorization_endpoint" href="https://micro.blog/indieauth/auth" />
<link rel="token_endpoint" href="https://micro.blog/indieauth/token" />
<link rel="micropub" href="https://micro.blog/micropub" />
<link rel="microsub" href="https://micro.blog/microsub" />
<link rel="webmention" href="https://micro.blog/webmention" />
<link rel="subscribe" href="https://micro.blog/users/follow" />
|
Embed
Progress spinner
cdevroe
cdevroe

@gregmoore The best part is, you won't have to pay. So long as you're a paying member of Micro.blog, Cypress will be free for you to use.

|
Embed
Progress spinner
cdevroe
cdevroe

@Miraz The code samples look like this

|
Embed
Progress spinner
SimonWoods
SimonWoods

@cdevroe @Miraz I'm seeing the same thing re: the code (Windows -> Firefox).

|
Embed
Progress spinner
jsonbecker
jsonbecker

@cdevroe @miraz I’ve had trouble with making sure M.b reads HTML as safe in code blocks and haven’t quite figured out an incantation to make it work consistently. Once I figure it out, I’ll share on custom/help.

|
Embed
Progress spinner