8 ms·

Show HN: Marmite – Zero-config static site generator

112 points by rochacbruno 2y ago

Just run `marmite` on a folder full of markdown files and get a full website/blog running in seconds. "I'm a big user of other SSGs but it is frequently frustrating that it takes so much setup to get started. Just having a directory of markdown files and running a single command sounds really useful. — marmite user."

khimaros 2y ago
any chance of this supporting wikilinks and back references?
- rochacbruno 2y ago
  Wikilinks is possible, already a feature of comrak parser, just have to enable it. Need to think about back references. In any case if the implementation is simple I would take a PR.
- rochacbruno 2y ago
  I just added support for wiki links and back references (internal) https://github.com/rochacbruno/marmite/pull/95 https://github.com/rochacbruno/marmite/pull/95
HenriTEL 2y ago
I did something similar a few months ago in python. One notable difference is that I got rid of the frontmatter, instead I use the commits history to find the creation and update dates of posts. https://github.com/HenriTEL/gitblog2 https://github.com/HenriTEL/gitblog2
- rochacbruno 2y ago
  Interesting, it would nice to have it as optional feature, I don't want it to be dependent on git, but if git is already there would be an option.
chaxor 2y ago
I really like it. I have been on a quest to find very simple ssgs such as this. I have been trying to out Zola, as mentioned in the readme, but I really want to make sure there aren't things like telemetry or other random features injected in or getting added (as seems to be the case with jekyll with ai-folio or academic pages) so it takes a while to go through everything. Ai-folio or academic pages is basically my use case or target, but I want something with zero javascript, which tends to be a bit hard in todays age.
- apitman 2y ago
  Have you ever written your own? Definitely worth it even just for fun.
- rochacbruno 2y ago
  You can start a new theme with marmite and remove the little JS it has to switch white/dark modes.
dang 2y ago
[stub for offtopicness]
- lowbloodsugar 2y ago
  You're gonna love it or hate it, no in between?
  - thih9 2y ago
    Context: > Marmite is a sticky, dark brown paste with a distinctive, salty, powerful flavour and heady aroma. This distinctive taste is represented in the marketing slogan: "Love it or hate it." Such is its prominence in British popular culture that Marmite is often used as a metaphor for something that is an acquired taste or polarises opinion. https://en.m.wikipedia.org/wiki/Marmite https://en.m.wikipedia.org/wiki/Marmite
    - FredPret 2y ago
      If you hate Marmite, try putting it on cheddar
      - rochacbruno 2y ago
        People hates it because everyone tries to use as ot was Nutella. Used in the right way, butter + marmite on a toast is awesome.
        johnchristopher 2y ago
        I have to google the definition of the marmite word in English because in my first language it means something like cauldron or pot. Definitely a faux-ami.
        FredPret 2y ago
        It comes in a little black (glass) pot - maybe that's where the name comes from
wokwokwok 2y ago
> cargo install marmite I'm not the only one (1) that believes this is wrong direction for cargo, and is abusing it's intent and purpose. If you want to distribute an application, there are lots of ways to do that. If it's a developer tools, for developers, `cargo install` might be suitable, sure... but I think there's a fair argument to be made that if you want a tool: git clone foo cd foo cargo install --path . Is an explicit, safe and less error prone way of doing it. ...and one that doesn't walk us down the road of (see the linked thread) the obvious desire people are going to have sooner or later to cache binary builds instead of building locally, and turn `cargo install` into some kind of binary application distribution application or app store. If you don't believe me, read that thread, and the linked thread. [1] - https://github.com/rust-lang/cargo/issues/13994#issuecomment-2143204956 https://github.com/rust-lang/cargo/issues/13994#issuecomment...
- CJefferson 2y ago
  I don't understand why your suggested version is more explicit, safer, or less error prone. You'll have to justify that to me! 'cargo install ripgrep' has worked on every machine I've run it on. It's also easy for me to send to other people I work with. Your suggestion requires me go and find the repository. If I just clone the repository it's going to get the current master branch, not the most recent release (which sounds less safe and more error prone to me!)
  - wokwokwok 2y ago
    Crates.io is a flat namespace. If you have to lookup the exact crate name (and you do, because otherwise you’re installing who-knows-what) what difference does it make? It’s just a lazy tool for lazy installs that only works when there are a) not that many people using it (easy memorable names that aren’t easy to mess up still exist), and b) no bad actors squatting on typo names. You can’t be more explicit than “build and install this folder I have”. /shrug
    - pdimitar 2y ago
      You also can't be more explicit -- and terse -- by running `cargo install ripgrep`. You said: IF you have to lookup the exact crate name. Well, for 90% of those I use, I don't have to. And it works just fine as your parent commenter said. You have a preference, cool, but don't try to push it as the better way in an objective sense because it's not. It's just one of the alternatives.
Turboblack 2y ago
[flagged]
- rochacbruno 2y ago
  "Works on PHP 8 without preinstalled frameworks" I like it, but it is not a static site generator, can't compare both things.
rochacbruno 2y ago
[offtopic] I just noticed that my original post title has been edited (not by me) and the part where it said `written in Rust` has been removed. I see other posts on the page showing `built with Python`, `Python based`, why `written in Rust` was not allowed? just curious.
toviahudson5 2y ago
[dead]

112 points by rochacbruno 2y ago

khimaros 2y ago

any chance of this supporting wikilinks and back references?

rochacbruno 2y ago
Wikilinks is possible, already a feature of comrak parser, just have to enable it. Need to think about back references. In any case if the implementation is simple I would take a PR.
rochacbruno 2y ago
I just added support for wiki links and back references (internal) https://github.com/rochacbruno/marmite/pull/95 https://github.com/rochacbruno/marmite/pull/95

HenriTEL 2y ago

I did something similar a few months ago in python. One notable difference is that I got rid of the frontmatter, instead I use the commits history to find the creation and update dates of posts. https://github.com/HenriTEL/gitblog2 https://github.com/HenriTEL/gitblog2

rochacbruno 2y ago
Interesting, it would nice to have it as optional feature, I don't want it to be dependent on git, but if git is already there would be an option.

chaxor 2y ago

I really like it. I have been on a quest to find very simple ssgs such as this. I have been trying to out Zola, as mentioned in the readme, but I really want to make sure there aren't things like telemetry or other random features injected in or getting added (as seems to be the case with jekyll with ai-folio or academic pages) so it takes a while to go through everything. Ai-folio or academic pages is basically my use case or target, but I want something with zero javascript, which tends to be a bit hard in todays age.

apitman 2y ago
Have you ever written your own? Definitely worth it even just for fun.
rochacbruno 2y ago
You can start a new theme with marmite and remove the little JS it has to switch white/dark modes.

dang 2y ago

[stub for offtopicness]

lowbloodsugar 2y ago
You're gonna love it or hate it, no in between?
- thih9 2y ago
  Context: > Marmite is a sticky, dark brown paste with a distinctive, salty, powerful flavour and heady aroma. This distinctive taste is represented in the marketing slogan: "Love it or hate it." Such is its prominence in British popular culture that Marmite is often used as a metaphor for something that is an acquired taste or polarises opinion. https://en.m.wikipedia.org/wiki/Marmite https://en.m.wikipedia.org/wiki/Marmite
  - FredPret 2y ago
    If you hate Marmite, try putting it on cheddar
    - rochacbruno 2y ago
      People hates it because everyone tries to use as ot was Nutella. Used in the right way, butter + marmite on a toast is awesome.
      - johnchristopher 2y ago
        I have to google the definition of the marmite word in English because in my first language it means something like cauldron or pot. Definitely a faux-ami.
        FredPret 2y ago
        It comes in a little black (glass) pot - maybe that's where the name comes from

wokwokwok 2y ago

> cargo install marmite I'm not the only one (1) that believes this is wrong direction for cargo, and is abusing it's intent and purpose. If you want to distribute an application, there are lots of ways to do that. If it's a developer tools, for developers, `cargo install` might be suitable, sure... but I think there's a fair argument to be made that if you want a tool: git clone foo cd foo cargo install --path . Is an explicit, safe and less error prone way of doing it. ...and one that doesn't walk us down the road of (see the linked thread) the obvious desire people are going to have sooner or later to cache binary builds instead of building locally, and turn `cargo install` into some kind of binary application distribution application or app store. If you don't believe me, read that thread, and the linked thread. [1] - https://github.com/rust-lang/cargo/issues/13994#issuecomment-2143204956 https://github.com/rust-lang/cargo/issues/13994#issuecomment...

CJefferson 2y ago
I don't understand why your suggested version is more explicit, safer, or less error prone. You'll have to justify that to me! 'cargo install ripgrep' has worked on every machine I've run it on. It's also easy for me to send to other people I work with. Your suggestion requires me go and find the repository. If I just clone the repository it's going to get the current master branch, not the most recent release (which sounds less safe and more error prone to me!)
- wokwokwok 2y ago
  Crates.io is a flat namespace. If you have to lookup the exact crate name (and you do, because otherwise you’re installing who-knows-what) what difference does it make? It’s just a lazy tool for lazy installs that only works when there are a) not that many people using it (easy memorable names that aren’t easy to mess up still exist), and b) no bad actors squatting on typo names. You can’t be more explicit than “build and install this folder I have”. /shrug
  - pdimitar 2y ago
    You also can't be more explicit -- and terse -- by running `cargo install ripgrep`. You said: IF you have to lookup the exact crate name. Well, for 90% of those I use, I don't have to. And it works just fine as your parent commenter said. You have a preference, cool, but don't try to push it as the better way in an objective sense because it's not. It's just one of the alternatives.

Turboblack 2y ago

[flagged]

rochacbruno 2y ago
"Works on PHP 8 without preinstalled frameworks" I like it, but it is not a static site generator, can't compare both things.

rochacbruno 2y ago

[offtopic] I just noticed that my original post title has been edited (not by me) and the part where it said `written in Rust` has been removed. I see other posts on the page showing `built with Python`, `Python based`, why `written in Rust` was not allowed? just curious.

toviahudson5 2y ago

[dead]