必要なソフトウェアをインストールし、GitHubからクローンして環境を整えます。必要なソフトウェアのインストール以下のソフトウェアは必須です。node.jsGitまた、エディターも必要です。Codeを推奨します。環境によって以下の操作をしてください。新しいフォルダーを作成し、以下の操作をしてください。gulp一般的なビルドです。distの一掃やスタイルやスクリプトの生成・更新をしないので、速くビルドできます。ローカルで確認ローカルサーバーを立てて内容を事前に確認できます。.config/debug-override.ymlで設定できます。実行し、緑色で表示されたlocalhostを含むアドレスにアクセスします。Pagesを使って自分のサイトとして公開してみましょう。GitHubでリポジトリを作成します。.config/default.ymlを編集し、自分のサイトの設定に合わせます。package.jsonも編集します。"コミットコメント"(コミットコメントにはわかりやすいものに)実際にアクセスして確認してみましょう。画像の登録(圧縮)maqzでは、画像は原則縮小・圧縮することになっています。filesフォルダー以下に置いたファイルには圧縮がかかります。theme/static/に置いたファイルは圧縮されません。設定は./config/images.ymlで行います。jpegなどのビットマップ画像)は以下のようになります(設定で変更可)。横幅が360pxのwebpSVGも圧縮しますが、png化などは行いません。image-prebuildFilesfiles以下の画像をすべて圧縮しなおします。圧縮の設定ページを編集するページを編集するには、pagesフォルダー以下にmarkdown(.md)、pug(.pug)、html(.html)を配置します。通常はこのディレクトリ構造のままファイルが公開されることでしょう。ファイルの先頭の---で囲んだ範囲をFrontMatterといい、Yaml形式でページに関する設定を行えます。titleはページのタイトル、descriptionはページの短い説明、themeは使用するテンプレート(後述)を指定します。pugファイルであれば、自身のFrontMatterはpage.attributesから参照できます。テーマを編集するthemeフォルダーにテーマがあり、編集できます。HTML(pug)templatesフォルダーにはテンプレートを配置します。この中にあるどのファイル名のpugを利用するかをFrontMatterのthemeで決定できます。指定しなければ、または存在しなければdefault.pugで処理を行います。ampはamp_を付加したものを利用します。ページをhtml化したものはmainHtmlとして格納されています。includes/_script.pugはページのpugをHTMLにするときに先頭に付加されます。.configフォルダー内の設定はsiteにまとめて格納されています。scripts/builder/registerer/base.jsを編集することでデータを簡単に追加できます。sass)sass形式で書かれています。main.jsを読みます。JavaScriptサイトに挿入するJavaScriptです。main.sassを読みます。ampはamp_mainを読みます。