タイプ

この文書は、YAMLResume 履歴書構造を定義する TypeScript タイプの概要を提供します。TypeScript プロジェクトとして、YAMLResume はデータの一貫性を確保するために静的タイプを採用しています。このファイルは、個人詳細、教育、経験、スキルなどを含む、履歴書情報を表現するために使用されるコアデータ構造の概要を提供します。

詳細については、実際のソース types/index.ts をご確認ください。

これらのタイプを理解することは、YAMLResume の機能をカスタマイズまたは拡張したい貢献者や開発者にとって重要です。

この文書は、有効な YAMLResume を作成しようとするユーザーに権威ある参照を提供し、オプションと必須フィールドの違いを明確にします。YAMLResume で正常にコンパイルするために、最小履歴書には以下の基本フィールドが含まれている必要があります：

content.basics.name
education[number].area
education[number].degree
education[number].institution
education[number].startDate

したがって、理論的には最小実行可能履歴書は以下のようになります：

content:
  basics:
    name: Xiao Hanyu
  education:
    - area: Computer Science and Technology
      degree: Bachelor
      institution: Zhejiang University
      startDate: Sep, 2007

Resume

全体的な履歴書構造を定義し、コンテンツとレイアウトを含みます。

属性	タイプ	必須	説明
`content`	`Content`	✅	履歴書全体のコンテンツ構造を定義します。
`layouts?`	`Layouts`	⬜	全体的なレイアウト設定を定義します。
`locale?`	`Locale`	⬜	全体的なロケール設定を定義します。

以下は履歴書構造の高レベル図です：

Content

履歴書全体のコンテンツ構造を定義します。

属性	タイプ	必須	説明
`basics`	`BasicsItem`	✅	コア個人情報と連絡先情報を表します。
`education`	`EducationItem[]`	✅	教育経験のコレクションを含みます。
`awards?`	`AwardItem[]`	⬜	賞と認識のコレクションを含みます。
`certificates?`	`CertificateItem[]`	⬜	認証と証明書のコレクションを含みます。
`interests?`	`InterestItem[]`	⬜	興味、趣味、または個人的な活動のコレクションを含みます。
`languages?`	`LanguageItem[]`	⬜	言語能力のコレクションを含みます。
`location?`	`LocationItem`	⬜	位置情報を含みます。
`projects?`	`ProjectItem[]`	⬜	プロジェクトのコレクションを含みます。
`profiles?`	`ProfileItem[]`	⬜	オンラインプロフィールのコレクションを含みます。
`publications?`	`PublicationItem[]`	⬜	出版物のコレクションを含みます。
`references?`	`ReferenceItem[]`	⬜	推薦人のコレクションを含みます。
`skills?`	`SkillItem[]`	⬜	スキルのコレクションを含みます。
`volunteer?`	`VolunteerItem[]`	⬜	ボランティア経験のコレクションを含みます。
`work?`	`WorkItem[]`	⬜	職歴と雇用履歴のコレクションを含みます。

AwardItem

獲得した単一の賞、名誉、または認識を表します。

属性	タイプ	必須	説明
`awarder`	`string`	✅	賞を授与した組織または団体。
`title`	`string`	✅	賞の名前またはタイトル。
`date?`	`string`	⬜	受賞日（例：「2020」、「Oct 2020」）。
`summary?`	`string`	⬜	賞に関する短い説明または詳細情報。

BasicsItem

コア個人情報と連絡先情報を表します。

属性	タイプ	必須	説明
`name`	`string`	✅	フルネーム。
`email?`	`string`	⬜	メールアドレス。
`headline?`	`string`	⬜	短い専門タイトルまたは役職（例：「ソフトウェアエンジニア」）。
`phone?`	`string`	⬜	電話番号。
`summary?`	`string`	⬜	専門的な要約または目標声明。
`url?`	`string`	⬜	個人ウェブサイトまたはポートフォリオ URL。

CertificateItem

単一の認証、証明書、または専門資格を表します。

属性	タイプ	必須	説明
`issuer`	`string`	✅	証明書を発行した組織。
`name`	`string`	✅	証明書名。
`date?`	`string`	⬜	証明書取得日（例：「2021」、「Nov 2021」）。
`url?`	`string`	⬜	証明書に関連する URL（例：検証リンク）。

EducationItem

単一の教育経験または学位プログラムを表します。

属性	タイプ	必須	説明
`area`	`string`	✅	研究分野（例：「コンピュータサイエンス」）。
`degree`	`Degree`	✅	取得した学位タイプ。
`institution`	`string`	✅	機関名。
`startDate`	`string`	✅	学習開始日（例：「2016」、「Sep 2016」）。
`courses?`	`string[]`	⬜	受講したコースのリスト。
`endDate?`	`string`	⬜	学習終了日（例：「2020」、「May 2020」）、空値は「現在」を表します。
`summary?`	`string`	⬜	成果または詳細情報の説明。
`score?`	`string`	⬜	GPA または学業成績。
`url?`	`string`	⬜	機関または学位に関連する URL。

InterestItem

単一の興味、趣味、または個人的な活動を表します。

属性	タイプ	必須	説明
`name`	`string`	✅	興味カテゴリ名（例：「読書」、「写真」）。
`keywords?`	`string[]`	⬜	興味に関連するキーワード。

LanguageItem

単一の言語能力項目を表します。

属性	タイプ	必須	説明
`fluency`	`Fluency`	✅	言語の流暢度。
`language`	`Language`	✅	言語。
`keywords?`	`string[]`	⬜	言語スキルに関連する特定のキーワード（例：「翻訳」）。

LocationItem

位置と住所情報を表します。

属性	タイプ	必須	説明
`city`	`string`	✅	都市名。
`address?`	`string`	⬜	住所。
`country?`	`Country`	⬜	国コードまたは国名。
`postalCode?`	`string`	⬜	郵便番号。
`region?`	`string`	⬜	州、省、または地域。

ProfileItem

単一のオンラインプロフィールまたはソーシャルメディアの存在を表します。

属性	タイプ	必須	説明
`network`	`Network`	✅	ネットワークまたはプラットフォーム名。
`username`	`string`	✅	プラットフォーム上のユーザー名。
`url?`	`string`	⬜	プロフィールの URL。

ProjectItem

単一のプロジェクト、ポートフォリオ作品、または技術的な作業を表します。

属性	タイプ	必須	説明
`name`	`string`	✅	プロジェクト名。
`startDate`	`string`	✅	プロジェクト開始日（例：「2021」、「Jan 2021」）。
`summary`	`string`	✅	プロジェクトの詳細な成果。
`description?`	`string`	⬜	プロジェクトの説明。
`endDate?`	`string`	⬜	プロジェクト終了日（例：「2022」、「Jul 2022」）。
`keywords?`	`string[]`	⬜	プロジェクトで使用されたキーワードまたは技術。
`url?`	`string`	⬜	プロジェクトに関連する URL（例：リポジトリ、ライブデモ）。

PublicationItem

単一の出版物、研究作業、または学術論文を表します。

属性	タイプ	必須	説明
`name`	`string`	✅	出版物の名前またはタイトル。
`publisher`	`string`	✅	作品の出版社。
`releaseDate?`	`string`	⬜	発行日（例：「2023」、「Mar 2023」）。
`summary?`	`string`	⬜	出版物の要約または概要。
`url?`	`string`	⬜	出版物に関連する URL（例：DOI、リンク）。

ReferenceItem

単一の専門推薦人または推薦を表します。

属性	タイプ	必須	説明
`name`	`string`	✅	推薦人の名前。
`summary`	`string`	✅	推薦人に関する短い説明。
`email?`	`string`	⬜	推薦人のメールアドレス。
`phone?`	`string`	⬜	推薦人の電話番号。
`relationship?`	`string`	⬜	推薦人との関係（例：「元マネージャー」）。

SkillItem

単一のスキル、能力、または技術的能力を表します。

属性	タイプ	必須	説明
`level`	`Level`	✅	スキルの習熟度。
`name`	`string`	✅	スキル名。
`keywords?`	`string[]`	⬜	スキルに関連する特定のキーワードまたは技術。

VolunteerItem

単一のボランティア経験またはコミュニティサービスを表します。

属性	タイプ	必須	説明
`organization`	`string`	✅	組織名。
`position`	`string`	✅	担当した役割または職位。
`startDate`	`string`	✅	ボランティア活動開始日（例：「2019」、「Jun 2019」）。
`summary`	`string`	✅	責任または成果の要約。
`endDate?`	`string`	⬜	ボランティア活動終了日（例：「2020」、「Dec 2020」）。
`url?`	`string`	⬜	組織または活動に関連する URL。

WorkItem

単一の職歴または雇用職位を表します。

属性	タイプ	必須	説明
`name`	`string`	✅	会社または雇用主名。
`position`	`string`	✅	職位または担当した役職。
`startDate`	`string`	✅	雇用開始日（例：「2021」、「Apr 2021」）。
`summary`	`string`	✅	責任と成果の要約。
`endDate?`	`string`	⬜	雇用終了日（例：「2023」、「Aug 2023」）。
`keywords?`	`string[]`	⬜	役職または使用技術に関連するキーワード。
`url?`	`string`	⬜	会社または職務に関連する URL。

Locale

国際化とローカライゼーションのロケール設定を定義します。

属性	タイプ	必須	説明
`language?`	`LocaleLanguage`	⬜	履歴書コンテンツとテンプレート用語の選択された言語。

Layouts

複数の出力形式をサポートするレイアウト項目の配列。

属性	タイプ	必須	説明
`layouts[]`	`LatexLayout` \| `MarkdownLayout`	⬜	複数の出力レイアウト設定。

一般的なレイアウトタイプ

Margins

文書レイアウトのマージン設定を定義します。

属性	タイプ	必須	説明
`top?`	`string`	⬜	上マージン値（例：「2.5cm」）。
`bottom?`	`string`	⬜	下マージン値（例：「2.5cm」）。
`left?`	`string`	⬜	左マージン値（例：「1.5cm」）。
`right?`	`string`	⬜	右マージン値（例：「1.5cm」）。

Sections

セクション名をカスタマイズするためのセクションエイリアス設定を定義します。

属性	タイプ	必須	説明
`aliases?`	`Record<SectionID, string>`	⬜	デフォルトの翻訳を上書きする、セクション名のカスタムエイリアス。
`order?`	`OrderableSectionID[]`	⬜	最終出力におけるセクションのカスタム順序。

HtmlLayout

HTML レイアウト設定。

属性	タイプ	必須	説明
`engine`	`'html'`	✅	履歴書を生成するエンジン。
`advanced?`	`HtmlAdvanced`	⬜	高度なレイアウト設定オプションを定義します。
`sections?`	`Sections`	⬜	セクションのカスタマイズ設定を定義します。
`template?`	`HtmlTemplate`	⬜	選択されたテンプレートを定義します。
`typography?`	`HtmlTypography`	⬜	文書フォーマットのタイポグラフィ設定を定義します。

HtmlAdvanced

高度な HTML 設定オプションを定義します。

属性	タイプ	必須	説明
`showIcons?`	`boolean`	⬜	リンクとプロフィールのアイコンを表示するかどうか。
`title?`	`string`	⬜	HTML ドキュメントのカスタムタイトル。
`footer?`	`string`	⬜	HTML ドキュメントのカスタムフッター。
`description?`	`string`	⬜	HTML ドキュメントのメタ記述。
`keywords?`	`string`	⬜	HTML ドキュメントのメタキーワード。

HtmlTypography

HTML 文書フォーマットのタイポグラフィ設定を定義します。

属性	タイプ	必須	説明
`fontFamily?`	`string`	⬜	使用するフォントファミリーのカンマ区切りリスト。
`fontSize?`	`HtmlFontSize`	⬜	文書の基本フォントサイズ。

LatexLayout

LaTeX レイアウト設定。

属性	タイプ	必須	説明
`advanced?`	`LatexAdvanced`	⬜	高度な設定オプションを定義します。
`engine`	`'latex'`	✅	履歴書を生成するエンジン。
`page?`	`LatexPage`	⬜	文書プレゼンテーションのページレベル設定を定義します。
`sections?`	`Sections`	⬜	セクションのカスタマイズ設定を定義します。
`template?`	`LatexTemplate`	⬜	選択されたテンプレートを定義します。
`typography?`	`LatexTypography`	⬜	文書フォーマットのタイポグラフィ設定を定義します。

LatexAdvanced

LaTeX の高度な設定オプションを定義します。

属性	タイプ	必須	説明
`fontspec?`	`{ numbers?: LatexFontspecNumbers }`	⬜	LaTeX fontspec パッケージ設定。
`showIcons?`	`boolean`	⬜	リンクとプロフィールのアイコンを表示するかどうか。

LatexPage

LaTeX の文書プレゼンテーションのページレベル設定を定義します。

属性	タイプ	必須	説明
`margins?`	`Margins`	⬜	ページマージン設定を定義します。
`paperSize?`	`PaperSize`	⬜	用紙サイズを定義します。
`showPageNumbers?`	`boolean`	⬜	ページ番号を表示するかどうか。

LatexTypography

LaTeX の文書フォーマットのタイポグラフィ設定を定義します。

属性	タイプ	必須	説明
`fontSize?`	`LatexFontSize`	⬜	文書の基本フォントサイズ。
`fontFamily?`	`string`	⬜	使用するフォントファミリーのカンマ区切りリスト。
`links?`	`{ underline?: boolean }`	⬜	リンクのスタイル設定。