Open dbriemann opened 6 years ago
@dbriemann Interesting idea, especially if combined with travisci. The problem I see is, that there is no way on GitHub to prevent other users from creating issues. Is there a way in glyph to only convert issues from a particular user to blog posts?
@breml There already is a solution in place for this problem. The main config.toml
has a Users
array that specifies which Github users are allowed to create Issues in the blog (other users can create issues too but they won't be rendered to html pages). Because of this it is also easy to do collaborations with Glyph.
The first user in this array always needs to be the repo owner (in this case it's my username dbriemann
).
@dbriemann Very nice. Instead of travisci one could also use AWS Lambdas for the automated updating of the blog. See https://aws.amazon.com/de/blogs/compute/dynamic-github-actions-with-aws-lambda/ This lambda could also do other stuff like closing issues from not allowed users.
@breml That looks intresting! It also told me about Github Webhooks which I wasn't aware of.. I will certainly have a look at all of this and take it into consideration for the automatic building feature of Glyph.
Super interesting idea @dbreimann. Would be cool to make use of issues tags and correlate them with Jekyll tags. Or simply uses them to mark issues as drafts/published.
@hobochild check glyph's issues. I think I have the draft idea covered. I will also add a feature issue for some tag management. I already had it in mind but forgot to write it down.
What exactly do you mean with correlating tags with Jekyll tags?
Another blog and another static site generator? In 2018? I know what you think but please read a few lines first if you made it this far. This one is a little different from previous static site generators.. I promise! Oh and by the way, you are just reading a Github issue!
First of all, the best time to start a blog must be when you release a static site generator.. so hey.. hello world! I will be writing occasionally about coding topics that I deem interesting and especially about making indie games as a solo-dev. As you might have realized this time it is not about games.. so what is it all about?
Glyph & Glyph-Zero
I just released the beta of glyph. It utilizes the great ecosystem of Github Pages and Github issues to author, export and host a static site. Tightly coupled with it is glyph-zero which is the origin template for all glyph powered sites.
Motivation
I got inspired by this blog which is entirely hosted on Github issues. At first I was a little confused because that is not the typical use case for issues. However there are clear benefits to it:
After presenting you the benefits there are also some drawbacks:
How it works
Glyph removes all of those drawbacks for you. It renders all of your open issues from one repository (your blog/site) to HTML and places them in your docs/ folder inside the repository. You then commit and push them all to Github and voila.. your site is published on Github pages with a custom theme and the content extracted from your issues. In addition an Atom feed file is generated and a link is ready to take the viewer to the comments section (on Github) of the issue for discussions. All links that point to other issues of the same repository are converted to links inside the blog, e.g. https://github.com/dbriemann/blog/issues/1 is now an internal link.
While glyph aims to be as simple as possible it allows you to fully customize your styling and scripts. glyph uses the mustache templating system. The default theme is used on this very blog. I'm not a designer but I gave my best here. If you make a new theme or improve upon the default theme please contact me or send a pull request on Github!
All instructions on how to use glyph can be found in the glyph-zero readme. It is a very simple and straight process so give it a try!
What's Next?
I am also open to ideas/improvements from you readers. Contribution of any kind is very welcome. Just keep in mind that glyph intends to stay easy for the user. Currently the glyph command has no options at all and I like it that way.