The takuhon.json file

takuhon.json is the single canonical document that Takuhon serves. It holds your profile, the sections you choose to publish, and some settings and metadata.

Top-level structure

{
  "schemaVersion": "0.4.0",
  "profile": {},
  "links": [],
  "careers": [],
  "projects": [],
  "skills": [],
  "contact": {},
  "settings": {},
  "meta": {}
}

Beyond the sections above, optional arrays cover a fuller CV: certifications, memberships, volunteering, honors, education, publications, languages, courses, patents, testScores, recommendations. Any omitted array is treated as empty.

For a complete field-by-field reference of every section and type, see the Schema reference.

Key sections

Field	Purpose
profile	Display name, tagline, bio, avatar, location
links	Social and external links (featured entries render first)
careers	Roles and organizations, with isCurrent for present positions
projects	Highlighted work
skills	Skills, optionally grouped by category
contact	Email and contact form (email shown only when showEmail is true)
settings	defaultLocale and availableLocales
meta	Profile metadata, including the content license

Multilingual fields

Human-readable fields are language maps keyed by BCP-47 tags:

{
  "profile": {
    "displayName": { "en": "Sam Lee", "ja": "リー・サム" },
    "bio": { "en": "Engineer and writer.", "ja": "エンジニア・著述家。" }
  },
  "settings": { "defaultLocale": "en", "availableLocales": ["en", "ja"] }
}

Takuhon resolves the requested locale per request, falls back to defaultLocale, and emits matching hreflang and lang metadata.

Licensing

The license for your profile content is separate from Takuhon’s own code license. You choose it when scaffolding with create-takuhon, and it is recorded under meta.contentLicense:

{ "meta": { "contentLicense": { "spdxId": "CC0-1.0" } } }

There is no default — pick the SPDX identifier that matches how you want your profile data to be reused.