project — プロジェクト生成

テンプレートから Quarto プロジェクトを作成する

概要

quarto-dsh project は、凍結されたテンプレートから Quarto プロジェクトを作成します。

使い方

quarto-dsh project <template> <name>

テンプレート一覧

quarto-dsh list-templates
ID 名前 内容
academic-paper 学術論文 HTML + PDF 同時出力、目次・節番号・コード折りたたみ
website-blog ブログサイト website + navbar + 検索 + OGP
revealjs-slides スライド発表 Reveal.js 形式
parameterized-report パラメータ化レポート params を使った動的レポート
project-default 基本設定 project.type 別の _quarto.yml 雛形

例: ブログサイトを作成する

quarto-dsh project website-blog my-blog
テンプレート 'ブログサイト' を /path/to/my-blog に展開しました:
  - _quarto.yml
  - index.qmd

生成された _quarto.yml:

project:
  type: website
  output-dir: _site

website:
  title: "データサイエンス日記"
  description: "Python と R によるデータ分析メモ"
  site-url: "https://example.com"
  navbar:
    background: dark
    left:
      - href: index.qmd
        text: Home
    right:
      - icon: github
        href: https://github.com/username
      - icon: rss
        href: index.xml
  open-graph: true

format:
  html:
    theme: cosmo
    code-fold: true

生成後にやること

  1. _quarto.yml の title / site-url を自分のものに書き換える
  2. 検証する: quarto-dsh lint my-blog
  3. レンダリングする: quarto-dsh render
  4. 公開する: quarto-dsh ci で GitHub Pages デプロイを追加

関連