https://github.com/pcrab/hexo-renderer-djot

Djot renderer plugin for hexo.
https://github.com/pcrab/hexo-renderer-djot

Last synced: 10 days ago
JSON representation

Djot renderer plugin for hexo.

• Host: GitHub
• URL: https://github.com/pcrab/hexo-renderer-djot
• Owner: Pcrab
• License: mit
• Created: 2023-04-12T08:56:47.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-04-05T13:43:55.000Z (9 months ago)
• Last Synced: 2024-11-07T01:28:48.030Z (about 2 months ago)
• Language: JavaScript
• Homepage:
• Size: 12.7 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Hexo Renderer Djot

Add support for [Djot](https://djot.net). It uses official [djot.js](https://github.com/jgm/djot.js)

to parse Djot files.

## Installation

``` bash

pnpm add hexo-renderer-djot

```

## Important Note

### Raw HTML

Djot do not support raw HTML in its source file, so the renderer will disable nunjucks since

they are not compatible.

If you want to add any HTML in your Djot file, you can use `Raw block` in Djot.

````plaintext

``` =html

some raw html

```

````


### Post Asset Folder

Since hexo version `6.1.0`, If trying to use both markdown and djot at the same time,

`post_asset_folder` must be set to `false`. Currently hexo depends on ext of `new_post_name`

to determine whether a file in `source` folder is renderable or not if `post_asset_folder`

is set to `true` to prevent render of asset files.

Its `false` by default, so you don't need to worry if you haven't set it before.

## Configuration

Currently only support setting katex output format.

``` yaml

djot:

    math:

        output: "html" | "mathml"

```