サモンピース攻略wiki

攻略記事 ›

このwikiを編集する

更新: wiki運営

GitHub のブラウザ画面だけで記事を書く・直す手順です。プログラムの知識は要りません。

このwikiは、GitHub に置いてある Markdown ファイルを Cloudflare が自動でウェブページに変換して公開しています。 つまり「記事を書く」＝「GitHub 上のファイルを書き換える」ことです。パソコンに何かをインストールする必要はなく、ブラウザだけで完結します。

準備するもの

  • GitHub のアカウント（無料で作れます）
  • このwikiのリポジトリへの書き込み権限。運営にアカウント名を伝えて招待してもらってください
  • リポジトリの URL: https://github.com/3478-ui/summoners-pieces-wiki

記事を新しく作る

  1. リポジトリのページを開きます
  2. フォルダをたどって src → content → guides を開きます。ここが記事の置き場です
  3. 右上の Add file → Create new file を押します
  4. 上のファイル名欄に、半角英数字とハイフンだけの名前を .md 付きで入力します（例: beginner-tips.md）
    • このファイル名がそのまま記事の URL になります。beginner-tips.md なら /guides/beginner-tips/ です
    • 日本語やスペースは使わないでください。/ を入力するとフォルダが作られてしまうので、これも使いません
  5. 大きな入力欄に、下の「先頭に書くこと（frontmatter）」と本文を書きます
  6. 右上の緑の Commit changes… を押します
  7. 出てきた画面で、必要なら Commit message に一言（例: 「初心者向け記事を追加」）を書き、 Commit directly to the main branch が選ばれていることを確認して、緑の Commit changes を押します
    • 公開する前に実際の見た目を確かめたいときは、ここでもう一方の選択肢を選びます。下の「公開前に見た目を確かめたいとき」を見てください
  8. 数十秒から数分で、サイトに反映されます。反映されないときは下の「困ったとき」を見てください

既存の記事を直す

  1. src/content/guides/ の中から直したいファイルをクリックして開きます
  2. 右上の鉛筆アイコン（Edit this file）を押します
  3. 直したら、新規作成のときと同じように Commit changes… → Commit changes を押します

他の人が書いた記事を直すときは、内容を大きく変える前にひと声かけると安心です。

先頭に書くこと（frontmatter）

ファイルの一番上に、--- で挟んだ「記事の情報」を書きます。この部分を frontmatter と呼びます。

---
title: 初心者が最初に覚えること
description: 最初の1週間で知っておくと楽になることをまとめました。
order: 10
updated: 2026-09-06
tags: [初心者向け]
draft: false
---
項目必須意味
title必須記事のタイトル。一覧とページの見出しに使われます
description任意一覧に表示される1〜2文の説明
order任意一覧での並び順。小さいほど上に出ます。書かないと 100 になります
updated任意更新日。2026-09-06 のように書きます
tags任意記事のタグ。[初心者向け, デッキ] のようにカンマ区切りで書きます
draft任意true にすると下書き扱いになり、サイトに出ません。書かないと公開されます

書くときの注意です。

  • title: のように、項目名の後ろの : は半角で、そのあとに半角スペースを1つ入れます
  • タイトルに : や # を含めたいときは、title: "注意: 最初に読んでください" のように " で囲みます
  • --- の行は半角のハイフン3つです。全角にしないでください
  • title が無いと、そのファイルだけでなくサイト全体の更新が止まります。必ず書いてください

本文の書き方（Markdown）

frontmatter の下に、普通の文章を書けばそのまま本文になります。よく使う書き方は次の通りです。

## 大きな見出し

### 小さな見出し

ふつうの段落です。空行を1つ空けると次の段落になります。

- 箇条書き
- 箇条書き

1. 番号付き
2. 番号付き

**太字** にしたいところを ** で挟みます。

[リンクの文字](/pieces/p65/)

> 引用や補足はこのように書きます。

| 見出し1 | 見出し2 |
| --- | --- |
| 内容 | 内容 |

見出しは ##（2つ）から始めてください。# 1つの見出しは記事タイトルとして自動で付くので、本文では使いません。

ピースへのリンク

各ピースには専用ページがあり、URL は /pieces/p65/ のように「p＋番号」で決まっています。

  1. ピース一覧から目当てのピースの詳細ページを開きます
  2. ブラウザのアドレス欄から /pieces/p65/ の部分をコピーします
  3. 本文に [剣士](/pieces/p65/) のように書きます

同じ要領で、効果ページ（/effects/斬撃/）や特性ページ（/traits/先制攻撃/）にもリンクできます。 どのリンクも、末尾の / を忘れないようにしてください。サイト内のリンクはすべて / で終わる決まりです。

画像を載せる

  1. リポジトリの public → img → guides フォルダを開きます
  2. Add file → Upload files で画像を置きます。ファイル名は半角英数字にしてください（例: deck-sample-01.png）
  3. Commit changes で確定します
  4. 記事の本文に ![画像の説明](/img/guides/deck-sample-01.png) と書きます

スマホのスクリーンショットはそのままだとファイルが大きいので、できれば幅 1000px 程度に縮小してからアップロードしてください。

デッキ記事の書き方

デッキ紹介は src/content/decks/ に置きます。記事とほぼ同じですが、frontmatter に pieces でピース名を並べます。

---
title: 白の回復デッキ（例）
author: あなたの名前
description: 回復を重ねて粘るデッキです。
updated: 2026-09-06
pieces:
  - 剣士
  - ソルジャー
  - ヒール
  - p83
tags: [白]
---
  • ピース名は詳細ページの表記そのままに書きます（例: 白魔導士）。p83 のような番号でも構いません
  • 名前が違っているピースは、ページ上に赤字で「見つかりません」と出ます。公開後に一度ページを見て確認してください
  • pieces の下の行は、半角スペース2つ＋-＋半角スペースで始めます
  • 本文には、デッキの狙いや回し方を自由に書きます。書き方のお手本としてサンプルデッキがあります

下書きにしておく

まだ公開したくない記事は、frontmatter に draft: true を書いておきます。 ファイルは保存されますが、サイトには出ません。公開するときは draft: false にするか、行ごと消してください。

src/content/guides/_template.md は記事のひな形です。中身をコピーして新しいファイルに貼り、draft: true の行を消して使ってください。

draft: true のファイルは公開サイトのどこにも出ないので、「下書きを他の人に見てもらう」用途には使えません。見た目を確かめてもらいたいときは、次の「公開前に見た目を確かめたいとき」の方法を使ってください。

公開前に見た目を確かめたいとき

GitHub の編集画面の上にある Preview タブで、見出しや箇条書きの見た目をおおまかに確認できます。 ただし、ピースへのリンクが正しいか、デッキのピースがちゃんと表示されるかまでは Preview タブでは分かりません。 そこまで確かめたいときは、公開せずに「確認用のサイト」を作ってもらう方法があります。

  1. 記事を書き終えて Commit changes… を押したあとの画面で、Commit directly to the main branch ではなく Create a new branch for this commit and start a pull request を選びます
    • 下にブランチ名の欄が出ます。最初から入っている名前（あなたのID-patch-1 のような形）のままで構いません
  2. 緑のボタン（Propose changes）を押し、次の画面でそのまま Create pull request を押します
    • これで「Pull Request（変更の提案）」ができます。この時点ではまだ公開サイトは変わりません
  3. 数十秒から数分すると、Pull Request のページに Cloudflare のボットがコメントを書き込みます。 その中の Branch Preview URL のリンクを開くと、あなたの変更を反映した確認用のサイトが見られます
    • コメントには Preview URL（保存のたびに変わる、英数字 8 文字の URL）と Branch Preview URL（https://＜ブランチ名＞.summoners-pieces-wiki.pages.dev の形。ブランチ名の記号は - に置き換わります）の 2 つが並びます。どちらを開いても同じ内容です
    • 確認用サイトはブランチごとに作られるので、他の人の作業には影響しません
  4. 直したいところがあれば、Pull Request のページの Files changed タブでファイルの右上の … → Edit file を押すか、src/content/guides/ のファイル一覧の左上（main と表示されているブランチの切り替え）であなたのブランチを選んでから、いつも通り鉛筆アイコンで編集して保存します。保存するたびに確認用サイトが作り直されます
  5. 問題なければ、Pull Request のページの Merge pull request → Confirm merge を押します。これが「公開」にあたり、数分で公開サイトに反映されます
    • Merge のあとに出る Delete branch は押して構いません（確認用のブランチを片付けるだけです）

運営に見てもらってから公開したいときも、この Pull Request を作ったところで止めて、URL を運営に伝えてください。運営が確認して Merge します。

やってはいけないこと

  • src/content/ と public/img/guides/ 以外のフォルダのファイルは触らないでください。特に src/lib、src/layouts、src/components、src/pages、src/data、package.json、astro.config.mjs を書き換えると、サイト全体が表示されなくなることがあります
  • 他の人の記事を丸ごと消さないでください。消したいときは運営に相談してください
  • ファイル名を後から変えると URL が変わり、他の記事からのリンクが切れます。変えるときは運営に一言お願いします

ピースのデータ（効果文・特性・❤ など）の間違いを見つけたら

ピースの詳細ページに出ている名前・属性・❤・特性・効果文と画像は、src/data/pieces.json と public/img/pieces/ から作られています。 このデータの間違いに気づいても、このwiki上では直さないでください。 これらのファイルは wiki の外にある「正本」から機械的にコピーされたもので、次にデータを更新したときに上書きされ、直した内容が消えてしまいます。

代わりに、運営に Discord で知らせてください。報告先: 【運営が記入: チャンネル名】

報告に入れてほしいこと:

  • どのピースか（詳細ページの URL、/pieces/p65/ のような「p＋番号」）
  • どの項目か（効果文・特性・❤・属性・画像 など）
  • 今のwikiの表示と、正しい内容。ゲーム画面のスクリーンショットがあると確実です

運営が正本の pieces.json を直してから npm run sync でwikiに取り込み、GitHub に保存（push）すると、数分でサイトに反映されます。

困ったとき

Commit したのにサイトが変わらない

たいていは frontmatter の書き間違いです。次を確認してください。

  • title: があるか
  • : の後ろに半角スペースがあるか
  • " で囲んだ文字の閉じ忘れがないか
  • --- が半角ハイフン3つになっているか
  • tags: [ の ] を閉じ忘れていないか

直して再度 Commit すれば、自動でもう一度公開処理が走ります。自分で見つけられないときは運営に声をかけてください。運営は Cloudflare の管理画面の Build log で、どのファイルのどの項目が原因か（例: title が無い）を確認できます。

書き換えてしまった内容を元に戻したい

GitHub のファイルページ右上の History を押すと、過去の版を見られます。そこから以前の内容をコピーして貼り直せば戻せます。 サイト全体を前の状態に戻したいときは、運営が Cloudflare 側で「Rollback」（前の公開状態に戻す操作）を行えますので、遠慮なく声をかけてください。

プレビューを見てから公開したい

上の「公開前に見た目を確かめたいとき」の手順で、公開せずに確認用のサイトを作れます。