mdbook-emojicodes

Crates.iomdbook-emojicodes
lib.rsmdbook-emojicodes
version0.3.0
sourcesrc
created_at2023-01-03 13:16:04.799858
updated_at2023-09-20 18:59:37.615064
descriptionMDBook Preprocessor for converting your emojicodes (: cat :) into real emojis
homepage
repositoryhttps://github.com/blyxyas/mdbook-emojicodes
max_upload_size
id750132
size41,383
Alejandra GonzΓ‘lez (blyxyas)

documentation

README

mdbook-emojicodes


mdbook-emojicodes is a MDBook preprocessor to replace your emojicodes (e.g. :cat:) to emojis. No more copy-pasting!

πŸ“¦ Installation

Using crates.io

$	cargo install mdbook-emojicodes

Manual installation

Clone the repo

$	git clone https://github.com/blyxyas/mdbook-emojicodes

Build & Install the preprocessor

$	cd mdbook-emojicodes;
	cargo install --path .

❓ Usage

Write this in your book.toml:

[preprocessor.emojicodes]

Now, ✨ It's ready to use! ✨.

You can use emojis by writing an emojicode in your files.

Example

<!-- my_chapter.md -->

# My :cat: cat journey

I love cats :cat: and dogs :dog:, I have two, one's gray, like a raccoon :raccoon:, and the other one is black, like the night :night_with_stars:.

This will render to:

<!-- my_chapter.md -->

# My 🐱 cat journey

I love cats 🐱 and dogs 🐢, I have two, one's gray, like a raccoon 🦝 and the other one is black, like the night πŸŒƒ

Now, when you run mdbook build, all your emojis will be converted.

🎑 Custom Emojis

You can use your own emojis as .svg files. Just create a directory called custom_emojis in src; there you can include your custom emojis, like this:

.
β”œβ”€β”€ book.toml
└── src
    β”œβ”€β”€ chapter_1.md
    β”œβ”€β”€ custom_emojis
    β”‚Β Β  └── myemoji.svg
    └── SUMMARY.md
# Chapter 1
:myemoji:

These emojis will be automatically sized to the correct size.


Stargazers

Stargazers repo roster for @blyxyas/mdbook-emojicodes

License

This software uses the MIT License. Check the file LICENSE for more details

Commit count: 21

cargo fmt