Kemal-by-example: Discover the Power of Kemal Through Practice

Learning Resources
1
2

What a work you did! The content deserves to be published as a book, IMHO, and I would be the first one to buy it.

Kemal by example - v2
Kemal by example - v21024Ă—1024 206 KB

3

Thanks a lot as always @paulocoghi :heart:

Those book covers look fantastic. I would definitely want to have those in my bookshelf for real :slight_smile:

4

I would definitely be interested in a book like this. I’m currently toying around with different static blog website ideas. I’ve been looking at Kemal and weighing it as an option. I stumbled across the hwaro project which is a neat hugo-like static website generator that works with Markdown written blogs.

I saw your examples page earlier had a blog which is perfect. Would be curious to see how difficult it would be to implement a markdown publish feature which is all I really need for what I have in mind.

5

Hi,

This shared repo couldn’t have come at a better time! I’m actually scheduled to give a Crystal presentation at my company soon, and I’ll definitely be using kemal-by-example to showcase some solid, real-world usage. It’s a fantastic resource.

I also want to echo the suggestion about turning this into a book. I think the community would benefit immensely from it. If you decide to go down that path, I’d be more than happy to dedicate some time to contribute and help out where needed.

Great work!

6

That’s great to hear. I’d be happy to help you around.

About the book, that sounds interesting. I’ve only done books via Gitbook so far, do you have anything other than that on your mind? If so just message me and let’s have a talk.

7

That sounds like a plan!

I’m actually currently translating the RailsGirls tutorials, as they cover many of the examples found in your repo. My goal is to adapt them for Kemal, Lucky, and Action-controller.

While the project is in French for now, I plan to translate it into English for the community. I’m also looking for a new name for this initiative; since my focus is specifically on onboarding developers to Crystal rather than the original social mission of RailsGirls, I want something more inclusive and language-centric.

I’ll reach out as soon as I have a solid draft so we can talk more about the book!

8

@sdogruyol and @JadeKharats one easy and professional platform is https://leanpub.com/

It is free to publish and you have freedom to decide on pricing. It also helps you in generating files that are ready-to-use in platforms like Amazon KDP, in case you want to sell physical copies.

9

@paulocoghi I was actually thinking about GitBook as I’ve already have Crystal For Rubyists and other 2 Turkish books there.

10

Thanks for the feedback! Of course you need to go with a tool that you are more familiar. The only point of attention is that GitBook PDF export is not “print-ready / KDP-ready” as in Leanpub

Also, exporting to PDF in Gitbook is only available in paid plans, while in Leanpub it is completely free.

An intermediary approach would be:

  • Gitbook for visual authoring and online publishing, as in Crystal For Rubyists
  • Gitbook Sync: integrate your Gitbook project with a Github repository (you can use a private repository as well)
  • Use the markdown in the repository to build your book (and sell) on Leanpub
  • (Optional) Generate a print-ready / KDP-ready PDF in Leanpub for on-demand physical self-publishing
11

I suggest asciidoc with the new crystal ports of the ruby gems