# Any bloggers to try Logarion?

**URL:** <https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878>\
**Category:** Community\
**Created:** [September 23, 2017, 5:25pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878 "2017-09-23T17:25:06Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![anon72795300](https://avatars.discourse-cdn.com/v4/letter/a/8e7dd6/32.png) [@anon72795300](https://discuss.ocaml.org/u/anon72795300)\
**Post date:** [September 23, 2017, 5:25pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/1 "2017-09-23T17:25:06Z")

</div>

[Logarion](https://gitlab.com/orbifx/logarion) is a blogging & note-taking application in OCaml.

Up for giving it a try? It’s still in alpha version, but would like to get some feedback. Let me know what you think.

[Screenshots](https://gitlab.com/orbifx/logarion/wikis/screenshots) of the dark and light stock themes.

---

<div class="post-metadata">

**Author:** ![anon72795300](https://avatars.discourse-cdn.com/v4/letter/a/8e7dd6/32.png) [@anon72795300](https://discuss.ocaml.org/u/anon72795300)\
**Post date:** [September 23, 2017, 7:31pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/2 "2017-09-23T19:31:21Z")

</div>

A good point by @antron on IRC: a live instance for people to check it out. There will be one coming.

---

<div class="post-metadata">

**Author:** ![cedlemo](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/cedlemo/32/1213_2.png) [@cedlemo](https://discuss.ocaml.org/u/cedlemo)\
**Post date:** [September 24, 2017, 5:58pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/3 "2017-09-24T17:58:03Z")

</div>

@anon72795300,

I am looking for an OCaml alternative to a local instance of jekyll for my personnal notes. Do you think that Logarion can be a good choice?

---

<div class="post-metadata">

**Author:** ![anon72795300](https://avatars.discourse-cdn.com/v4/letter/a/8e7dd6/32.png) [@anon72795300](https://discuss.ocaml.org/u/anon72795300)\
**Post date:** [September 24, 2017, 6:22pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/4 "2017-09-24T18:22:11Z")

</div>

Although I pressume Jekyll has more features at this stage, it is perfectly capable of making a usable blog. Do you want a statically generated one or a hosted service?

---

<div class="post-metadata">

**Author:** ![cedlemo](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/cedlemo/32/1213_2.png) [@cedlemo](https://discuss.ocaml.org/u/cedlemo)\
**Post date:** [September 24, 2017, 6:40pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/5 "2017-09-24T18:40:14Z")

</div>

Well, with Jekyll for example, I use the `jekyll serve -w` command that launches the buildin webserver in my userspace and serve the statically generated pages at [http://127.0.0.1:4000](http://127.0.0.1:4000). I want something simple to use and configure.

PS: I send you two Pull Requests for a missing dependency in your opam file and for install instructions of the binaries in your jbuild file.

---

<div class="post-metadata">

**Author:** ![anon72795300](https://avatars.discourse-cdn.com/v4/letter/a/8e7dd6/32.png) [@anon72795300](https://discuss.ocaml.org/u/anon72795300)\
**Post date:** [September 24, 2017, 7:00pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/6 "2017-09-24T19:00:10Z")

</div>

I don’t see any merge requests. Neither Gitlab (main repo) or Github. Has something gone wrong?

The web server is operational. After cloning, run `make webserver`. This will build `_build/default/src/logarion_webserver.exe` which is the webserver. It’s configuration (port etc) depends on `web.toml`, but you also have to configure `logarion.toml` which is the main configuration.

---

<div class="post-metadata">

**Author:** ![cedlemo](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/cedlemo/32/1213_2.png) [@cedlemo](https://discuss.ocaml.org/u/cedlemo)\
**Post date:** [September 24, 2017, 7:16pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/7 "2017-09-24T19:16:52Z")

</div>

The PR are :

- [https://gitlab.com/orbifx/logarion/merge\_requests/1](https://gitlab.com/orbifx/logarion/merge_requests/1)
- [https://gitlab.com/orbifx/logarion/merge\_requests/2](https://gitlab.com/orbifx/logarion/merge_requests/2)

> The web server is operational. After cloning, run make webserver. This will build \_build/default/src/logarion\_webserver.exe which is the webserver. It’s configuration (port etc) depends on web.toml, but you also have to configure logarion.toml which is the main configuration.

Ok, I will try it.

---

<div class="post-metadata">

**Author:** ![anon72795300](https://avatars.discourse-cdn.com/v4/letter/a/8e7dd6/32.png) [@anon72795300](https://discuss.ocaml.org/u/anon72795300)\
**Post date:** [September 24, 2017, 7:27pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/8 "2017-09-24T19:27:56Z")

</div>

Thanks for the contributions! For some reason Gitlab wasn’t showing notifications for it… strange.

Merged!

Let me know how you get on.

---

<div class="post-metadata">

**Author:** ![dudelson](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/dudelson/32/167_2.png) [@dudelson](https://discuss.ocaml.org/u/dudelson)\
**Post date:** [October 1, 2017, 4:44pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/9 "2017-10-01T16:44:47Z")

</div>

This looks cool! I also have been using jekyll for my blog, but I don’t know ruby, so it was also a little annoying to deal with. I will give this an in-depth look when I have a bit of time. Perhaps one day I will have a pure ocaml website… 😍

---

<div class="post-metadata">

**Author:** ![anon72795300](https://avatars.discourse-cdn.com/v4/letter/a/8e7dd6/32.png) [@anon72795300](https://discuss.ocaml.org/u/anon72795300)\
**Post date:** [October 1, 2017, 7:13pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/10 "2017-10-01T19:13:49Z")

</div>

Seems like I should target Jekyll for features and conversion guides. 🤔

I hope you get some time soon, really need some feedback on what people would like to see next.

---

<div class="post-metadata">

**Author:** ![anon72795300](https://avatars.discourse-cdn.com/v4/letter/a/8e7dd6/32.png) [@anon72795300](https://discuss.ocaml.org/u/anon72795300)\
**Post date:** [October 1, 2017, 8:12pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/11 "2017-10-01T20:12:03Z")

</div>

Btw, there is a channel you can come to lurk even if you are thinking of using Logarion:

[https://riot.im/app/#/room/#logarion:matrix.org](https://riot.im/app/#/room/#logarion:matrix.org)

You don’t need a Matrix account, just login as guest.

Other community links here: [https://gitlab.com/orbifx/logarion#community-support](https://gitlab.com/orbifx/logarion#community-support)

---

<div class="post-metadata">

**Author:** ![ivg](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/ivg/32/103_2.png) [@ivg](https://discuss.ocaml.org/u/ivg)\
**Post date:** [October 2, 2017, 10:21am UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/12 "2017-10-02T10:21:42Z")

</div>

Speaking of features, does Logarion have the OCaml syntax highlighting?

---

<div class="post-metadata">

**Author:** ![anon72795300](https://avatars.discourse-cdn.com/v4/letter/a/8e7dd6/32.png) [@anon72795300](https://discuss.ocaml.org/u/anon72795300)\
**Post date:** [October 2, 2017, 12:44pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/13 "2017-10-02T12:44:48Z")

</div>

Not in the HTML generator. I think at this stage it’s best to include a Javascript library that will do it on the client’s end, such as [https://highlightjs.org/](https://highlightjs.org/).

Would that satisfy your need?

---

<div class="post-metadata">

**Author:** ![ivg](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/ivg/32/103_2.png) [@ivg](https://discuss.ocaml.org/u/ivg)\
**Post date:** [October 2, 2017, 1:00pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/14 "2017-10-02T13:00:12Z")

</div>

Sure, as long as the OCaml code is highlighted 🙂 I don’t have any preferences on whether it should be rendered on a server side or a client side (though the client side looks more reasonable).

---

<div class="post-metadata">

**Author:** ![anon72795300](https://avatars.discourse-cdn.com/v4/letter/a/8e7dd6/32.png) [@anon72795300](https://discuss.ocaml.org/u/anon72795300)\
**Post date:** [October 2, 2017, 2:29pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/15 "2017-10-02T14:29:56Z")

</div>

I’ll write some docs on how to configure Logarion to do that.  
Could you open an issue as a reminder? (I prefer [Gitlab](https://gitlab.com/orbifx/logarion/issues/new), but there is also [Github](https://github.com/orbifx/logarion/issues/new))

It would be good at this stage if I had a list of issues with upvotes, to know what is in most demand.

---

<div class="post-metadata">

**Author:** ![Leonidas](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/leonidas/32/4039_2.png) [@Leonidas](https://discuss.ocaml.org/u/Leonidas)\
**Post date:** [October 3, 2017, 11:24am UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/16 "2017-10-03T11:24:53Z")

</div>

It is cool, but I am wondering how does it compare with [canopy](https://github.com/Engil/Canopy)? Maybe it would be nice to support the same format, so the canopy unikernel can use the logarion blog files?

Personally I am using jekyll and would like to go away from it. I tried porting the octopress default theme to hakyll some years ago and it was incredibly frustrating. I wonder how difficult it would be to get that ported to logarion?

---

<div class="post-metadata">

**Author:** ![anon72795300](https://avatars.discourse-cdn.com/v4/letter/a/8e7dd6/32.png) [@anon72795300](https://discuss.ocaml.org/u/anon72795300)\
**Post date:** [October 3, 2017, 1:44pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/17 "2017-10-03T13:44:56Z")

</div>

I can’t do a comparison with canopy. There are some features canopy has and I’m planning to implement in Logarion, such as support for Irmin and buildable as a unikernel. The note format seems similar, but one of the design aims of Logarion is to have a note-driven system, so there will be features which are probably not going to be supported by Canopy.

Where can I see the files provided by the default Jekyll theme? I’ll take a look and tell you.

Given Jekyll’s popularity, I might have to look into conversion guides and scripts.

---

<div class="post-metadata">

**Author:** ![Leonidas](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/leonidas/32/4039_2.png) [@Leonidas](https://discuss.ocaml.org/u/Leonidas)\
**Post date:** [October 3, 2017, 2:10pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/18 "2017-10-03T14:10:17Z")

</div>

> [@anon72795300](#):
>
> Where can I see the files provided by the default Jekyll theme? I’ll take a look and tell you.

The theme I mean is [here](https://github.com/imathis/octopress/tree/master/.themes/classic) I believe. One of the most useful things for me have been the generated pages per tag and overview of posts.

---

<div class="post-metadata">

**Author:** ![anon72795300](https://avatars.discourse-cdn.com/v4/letter/a/8e7dd6/32.png) [@anon72795300](https://discuss.ocaml.org/u/anon72795300)\
**Post date:** [October 3, 2017, 10:05pm UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/19 "2017-10-03T22:05:48Z")

</div>

Ok, had a look.

The current templates for Logarion are far fewer and simpler than Jekyll. For example there are no conditions in the templates just now, since Logarion uses [mustache- Logic-less templates.](https://mustache.github.io/mustache.5.html). There are only 5 template files, which you can see [here](https://gitlab.com/orbifx/logarion/tree/master/share/html_templates).

As for the stylesheets, both systems used Sass. Again Logarion has far fewer files, only two found [here](https://gitlab.com/orbifx/logarion/tree/master/share/sass).

So I’d say that it’s easy to get up to speed with how Logarion templates work and turning them into something you else, but porting the Octopress theme might be challenging. I’m here to help 🙂

What do you mean by generated pages per tag? Directories for each tag with copies of the posts in them?

---

<div class="post-metadata">

**Author:** ![Leonidas](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/leonidas/32/4039_2.png) [@Leonidas](https://discuss.ocaml.org/u/Leonidas)\
**Post date:** [October 4, 2017, 9:51am UTC](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878/20 "2017-10-04T09:51:03Z")

</div>

I see. I’m wondering if it wouldn’t be nice to have some more powerful templates like [Jingoo](https://github.com/tategakibunko/jingoo). Of course, putting more logic in templates is a slippery slope.

> [@anon72795300](#):
>
> What do you mean by generated pages per tag? Directories for each tag with copies of the posts in them?

Yes, so I can have a `ocaml` tag and then the blog would generate a page listing all `ocaml`-tagged pages on an overview by post date and generate a corresponding feed so people can subscribe to subsets of the blog.

[Next page](https://discuss.ocaml.org/t/any-bloggers-to-try-logarion/878.md?page=2)
