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 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, with base branch main; 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/: src/content/songs/<artistId>/<category>/<songId>/<locale>.md, for example src/content/songs/kaf/originals/new-song/en.md.
  • albums/: src/content/albums/<artistId>/<albumId>/<locale>.md, for example src/content/albums/kaf/new-album/en.md.
  • Follow an existing article of the same type for other paths. Do not rename existing entry keys or directories casually.

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 translationKey. Prepare zh.md, ja.md and en.md for a new article. If a version needs help, explain that in the PR instead of presenting untranslated text as complete. The syntax reference has the full song and album completion standards.

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 translationKey across versions, with consistent dates, catalog numbers and relationships. 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?

Read the guide, edit in the visual editor and download a draft. Create and verify an account when ready to submit. You can also collect article links and concrete problems to report later.

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

The draft lives only in this browser. Export it, save the change on GitHub and create a PR. The live page changes after review, merge and successful deployment.

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 →

Site tools