Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
ja/tutorials を現行（2026年想定）の Vivliostyle CLI + CSS 前提の手順に更新し、旧 Create Book / SCSS 前提の説明やリンク不整合を整理するPRです。
Changes:
- チュートリアル手順を Create Book から Vivliostyle CLI（
npm create vivliostyle@latest）中心へ更新し、Node 要件も更新 - SCSS 前提の説明・サンプルを CSS 表記へ置換し、CSS Custom Properties を使ったカスタマイズ例へ整理
- 章間リンク、配布用ダウンロードパス、VFM ドキュメント参照リンクを最新系へ修正し、配布用
theme.cssを追加
Reviewed changes
Copilot reviewed 12 out of 12 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| ja/tutorials/install.html | Node 要件とエディタ案内を現行化 |
| ja/tutorials/create-publications.html | 雛形作成を Vivliostyle CLI（npm create vivliostyle@latest）前提へ更新 |
| ja/tutorials/customize.html | SCSS 前提の説明を削除し、CSS（Custom Properties）中心のカスタマイズ手順へ更新 |
| ja/tutorials/configure-page-text.html | SCSS 記述箇所・配布物参照を theme.css 前提へ更新 |
| ja/tutorials/configure-counters-running-heads.html | SCSS ネスト例を CSS セレクタへ変換、表記とリンク文言を更新 |
| ja/tutorials/configure-basic-elements.html | SCSS ネスト例を CSS セレクタへ変換、配布物参照を theme.css 前提へ更新 |
| ja/tutorials/create-table-of-contents.html | SCSS ネスト例を CSS セレクタへ変換、配布パスと前リンクを修正 |
| assets/tutorials/ja/create-table-of-contents/manuscripts/honbun.md | VFM ドキュメント参照リンクを docs.vivliostyle.org/ja 系へ更新 |
| assets/tutorials/ja/configure-page-text/manuscripts/honbun.md | VFM ドキュメント参照リンクを docs.vivliostyle.org/ja 系へ更新 |
| assets/tutorials/ja/configure-page-text/theme.css | 配布用 CSS を追加 |
| assets/tutorials/ja/configure-counters-running-heads/theme.css | 配布用 CSS を追加 |
| assets/tutorials/ja/configure-basic-elements/theme.css | 配布用 CSS を追加（※要修正点あり） |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
…ctual behavior - create-publications: replace old interactive prompts (description/author-email/license/choose-theme) with actual v10 clack-style prompts (title/author/language/theme/install-deps) - create-publications: remove duplicate bunko.md line in npm run build output - customize: convert all vivliostyle.config.js examples from CommonJS to ESM (module.exports → import defineConfig / export default defineConfig) - customize: fix theme install path themes/packages/@vivliostyle/ → node_modules/@vivliostyle/ - customize: update custom theme copy destination dir structure accordingly - create-table-of-contents: convert config examples from CommonJS to ESM
…ial ② Minimal template scaffolds an empty manuscript.md, not bunko.md. Replace all references to bunko.md and 銀河鉄道の夜 sample content with manuscript.md and a generic sample, including build output and preview edit example.
Comprehensive review of create-publications.html against actual CLI source code revealed 14+ issues including incorrect prompt messages, wrong build output format, screenshot/text mismatch, and tutorial quality concerns. This plan restores 銀河鉄道の夜 as sample content and fixes all terminal output examples.
… basic-ja template
… update TODO - Tutorial ② (create-publications): add new build-cover/toc/body screenshots, update preview1/preview2 - Tutorial ④ (configure-page-text): retake all 9 screenshots (reset, margin, break-before, writing-mode, text-indent, text-align) - Add TODO for updating legacy download assets (mytheme.zip with SCSS, CommonJS config) - Update screenshots-todo.md checklist Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Retake preview-table-of-contents1.png (auto-generated TOC, horizontal writing) - Retake preview-table-of-contents2.png (manual TOC with leader lines, horizontal writing) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- vivliostyle.config.js: convert CommonJS (module.exports) to ESM (import/export) - mytheme.zip: replace SCSS files with plain CSS (theme_common.css only) - Applies to tutorials ④ and ⑦ Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…ve writing-mode section - Tutorial ②: add 5 English screenshots (build-cover/toc/body, preview1/preview2) - Tutorial ④: add 8 English screenshots (reset, margin, break-before, text-indent, text-align) - Tutorial ④: remove writing-mode section (not applicable for English) - Add English manuscript files and download assets for tutorial ④ Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…d tutorial7 - Heading Numbers: remove counter2/counter3, keep counter1 only - Page Numbers: add CSS code example, move counter2 here, add target-counter() note pointing to tutorial7 - Counter References: remove section - tutorial7: remove outdated article reference
- tutorial4 ja/en: remove outdated article reference in Page Start Side section - tutorial5 ja: fix next-tutorial description (was describing tutorial5 itself) - tutorial5 en: add Named strings / Running elements section to Running Head Style - tutorial6 en: update Endnote Styles → Footnote Styles with dpub format - goal list, section title, description, config snippet, CSS selector (.footnotes → .footnote) - tutorial7 ja: 後注 → 脚注, #footnotes → #footnote (dpub format) - tutorial7 en: Endnotes → Footnotes, #footnotes → #footnote (dpub format)
- add goal list item for target-counter() - add explanation paragraph before the CSS block describing target-counter(attr(href), page)
- ja: 目次の手動作成 → 目次の手動作成とカウンタの参照 - en: Manual Table of Contents → Manual creation of table of contents and reference to counters
- add goal list item for counter references - Page Numbers: remove the sentence pointing to tutorial7 (moved to new section) - add new section 'カウンタの参照' / 'Counter References' after Page Numbers - explain target-counter() with figure number example (CSS + Markdown) - add preview-counter3.png reference - close with note that tutorial7 uses target-counter() for page numbers in TOC
…ial5 (ja/en) - ja: チュートリアル7 → チュートリアル⑦ - en: Tutorial 7 → Tutorial ⑦
- use '参照：[title（site name）](url)' format for ja - use 'Reference: [title (site name)](url)' format for en - tutorial3: Vivliostyle CLI docs → (docs.vivliostyle.org) - tutorial4: libroworks.co.jp, Vivliostyle Blog annotated - tutorial5: MDN Web Docs, W3C annotated - tutorial7: Vivliostyle CLI docs → (docs.vivliostyle.org)
- This CSS example was added without user's explicit request - Remove 'たとえば次のように...' sentence and h1::after code block - preview-counter2.png target to be reconsidered
- # 後注 {#footnotes} → # 脚注 {#footnote}
- 後注はインライン → 脚注はインライン
… code examples - Remove preview-counter2.png and preview-counter3.png (ja/en) - Add target-counter() page number reference CSS + Markdown example to Page Numbers section (ja/en) - Remove image references from Counter References section (ja/en)
…d dpub footnote format Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Download buttons in en tutorials 4-7 linked to files that did not exist. Provide theme.css for each tutorial and manual-TOC config + manuscripts.zip + mytheme.zip for tutorial 7. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This file was not referenced from any tutorial page. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Member
Author
|
以下の修正をしました。ご確認ください。 レビューコメント対応#1 「Vivliostyle Viewer で CSS 組版ちょっと入門」古記事参照の削除
#2 「柱のスタイル」に Named strings / Running elements の紹介追加
#3 「後注のスタイル」→ 「脚注のスタイル」（dpub 形式）
#4 「1.1章」→「§1.1」形式のスクリーンショット差替
コメントとは無関係の修正
|
Member
日本語の assets/tutorials/ja/configure-basic-elements/preview-footnote1.png |
…k-reference description Replace ja preview-*.png in configure-basic-elements with captures taken in dpub footnote mode (matches en). Also correct the back-reference glyph description: VFM dpub outputs the footnote number as superscript, not an arrow. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…yles The Footnote Styles section showed two image references that resolved to the same dpub-mode capture, producing visually identical adjacent images. Drop the second reference and the now-unused PNG in both ja and en. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Same situation as preview-footnote2: the second image reference resolved to a duplicate of preview-figure1, with no caption distinguishing the two. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…/en) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Member
Author
|
@MurakamiShinyu ご指摘ありがとうございます。以下の修正を行いました。 ご指摘への対応ja の preview-footnote1.png / preview-footnote2.png が pandoc形式のまま
関連して見つかった問題への対応戻りリンク記号の説明が実装と不一致
「脚注のスタイル」「画像のスタイル」セクションで同一画像が2枚並んでいた
その他の修正前提条件にCLIバージョン追記
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Changes
Japanese tutorials
English tutorials
/tutorials/配下）🤖 Generated with Claude Code