search

softprops / awesome-mdbook

🕶️🗃️ a card catalog of mdbooks for your reading curiosity
122 stars 17 forks source link

Add selected preprocessors, e.g. for emoji conversion #23

Open almereyda opened 3 years ago

almereyda commented 3 years ago

Finding this list, I was surprised to only find awesome mdbooks. My expectation would have been, that we also find useful preprocessors used in the wild.

Do we know other preprocessors "out there", eventually not on GitHub, that could help us and others, worth mentioning here?

almereyda commented 3 years ago

Nice preprocessors that are not mentioned by this list, are for example:

I'm especially looking for emoji conversion, as done with https://github.com/shonfeder/emojitsu#use-with-mdbook, and researched in https://github.com/mwunsch/rumoji/issues/52#issuecomment-890247251. But that can also become a new crate, based on

almereyda commented 3 years ago

The research in https://lab.allmende.io/yala/mdbook-emojis/-/snippets/418 now led to https://crates.io/crates/mdbook-emojis

Now could be a good time to select a few preprocessors for listing here, and to contribute a PR that implements this change.

softprops commented 3 years ago

I’m into it. The original idea was less about inputs for mdbook (plugins) but outputs (the books) themselves

a bookshelf of mdbooks if you will. I was enjoying reading them but hadn’t com across an index of them for discovery so I started this

almereyda commented 3 years ago

Nice. I like the awesome-mdbook-shelf idea.

In case you would like to diverge paths here, and keep that separate distinction, why not shift this project's identifier over a little, and have an awesome-mdbooks list, too?

I'd then be willing to fabricate an awesome-mdbook list from the available sources, that would be more technically oriented.

Else I'm always happy to keep content + form together, rather than apart, and contribute the findings here. Along the way, we might need to introduce categories already, too. #7

This work will be roughly based on these commits:

and some more from foraging the GitHub topic, search, my previous stars and within the Crates as well.

softprops commented 3 years ago

Whatever works for you is fine. I’m happy to accept pull requests

almereyda commented 3 years ago

Ok, that can happen some time soon'ish.

As a note to myself, we could also like to provide an mdBook template to the collection of GitLab CI/CD examples in https://gitlab.com/pages

There are plenty of GitHub Actions examples in some of the packages identified above.