4 ms·
Do you not see the contradiction in advertising something as "friendly" and "made easy", then having the first "Simple" bullet be "Shipped as a Leiningen templa
by mrec 12y ago
Do you not see the contradiction in advertising something as "friendly" and "made easy", then having the first "Simple" bullet be "Shipped as a Leiningen template"?
You're pitching at (non-technical?) users who want a static site generator, and then assuming they're automatically Clojure developers.
- yogthos 12y agoIt doesn't require any Clojure knowledge to use. You simply have to install a build tool to run it. The site generation is configured entirely through config variables and templates are plain HTML.
- CJefferson 12y agoIf it doesn't require it, then don't use words you don't define in the first sentence of your webpage. I'm currently on the lookout for a static website generator (new year, new blog). This webpage is very off putting. The quick start guide -- install lenonwhatever, fine. The start new project? In what? When do I install your thing? Is your thing lenonwhatever?
- walterbell 12y agoJekyll + Liquid (from Shopify) works with Github Pages or any other host.
- yogthos 12y agoCryogen works for Github Pages as well and it's a lot easier to get running.
- yogthos 12y agoThe specific commands that you have to run are listed right on the front page. When you have lein installed, which involves grabbing the script and running it, then you simply run "lein new cryogen my-blog" and that's it. You now have your static site generator ready to go in the folder called "my-blog". You got to the folder and run "lein ring server" to serve the site locally and watch for any changes you make. It's literally a 3 step process. Not sure what part of it you found off putting specifically.
- CJefferson 12y agoYou forget I don't know clojure. How do I install cryogen? Neither the 3 step guide, or the terminal, are complete by themselves. I suspect you want people to do step 1 of your 3 step guide, then switch to the terminal, then switch back for step 3 of the 3 step guide? I would recommend making that clearer :) I like a guide I go through step by step, here it seems I have to follow nonlinearly.
- yogthos 12y agoIf you actually try following the steps you'll see that you don't actually have to switch around. :) Once you have leiningen installed and you run the 3 commands shown a browser window will automatically open up showing your site. The documentation has detailed instructions on how to customize and configure the site from there on.
- detaro 12y agoApparently, > lein new cryogen my-blog is "create a new project" and Leiningen will automatically look up what cryogen is on clojars.org and fetch the appropriate template, so you don't have to explicitly install cryogen. You really just have to install Leiningen and run the commands given in the box. But I also needed to look at the docs of the different parts to understand that, so definitively potential for improvement there. Also, it would be nice to find out the language immediately, outside of Clojure-space most people probably don't know what Leiningen is or that it has something to do with Clojure.
- detaro 12y agoA simple explanation that Leiningen is a build tool/package manager/whatever-it-is-exactly for Clojure and Cryogen is installed using it would go a long way in clearing any confusion. Please define tools you require people to use, especially if they do not follow absolutely obvious patterns.
- yogthos 12y agoThat's a great suggestion, I'll forward it on to the author. :)