novel-support.js

【日本語 / English】

概要

このパッケージは、小説投稿サイトにある独自記法をWebサイト上で気軽に使うためのパッケージです。
最終目標は、このパッケージを使うだけで、小説投稿サイトからコピペした文章をそれっぽく表示させられるようにすることです。

特徴

• jQuery不要
• class属性で一括指定可能
• Sassでスタイル管理しているためCSSの変更が容易
• 小説投稿サイトにあるような独自記法を含んだテキストを下記のように変換
  • 字下げつき段落づけ：卵かけご飯 => <p class="ns_indent">卵かけご飯</p>
  • ルビ記法（|《》｜《》）：|卵《たまご》かけご|飯《はん》 => <ruby class="ns_ruby">卵<rt>たまご</rt></ruby>かけご<ruby class="ns_ruby">飯<rt>はん</rt></ruby>
  • 圏点記法：《《卵かけご飯》》 => <strong class="ns_emphasis">卵かけご飯</strong>

使用方法

パッケージマネージャーの場合

インストール

任意のパッケージマネージャーで置き換えてください。

pnpm i novel-support.js

動作準備

@import "node_modules/novel-support.js/dist/css/_novel-support.scss"

import novelSupport from "novel-support.js";

novelSupport('#id', {content: 'html'});
// または
novelSupport('.class', {content: 'html'});

// {content: 'html'}は省略可能（オプションで詳述）

CDNの場合

unpkgとjsDelivrにて提供。

CDN設置

<link rel="stylesheet" href="https://unpkg.com/novel-support.js/dist/css/novel-support.css">

<script src="https://unpkg.com/novel-support.js/dist/js/novel-support.js"></script>

または

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/novel-support.js/dist/css/novel-support.css">

<script src="https://cdn.jsdelivr.net/npm/novel-support.js/dist/js/novel-support.js"></script>

動作準備

novelSupport('#id', {content: 'html'});
// または
novelSupport('.class', {content: 'html'});

オプション

novelSupport()の第二引数には、{content}を指定できます。

変換対象がHTMLタグを含むなら{content: 'html'}と記述。何も記述しない場合は、デフォルト引数の{content: 'text'}が適用されます。
{content: 'text'}の場合はすべての変換処理が行なわれ、{content: 'html'}の場合は字下げつき段落づけが行なわれません。

テスト

pnpm test

過去の変更点

v1.1.1まではCHANGELOG.md。 以降はGitHub Release。

ライセンス

MIT

リンク

• CDNテストページ
• バグ報告