Site tools

Written together

Leave what you know for the next KAMITSUBAKI fan.

A corrected word, a reliable source, a more accurate translation: each makes the next visit a little better. Start with one small change to an article you know.

Choose a contribution workflow

Use the editor to create or edit articles and attach images. Use GitHub for announcements and other repository files. Both workflows require maintainer review.

Your first in-site submission

Sign in to the Wiki with GitHub or Google. No token setup or manual branch creation is needed.

Encyclopedia entities and articles in Simplified Chinese, Japanese and English are supported. Traditional Chinese is generated. New articles and PNG, JPEG or WebP attachments are supported; announcements still use GitHub.

  1. Sign in and load the original

    Choose Edit existing article. Search by title or path, filter by type and verify the language. You can also follow an article’s editing link. Wait for loading to finish; back up your current draft before replacing it.

  2. Create articles and add images

    Choose New article from the File menu to select a type, language and folder, then complete Article properties. In Images, select, drop or paste images and provide their source. Insert them into the article or use them as a cover. Images stay local until submission and share the same PR: up to 8 images, 4 MB total, 750 KB per original, without compression. Use GitHub for larger originals; see the image and file guide.

  3. Write and preview

    Desktop opens with writing and live preview side by side; on mobile, switch between the Edit and Preview tabs. Select text for bold, links, ruby or spoilers. Click Insert or type / in an empty block for the searchable menu near the cursor; use arrow keys, Enter and Escape. ⌘ K opens the global command palette. Enter creates a paragraph; Shift+Enter adds a line break. Use the list buttons or type - space / 1. space. Enter continues a list; Enter on an empty item exits; Tab / Shift+Tab changes nesting.

  4. Check properties and sources

    Verify names, dates and the entry key in Properties. Keep the path and id intact. Cite sources that directly support new facts. Focus mode gives you more writing space; Preview helps check links, tables and complex content.

  5. Save and compare

    Browser drafts stay on this device. The submission panel lets you manually save and restore cloud drafts for your account, retained for 90 days. Image drafts stay local; back up important Markdown and keep original images separately. Review the diff for accidental deletions.

  6. Submit for review

    Describe what changed and why, and provide sources. The site creates a GitHub PR for you. Submitted content and descriptions are public. Saving is not submitting, and submitting is not publishing.

  7. Follow up

    Open Submissions and comments for status, checks and review discussion. Continue editing to update the same PR; compare both versions when a conflict occurs. Withdrawal closes the PR and keeps its history. Comments are read-only here; reply and review on GitHub. Publication follows merge and deployment.

Uploading larger originals or managing branches yourself? Use the GitHub workflow and image guide.

Submit through GitHub

For Markdown edits, new articles, authorized images and other repository files. You can also use the visual editor to write and export the file.

  1. Prepare a branch

    Sign in to GitHub and edit the target file. Fork when prompted if you have no write access; otherwise still commit to a new branch.

  2. Edit and check

    Preserve YAML, entry keys and sources. Edit Markdown directly or paste the complete file exported by the visual editor. Upload actual image files; a local path alone is not an upload.

  3. Open and follow up on a PR

    Target the original repository’s main branch. Describe changes and sources, wait for checks and review, and push revisions to the same branch. Publication follows merge and deployment.

Choose one small contribution

Pick a direction you know, then follow the six steps. Times are approximate; save a draft and return whenever you need.

Your starting pointRead the original first and change only what is needed. A factual correction also needs a source.

See the relevant steps →

Your first contribution, in six steps

Open a step and try it. Completion marks are your own checklist; they never submit an edit.

Choose one change

Set a small goal and find evidence for it.

Read the relevant paragraph in an artist, song, album, project or event article. Describe your proposed change in one sentence.

A typo, an official link or a sourced date is a good first contribution. A complete rewrite or a synchronized lyric timeline can wait. Replacing “recently released” with a confirmed release date needs the actual announcement; a punctuation fix does not need an unrelated citation.

If you have no article in mind, browse the song directory. You can also report a specific problem through Issues at the bottom of this page.

You can describe the change in one sentence and support any factual change with a source.

Load the existing article

Keep its original details and content.

  1. Select Edit source on an article. This guide will show its file path above.
  2. Choose Open visual editor to load supported article types. If there is an existing draft, back it up before agreeing to replace it.
  3. Alternatively, choose Edit existing article in the editor, search by title or path, then Load original.
  4. Check the title, content and language: zh.md, ja.md and en.md mean Simplified Chinese, Japanese and English.

If loading fails, retry or get the complete Raw file from GitHub. Import source accepts pasted source or a .md file up to 1 MB. Include the information between both --- lines.

Guides, announcements and homepage copy are outside the editor’s five supported collections. Use the GitHub link for those files.

The editor contains the correct article and language, not a blank replacement for an existing file.

Make the edit visually

Use familiar text tools; insert other content when needed.

Click a paragraph and type. Body headings start at level 2; the page title has its own field.

Your goalControl
Bold, italic or a linkSelect text and use the top or floating toolbar
Highlight, ruby or a spoilerUse the corresponding toolbar item and fill any requested details
Heading, list, image or tablePress / in an empty paragraph, or choose Insert content
Adjust a blockSelect it and open its Properties
Reorder contentUse the block’s move up/down controls or drag handle
Find text or a chapterUse Find in document or Outline
Change title, date or other detailsArticle details in the left Properties panel

Try adding a source: select the words “official announcement”, choose Add link, enter the real URL and apply it. Check the result in Preview.

A Preserved source block contains complex markup. Keep it unless you need to edit that section. Use Source and the syntax reference for a narrow change; fix any YAML parsing error before returning to Visual. Do not delete unknown details to dismiss an error.

Preview shows only the intended change, with the heading structure and complex content intact.

Continue to the next step →

Keep the evidence beside the fact

Make it possible for another reader to verify your work.

Use official work pages, announcements, published interviews or publications for dates, credits and event details. Link the specific page supporting the nearby sentence, not just a homepage.

Keep opinions attributed: “I love this song” does not support “critically acclaimed.” Search snippets, AI answers and fan speculation are not substitutes for sources.

  • Check names and dates against the source.
  • Check image sources and permission, and preserve existing license fields. An image URL in the editor does not upload an image file.
  • Preserve the original, translator credits and attribution for quotes, translations and lyrics.
  • Leave uncertain facts out and explain missing evidence in the PR.

AI may help clarify writing, organize sources you supply or explain an error. You still need to verify each claim; do not ask it to invent credits, interpretations or lyric timings.

Every new factual claim has direct support, and attribution and license details remain intact.

Continue to the next step →

Preview, check and export

A browser draft has not been submitted to the site.

  1. Read Preview from beginning to end. Check headings, links, captions, tables and disclosures. On smaller screens, use the bottom Preview control.
  2. Open Before you export and complete required fields. Field validation cannot determine factual accuracy.
  3. Check the autosave status. A draft saved in this browser is not synced to other devices; download important work.
  4. Choose Export Markdown → Copy complete Markdown or Download .md. The export includes the article details at the top.
  5. With a valid path, the same menu provides Open file location on GitHub. Paste the complete file into the correct editor, preserving its metadata.

Review Preview / Changes or the diff on GitHub. GitHub may not render this site’s ruby, media or lyric syntax; use the site preview for those and let the build checks verify the final file.

You can download an unfinished draft and return later. Do not invent required information just to clear a warning.

You have a backup, the complete metadata, and a diff containing only your intended changes.

Continue to the next step →

Send the change for review

A Commit saves work; a Pull Request asks for review.

New to GitHub? Create an account and verify your email when you are ready to submit. A free account is sufficient for public contributions; you can practice in the editor first.

  1. Without write access, GitHub guides you to a Fork, a copy under your account.
  2. Paste and inspect the change, then choose Commit changes… / Propose changes. Write a short description of the actual edit. A Commit is a saved change, not the PR itself.
  3. Continue to Compare & pull request / Create pull request. The base repository should be LinkTh1rsty/kamitsubaki-wiki-site, using the development branch currently designated by the maintainers; the comparison comes from your edited branch.
  4. Add a clear title and describe changes, sources and checks with the template below. Create the PR. A numbered Pull Request page confirms it has been submitted.

Checks run automatically. Wait while they run; open the error details if they fail. Passing checks still leaves human review. If a reviewer requests changes, edit the same branch in your Fork and Commit again; the existing PR updates automatically.

Merge adds the change to the main branch; the live site still needs a successful deployment. PRs and commits retain contribution history, while on-site contributor information may update later.

Button wording may change. See GitHub’s web editing guide and PRs from a Fork.

You have a numbered PR with a clear explanation and sources, and know where to read feedback.

A PR description you can fill in ↓

Find your way around the editor

These are the controls in the current article editor. Write beside the preview on desktop; switch panels as needed on smaller screens.

Left · Find your place
Articles searches titles and paths. Outline jumps to headings. Properties holds article type, language and details.
Center · Write
Edit text directly. Select words for formatting; press / in an empty paragraph or choose Insert content for blocks.
Right · Preview and adjust
Preview shows the result. Select a block and use Properties to adjust images, tables or lyrics.
Bottom and top right · Check and export
Check autosave and Before you export at the bottom. Export Markdown copies the full file or downloads a .md draft.

Learn more when your edit needs it

New articles, translations and lyrics have different checks. You do not have to learn them all at once.

Create a song, album or another article

Search first, then prepare the evidence and location.

Search titles and aliases on the site and in the editor. Expand an existing article if possible. For a missing entry, use New article at the top of Outline, then select type and language in Properties. Download any draft before replacing it.

Required fields differ across the five types; use Before you export. Set the title and entry key, gather sources, then add sections with actual content rather than empty headings.

  • Songs use src/content/songs/<primary performer or collaborations>/<id>/<locale>.md, derived from performers.
  • Releases use src/content/releases/<releaseType category>/<id>/<locale>.md.
  • People, units and projects derive their paths from entity type and the approved classification map. Do not copy retired artists/ or albums/ templates or guess a directory.

These names are examples; replace them with real IDs before submitting. Verify song artist, category and credits; verify album release details, track order and song references. Upload repository images separately and use the corresponding URL.

Expand GitHub file path (optional) in the left Properties panel and enter the full path, including the language filename. The export menu can then open GitHub’s new-file location; entering the path alone does not create a file.

Language files share one stable id and consistent entity/relationship fields. Prepare zh.md, ja.md and en.md; if a version needs help, explain that in the PR instead of presenting untranslated text as complete. Let the editor derive an uncertain path from metadata or consult the content directory guide.

Syntax and properties →

Translations and Traditional Chinese

Keep identity, meaning and attribution aligned.

Load the existing target-language file and compare it with the original. The language selector does not translate the text. Do not change only the locale and overwrite another version.

Keep the same stable id, entityType and relationship identities across versions, with consistent dates and catalog numbers. Prefer official names and explain uncertain translations in your PR.

Traditional Chinese is generated from Simplified Chinese. Edit zh.md, not generated zh-tw.md or zh-hk.md. For regional wording, consult the conversion section of the syntax reference or Chinese variant wording in the toolbar’s “···” menu.

Preserve original lyrics, translator credits and license details. Improving one phrase is enough for a first edit.

Syntax and properties →

Lyrics, ruby and practice mode

Align one line before adding a timeline.

Insert Bilingual lyrics and use Properties for the original, kana, romaji and translation. Preview a single line first, then continue. Ruby text can annotate words in ordinary prose.

For synchronized lyrics, listen to the matching recording and enter the line’s start time, such as 00:03.50. Add timed units only when you can verify each timestamp. Times must increase and translations must match the original lines. Without accurate timings, leave them blank for untimed lyrics; never divide the duration evenly or ask AI to guess.

Reader practice can switch kana, romaji and translations and step through lines. Correct source structure makes those views work. After merge, check the reader and audio synchronization too; an editor preview is not full playback verification.

Complex lyric HTML is preserved. Back it up before a source edit and follow the synchronized lyric reference without removing credits or copyright notes.

Syntax and properties →

Source, media and local development

Go further only when your change needs it.

Source contains a complete Markdown file: YAML information between the two --- lines, then the body. Keep unknown fields and preserved complex markup intact.

Use Media or Media switcher with real links from supported platforms. Adding an image URL does not upload a file. Insert content also offers tables, disclosures, code and equations; consult the reference when needed.

Experienced Git users can Fork, create a branch and edit locally. Follow the repository README for setup, then run pnpm check, pnpm test and pnpm build, and inspect the actual page. Browser contributors do not need these tools; report honestly which checks you performed.

Edit the guides themselves through their GitHub source link, preserving YAML and updating the relevant language editions.

Syntax and properties →

Look up as you work

One last check before review

  • Correct article, language and scope
  • Sources and working links; credits and licenses intact
  • Preview checked; original fields and complex content preserved
  • Draft backed up and GitHub diff reviewed
  • PR describes actual checks and unresolved questions

A PR description you can fill in

Replace the bracketed prompts with your actual work. Only claim checks you performed.

If you get stuck

What can I do without a GitHub account?

You can sign in to the Wiki with Google and submit existing-article edits in-site. A GitHub account is needed only for the direct GitHub workflow. You can also edit and download a local draft without signing in.

My draft is saved. Why has the website not changed?

Saving a draft does not publish it. Submit for review in-site, or create a PR through GitHub. Both require review, merge and deployment. Browser drafts stay on this device; cloud drafts are saved manually in the submission panel.

I cannot find or load the file.

Check the language and path, then search Edit existing article. You can import the complete Raw file from GitHub. Guides, announcements and homepage copy must be edited on GitHub. Back up your current draft before retrying.

Checks failed or a reviewer requested changes.

Read the specific error or comment and address the first issue. Commit changes to the existing PR’s branch. If unclear, describe the public error, file and steps you tried in that PR.

Is a tiny edit worth submitting?

A small, focused correction with clear evidence is useful. Explain what you do not know instead of guessing. Complete the part you can verify and discuss the rest in the PR.

Next time, you can start with the article.

Bookmark this guide. Make a change you can verify, and describe anything unclear in your PR. Your sources and explanations also help the next editor.

Open visual editor →
Report a problem first ↗

Not ready to edit? Open a repository issue with the article URL, the specific error and a supporting source. Search existing issues first.

KAMITSUBAKI WIKI

Sign in to the Wiki

Use your existing AI account. Sync your library across devices; reading the Wiki remains open.

My space →