brandfy-guia-pdf

ブランドガイドをPDFにコンパイルする

運用手順

• 計画と進捗： ソース、テーマ、コンパイル、検査を計画します。
• 信頼できる情報源： BRAND.md、目次としての brand/README.md、リンク先のアセット、および pdf-build.md を読みます。
• 範囲と冪等性： デザインシステムを brand/pdf/ にコピーし、 編集可能なソースを変更したり、カスタマイズを上書きしたりせずにPDFを生成します。
• 検証： 再コンパイルし、リンク、ページ、画像、フォント、目次、および メタデータを確認します。
• 最終報告： ソース、PDF、使用したツール、警告を報告します。

フロー

1. BRAND.md が承認済みのバージョンであること、および相対リンク先が 存在することを確認します。

2. ローカルアセットをインストールまたは確認します。

   node <caminho-da-skill>/scripts/build-brand-guide.mjs \
     --project . \
     --install-assets
   

   このコマンドはCSS、テンプレート、Inter、Manrope、およびライセンスを brand/pdf/ にコピーします。 既存のファイルは保持されます。--force-assets は、インストール済みバージョンとの差分を 確認した後にのみ使用してください。

3. コンパイルします。

   node <caminho-da-skill>/scripts/build-brand-guide.mjs \
     --project . \
     --input BRAND.md \
     --output brand/brand-guide.pdf \
     --brand-name "Nome da marca"
   

4. コンパイラーはPandocを使用してセマンティックHTMLを生成し、WeasyPrintを使用して PDFを作成します。初回の確認で不足が判明した場合は、これらのツールをインストールします。

5. pdf-design-system: 1.0.0 の仕様を維持します。A4、明るい表紙、Manrope、 Inter、目次、編集用コンポーネント、およびページ番号が含まれます。テーマを重複させずに、 名前、ロゴ、説明、タグライン、およびリンクの色をカスタマイズできます。

6. PDFを開き、表紙、目次、改ページ、表、SVG、PNG、URL、 ヘッダー、フッター、およびドキュメントのプロパティを確認します。

7. Markdown、CSS、フォント、またはリンク先のアセットが変更されるたびに、 必ず再コンパイルします。

画像、表、またはテキストがPDFで正しく表示されない場合は、 brand/README.md、CSS、またはリンク先のアセットを修正します。再コンパイルし、該当ページを 開いて調整を確認します。PDFを直接編集しないでください。

専門家の考察

PDFは独立したドキュメントではなく、正規のソースを表現したものとして扱います。読みやすさ、 ナビゲーション、教育的な流れ、再現性、アクセシビリティ、およびアセットの追跡可能性を評価します。 技術的なエラーなしでコンパイルできても、例が隠れていたり、ルールとその文脈が分断されていたり、 表が読みにくくなっていたりすれば、完成とはいえません。