SITE GUIDE
変更マニュアル
このサイトは全年齢のシチュエーションボイス専用です。初期表示は架空の作品を使ったデモです。DLsiteの作品・タグを自動取得する機能はありません。
1. 選び方
対象とフロアを選び、好みのタグを選択して「おすすめ3選を見る」を押します。タグはすべて一致する条件です。未選択の場合はタグで絞り込みません。該当作品から重複なしで最大3件を抽選します。もう一度押すと再抽選しますが、同じ結果になる場合もあります。番号は表示順であり、順位ではありません。
2. 作品データを用意する
DLsiteで確認した全年齢の音声作品について、次の項目をJSON形式で記入します。販売数は不要です。作品の本文・画像はコピーせず、タイトルなど必要な情報と作品詳細URLを登録します。タグは作品ページで確認した名称をそのまま記入してください。デモのタグは公式タグ一覧ではありません。
| 項目 | 入力内容 |
|---|---|
| id | 作品ごとの重複しないID |
| title / creator | 作品名 / サークル名 |
| audience | 男性向けは male、女性向けは female |
| floor | 全年齢は general、女性向け全年齢は female-general |
| ageRating / type | 全年齢の all / 音声作品の voice |
| tags | 文字列の配列。1作品あたり最大30個、各40文字以内 |
| url | 確認済み作品詳細ページのHTTPS URL。www.dlsite.com の home または girls 配下 |
登録用ひな形は空の作品リストです。以下は入力位置を示す例です。そのまま取り込まず、全項目を実際に確認した情報に置き換えてください。
{
"works": [
{
"id": "確認した作品ID",
"title": "確認した作品名",
"creator": "確認したサークル名",
"audience": "male",
"floor": "general",
"ageRating": "all",
"type": "voice",
"tags": ["作品ページで確認したタグ"],
"url": "確認した作品詳細のHTTPS URL"
}
]
}「ageRating: all」は登録者による確認事項です。作品ページの年齢区分を必ず確認してください。サイトは作品ページの内容を自動検証しません。
3. 画面で試す
- ひな形に作品を追加し、UTF-8のJSONファイルとして保存します。
- サイト下部の「作品データを登録・変更する」を開きます。
- 「作品JSONを読み込む」でファイルを選択します。
- 対象・フロア・タグで絞り込み、結果を確認します。
読み込み内容はこのページを開いている間だけ有効です。更新・終了すると元に戻ります。作品データはアップロードされません。エラーがある場合はファイル全体を取り込まず、前のデータを保持します。ファイルは5MB・10,000作品以内です。
4. サイト全体に反映する
配布ソースの dist/catalog.js を開き、window.KOE_CATALOG = null; の null を、作成したJSON全体に置き換えます。
window.KOE_CATALOG = {
"works": [ /* 確認済みの作品データ */ ]
};空の作品リストを設定するとデモではなく0件の状態になります。編集後はサイトを再公開してください。こえセレクトを作成したこのタスクに「この作品データで更新して」と依頼できます。公開済みサイトは手元のファイルを保存するだけでは変更されません。
5. 表示・タグ・抽選を変更する
| 変更したいもの | 編集箇所 |
|---|---|
| サイト名・説明・ボタン名 | dist/index.html の表示テキスト。ページの title と description も合わせて変更 |
| 色・余白・文字サイズ | dist/style.css。アクセント色は --blue |
| 作品・タグ | dist/catalog.js の作品データ。タグ候補は対象・フロアに一致する作品から自動集計 |
| 並び順・選出方法 | dist/app.js の drawWorks が抽選を担当。matchingWorks が条件一致を判定 |
作品の一部だけに抽選が偏らないよう、標準では候補全体をシャッフルして先頭3件を表示します。閲覧履歴や個人情報は使用しません。対象を変更すると対応するフロアに切り替わり、候補に存在しなくなったタグは解除されます。対象とフロアは別々の条件なので、登録内容によっては0件になります。
6. 変更後の確認
- 男性向け・女性向けで意図した作品が出ること。
- 複数タグがすべて一致すること。
- 候補が0件・1件・2件・3件以上のいずれでも正しく表示すること。
- 一度の抽選で同じ作品が重複しないこと。
- スマートフォンでも操作でき、作品リンクが正しいこと。
- 実データ表示にデモ作品や架空の数字が混ざっていないこと。