JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 1
  • Score
    100M100P100Q50022F
  • License MIT

PTNA (全日本ピアノ指導者協会) theme for Slidev

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (slidev-theme-ptna) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    PTNA Theme for Slidev

    全日本ピアノ指導者協会(PTNA)公式Slidevテーマです。

    特徴

    • PTNAブランドカラー: メインカラー #770000(深紅)を基調としたエレガントなデザイン
    • 音楽的な要素: 音符や五線譜などの音楽モチーフを随所に配置
    • 日本語フォント対応: ヒラギノ角ゴシック等の日本語フォントに最適化
    • 多様なレイアウト: プレゼンテーション用途に応じたレイアウトを多数用意(cover/default/section/intro/fact/quote/statement/two-cols/center/table-of-contents
    • レスポンシブデザイン: デスクトップ・モバイル両対応

    レイアウト一覧

    cover

    カバーページ用レイアウト。背景画像やグラデーションに対応し、音楽的な装飾要素を含みます。

    default

    標準的なコンテンツページ用レイアウト。ページ番号表示機能付き。

    section

    セクション区切り用レイアウト。大きなタイトルと装飾的な音楽要素でインパクトを演出。

    intro

    導入ページ用レイアウト。下部にピアノ鍵盤パターンの装飾。

    fact

    重要な数値や事実を強調表示するレイアウト。アニメーション付き音符装飾。

    quote

    引用文表示用レイアウト。五線譜と引用符を組み合わせた装飾。

    statement

    重要な宣言や声明用レイアウト。エレガントな枠線と角の音符装飾。

    two-cols

    2カラムレイアウト。中央の縦線に音符装飾付き。

    center

    中央配置レイアウト。背景に控えめな音符パターン。

    table-of-contents

    目次レイアウト。各項目の左に黒丸白字の連番バッジを自動表示し、マルチカラムにも対応します。

    使用方法

    インストール

    npm install @slidev/theme-ptna

    対応バージョン: Slidev v0.47 以上

    基本設定

    スライドファイル(slides.md)の冒頭に以下を追加:

    ---
    theme: ptna # or '@slidev/theme-ptna'
    highlighter: shiki
    lineNumbers: false
    info: |
      ## PTNAプレゼンテーション
      全日本ピアノ指導者協会のスライドテーマ
    drawings:
      persist: false
    transition: slide-left
    ---

    レイアウトの使用例

    ---
    layout: cover
    background: https://example.com/image.jpg
    ---
    
    # タイトル
    
    ## サブタイトル
    
    ---
    
    ## layout: section
    
    # セクションタイトル
    
    ---
    
    ## layout: default
    
    # 通常のコンテンツ
    
    内容をここに記載...

    カスタマイズ

    CSS変数

    以下のCSS変数を使用してカスタマイズできます:

    :root {
      --ptna-primary: #770000; /* メインカラー */
      --ptna-primary-light: #aa0000; /* ライトカラー */
      --ptna-primary-dark: #550000; /* ダークカラー */
      --ptna-secondary: #ffffff; /* セカンダリカラー */
      --ptna-accent: #000000; /* アクセントカラー */
      --ptna-gray: #666666; /* グレー */
    }

    フォント設定

    デフォルトで日本語フォントが設定されていますが、slidev設定でカスタマイズ可能:

    ---
    theme: ptna
    fonts:
      sans: "Hiragino Kaku Gothic ProN, Yu Gothic UI, sans-serif"
      serif: "Hiragino Mincho ProN, Yu Mincho, serif"
      mono: "Fira Code, monospace"
    ---

    目次レイアウト(table-of-contents)

    各スライドに応じて柔軟に目次を生成します。連番バッジは自動付与(1始まり)され、列をまたぐ箇所でも見切れにくいよう最適化しています。

    最小構成

    ---
    layout: table-of-contents
    ---

    主なプロパティ(frontmatter)

    • columns: 列数(デフォルト: 1)。例: columns: 2
    • maxDepth: 取得する見出しの最大レベル。例: maxDepth: 2
    • minDepth: 取得する見出しの最小レベル。例: minDepth: 1
    • mode: 取得対象。all | onlyCurrentTree | onlySiblings(デフォルト: all
    • listClass: 追加のクラスをリストへ付与(スタイルを局所的に上書きしたい場合に使用)

    カラム間隔をさらに広げたい場合(例)

    <style>
      .slidev-layout.table-of-contents :deep(.ptna-toc-list[style*="column"]) {
        column-gap: 6rem; /* Safari 対応なら -webkit-column-gap も */
      }
    </style>

    番号バッジを隠したい場合(例)

    <style>
      .slidev-layout.table-of-contents :deep(.ptna-toc-list > li::before) {
        display: none;
      }
    </style>

    ヘッダーの差し替え

    ---
    layout: table-of-contents
    ---
    
    ::title::
    
    # この発表の流れ
    
    ::
    
    任意の説明文をここに入れられます。

    備考

    • カラム切り替わり時の見切れを抑制するため、リスト項目は分割されにくいスタイルになっています。
    • ネストされた見出しは左ラインのみのシンプル表示(トップレベルに連番)。

    Mermaid 図表の利用

    本テーマは Slidev の Mermaid 対応を前提にそのまま利用できます。コードブロックに mermaid を指定してください。

    フローチャート例

    flowchart LR
      A[入会申込] --> B{資格確認}
      B -->|有資格| C[基礎研修]
      B -->|無資格| D[基礎講習]

    ガントチャート例

    gantt
      title 年間スケジュール
      dateFormat  YYYY-MM-DD
      企画 :a1, 2024-01-01, 2024-02-15
      実施 :a2, 2024-02-16, 2024-03-31

    シーケンス図例

    sequenceDiagram
      participant S as 生徒
      participant T as 講師
      S->>T: 予約の確認

    円グラフ(pieChart)例

    pie showData
      title 参加者構成
      "幼児・小学生" : 35
      "中学生" : 25
      "高校生" : 20
      "大学生" : 10
      "一般" : 10

    開発

    ローカル開発

    git clone <repository-url>
    cd slidev-theme-ptna
    npm install
    npm run dev

    ローカルテーマとして試す(このリポジトリ直下の theme-ptna/example.md を開くか、別の Slidev プロジェクトで theme: ./ を指定)

    ビルド

    npm run build

    プレビュー

    npm run preview

    ライセンス

    MIT License

    著者

    • 開発者: 保坂恵吾 (Hosaka Keigo)
    • メール: hosaka@piano.or.jp
    • 組織: 全日本ピアノ指導者協会

    貢献

    プルリクエストやissueの報告を歓迎します。

    不具合やご要望(例: 目次のスタイル微調整、Mermaidの見た目最適化など)があれば、Issueにてお知らせください。

    関連リンク