Nexus AI, Co-Founder CTO【免费下载链接】rendercvResume builder for academics and engineers项目地址: https://gitcode.com/GitHub_Trending/re/rendercvSan Francisco, CA Jun 2023 – presentBuilt foundation model infrastructure serving 2M monthly API requests with 99.97% uptimeRaised $18M Series A led by Sequoia Capital, with participation from a16z and Founders FundScaled engineering team from 3 to 28 across ML research, platform, and applied AI divisionsDeveloped proprietary inference optimization reducing latency by 73% compared to baseline## 三、ExperienceEntry 数据模型字段与校验 模板消费的 entry 对象来自 Pydantic 模型 [experience.py](https://link.gitcode.com/i/fe3e3f49bf6cdc541306d60312a1295b)。ExperienceEntry 的字段定义如下 | 字段 | 必填 | 说明 | | --- | --- | --- | | company | 是 | 雇主名称 | | position | 是 | 职位/头衔 | | date | 否 | 单日期自定义文本或 YYYY-MM-DD/YYYY-MM/YYYY提供后覆盖 start/end | | start_date | 否 | 起始日期 | | end_date | 否 | 结束日期进行中可用 present 或省略 | | location | 否 | 办公地点 | | summary | 否 | 角色描述 | | highlights | 否 | 成就要点列表 | 其中 company 与 position 由 BaseExperienceEntry 声明为必填其余字段继承自 BaseEntryWithComplexFields见 [entry_with_complex_fields.py](https://link.gitcode.com/i/09655283da83727ffbfdcc72713fdafd)。 值得关注的是日期字段的**归一化模型校验器** check_and_adjust_dates()它定义了三条规则 1. 若只提供 date则忽略 start_date/end_date 2. 若只提供 end_date视为单日事件等价于只提供 date 3. 若只提供 start_date视为进行中事件自动把 end_date 置为 present。 同时validate_exact_date() 严格校验 start_date/end_date 必须能被解析为真实日期因为要做日期运算与时长的计算并校验 start_date 不得晚于 end_date。而 date 字段相对宽松允许 Fall 2023 之类的自定义文本见 [entry_with_date.py](https://link.gitcode.com/i/7ebbbb9ba18e7e6420904d4f509a0034)。 ## 四、占位符展开管线main_column 与 date_and_location_column 如何生成 模板中访问的 entry.main_column 和 entry.date_and_location_column 并不是用户直接编写的字段而是由 render_entry_templates()[entry_templates_from_input.py](https://link.gitcode.com/i/1781e1634f8f86b38d0d9976268e7db7)根据设计配置中的模板字符串展开得到的动态属性。 ### 4.1 默认模板定义 工作经历条目的默认模板定义在 [classic_theme.py](https://link.gitcode.com/i/c70eef8031fad82be904064c22d26b5b) 的 ExperienceEntryTemplate 中 - main_column 默认值**COMPANY**, POSITION\nSUMMARY\nHIGHLIGHTS - date_and_location_column 默认值LOCATION\nDATE 用户文档中的完整示例见 [design.md](https://link.gitcode.com/i/51316dc570baa010293e62bb099686da)其等价 YAML 写法为 yaml design: templates: experience_entry: main_column: |- **COMPANY**, POSITION SUMMARY HIGHLIGHTS date_and_location_column: |- LOCATION DATE4.2 展开过程的三个关键步骤render_entry_templates()对模板字符串做如下处理字段占位符替换把条目字段转成大写键COMPANY、POSITION、LOCATION、SUMMARY、HIGHLIGHTS、DATE、START_DATE、END_DATE等替换进模板。空字符串值视为未提供会在第 3 步被清理。特殊占位符预处理HIGHLIGHTS→process_highlights()每个要点转成- 内容其中用-分隔的子要点转为缩进的二级列表entry_templates_from_input.pySUMMARY→ 若模板中SUMMARY独占一行则包成!!! summaryadmonition这正是模板 2.3 节过滤!!! summary行的来源若与其它占位符同行如**COMPANY**, SUMMARY则保持内联不包裹测试见 test_entry_templates_from_input.pyDATE/START_DATE/END_DATE→ 交由日期管线格式化见第五节。缺失占位符清理remove_not_provided_placeholders()会移除未提供字段对应的占位符及其周边标点并通过remove_connectors_of_missing_placeholders()一并删除占位符之间的连接词如in、at避免出现 Engineer at 这类残句最后用clean_trailing_parts()清理行尾残留的逗号、冒号等。测试 test_entry_templates_from_input.py 印证了完整行为NormalEntry(nameProject, date2023-05, highlights[Alpha,Beta], locationRemote)渲染后main_column为**Project**\n- Alpha\n- Betadate_and_location_column为Remote\nMay 2023。五、日期与时间段present关键字、date_range 与 time_span工作经历几乎总是日期区间而非单日期因此 ExperienceEntry 的日期格式化是整个展开管线中最复杂的部分实现在 date.py 与process_date()entry_templates_from_input.py。5.1 支持的日期输入格式start_date/end_date支持三种 ISO 风格与关键字2020仅年份可写整数20202020-09年月2020-09-24精确日期present仅end_date表示进行中get_date_object()entry_with_complex_fields.py负责把上述输入解析为 PythonDate对象present解析为当前日期取自设置中的_resolved_current_date。5.2 date_range 模板区间按design.templates.date_range格式化默认值为START_DATE – END_DATE其中起止日期各自再按single_date模板默认MONTH_ABBREVIATION YEAR如 Jun 2023渲染present会替换为本地化文本如英文present、法文présent见format_date_range()date.py。因此start_date: 2023-06, end_date: present得到Jun 2023 – present。5.3 time_span 时长计算若该 section 被列入design.sections.show_time_spans_in设计文档示例中即包含experience见 design.md则process_date()还会调用compute_time_span_string()计算任职时长并追加到日期区间之后。时长按time_span模板默认HOW_MANY_YEARS YEARS HOW_MANY_MONTHS MONTHS输出并依据 locale 自动处理单复数year/years、month/months例如 3 years 4 months。实现细节仅年份输入时按整年差计算含月份输入时按天数换算365 天/年、30 天/月并处理溢出如 12 个月进位为 1 年。六、同一数据、三种输出与 Typst / HTML 模板的对照ExperienceEntry 的 Markdown 模板只是渲染面之一同一数据模型还有对应的 Typst 模板 ExperienceEntry.j2.typ 与 HTML 输出路径理解对照有助于把握 Markdown 模板的设计取舍Typst通过#regular-entry(...)双栏函数把main_column与date_and_location_column排成左右两栏日期/地点在右、正文在左并受design.entries.short_second_row、allow_page_break、space_between_columns等排版参数控制参数定义见 classic_theme.py。其中main_column.splitlines()[:first_row_lines]决定首行与第二行的切分方式与 Markdown 模板中[0]/[1:]的切分逻辑同源。HTML先走与本模板完全相同的 Markdown 渲染路径再由render_html()调用markdown_to_html()markdown_parser.py把 Markdown 转为 HTML 并套入 Full.html。Typst 内容转换Markdown 语法加粗、斜体、链接等由markdown_to_typst()markdown_parser.py逐行转换为 Typst 标记!!! summaryadmonition 块则转换为#summary[...]见to_typst_string()的div分支markdown_parser.py这也解释了为何 Markdown 模板需要单独跳过!!! summary行——它是 Typst/HTML 提示框语法的中间标记。七、自定义工作经历条目的输出如需调整工作经历的 Markdown/PDF 表现有两种途径均无需修改仓库代码7.1 修改 design.templates.experience_entry在用户自己的rendercv.yaml或John_Doe_CV.yaml之类输入文件的design.templates下覆盖experience_entry的两个模板字符串即可。例如把公司移到第二行、把摘要换成斜体design: templates: experience_entry: main_column: |- **POSITION** *COMPANY* SUMMARY HIGHLIGHTS date_and_location_column: |- LOCATION DATE所有条目字段均可作为大写占位符使用可参考 cv.md 中 ExperienceEntry 字段表与 design.md 的模板配置说明。7.2 使用任意自定义字段arbitrary keys除标准字段外可为经历条目添加任意键例如revenue: $5M ARR然后在模板中以REVENUE占位符引用官方文档示例见 cv.md 与 arbitrary_keys_in_entries.mdexperience: - company: Startup Inc position: Founder start_date: 2020-01 end_date: present revenue: $5M ARR # 自定义字段 highlights: - Built product from zero to profitabilitydesign: templates: experience_entry: main_column: |- **COMPANY**, POSITION (REVENUE) SUMMARY HIGHLIGHTS【免费下载链接】rendercvResume builder for academics and engineers项目地址: https://gitcode.com/GitHub_Trending/re/rendercv创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Nexus AI, Co-Founder CTO【免费下载链接】rendercvResume builder for academics and engineers项目地址: https://gitcode.com/GitHub_Trending/re/rendercvSan Francisco, CA Jun 2023 – presentBuilt foundation model infrastructure serving 2M monthly API requests with 99.97% uptimeRaised $18M Series A led by Sequoia Capital, with participation from a16z and Founders FundScaled engineering team from 3 to 28 across ML research, platform, and applied AI divisionsDeveloped proprietary inference optimization reducing latency by 73% compared to baseline## 三、ExperienceEntry 数据模型字段与校验 模板消费的 entry 对象来自 Pydantic 模型 [experience.py](https://link.gitcode.com/i/fe3e3f49bf6cdc541306d60312a1295b)。ExperienceEntry 的字段定义如下 | 字段 | 必填 | 说明 | | --- | --- | --- | | company | 是 | 雇主名称 | | position | 是 | 职位/头衔 | | date | 否 | 单日期自定义文本或 YYYY-MM-DD/YYYY-MM/YYYY提供后覆盖 start/end | | start_date | 否 | 起始日期 | | end_date | 否 | 结束日期进行中可用 present 或省略 | | location | 否 | 办公地点 | | summary | 否 | 角色描述 | | highlights | 否 | 成就要点列表 | 其中 company 与 position 由 BaseExperienceEntry 声明为必填其余字段继承自 BaseEntryWithComplexFields见 [entry_with_complex_fields.py](https://link.gitcode.com/i/09655283da83727ffbfdcc72713fdafd)。 值得关注的是日期字段的**归一化模型校验器** check_and_adjust_dates()它定义了三条规则 1. 若只提供 date则忽略 start_date/end_date 2. 若只提供 end_date视为单日事件等价于只提供 date 3. 若只提供 start_date视为进行中事件自动把 end_date 置为 present。 同时validate_exact_date() 严格校验 start_date/end_date 必须能被解析为真实日期因为要做日期运算与时长的计算并校验 start_date 不得晚于 end_date。而 date 字段相对宽松允许 Fall 2023 之类的自定义文本见 [entry_with_date.py](https://link.gitcode.com/i/7ebbbb9ba18e7e6420904d4f509a0034)。 ## 四、占位符展开管线main_column 与 date_and_location_column 如何生成 模板中访问的 entry.main_column 和 entry.date_and_location_column 并不是用户直接编写的字段而是由 render_entry_templates()[entry_templates_from_input.py](https://link.gitcode.com/i/1781e1634f8f86b38d0d9976268e7db7)根据设计配置中的模板字符串展开得到的动态属性。 ### 4.1 默认模板定义 工作经历条目的默认模板定义在 [classic_theme.py](https://link.gitcode.com/i/c70eef8031fad82be904064c22d26b5b) 的 ExperienceEntryTemplate 中 - main_column 默认值**COMPANY**, POSITION\nSUMMARY\nHIGHLIGHTS - date_and_location_column 默认值LOCATION\nDATE 用户文档中的完整示例见 [design.md](https://link.gitcode.com/i/51316dc570baa010293e62bb099686da)其等价 YAML 写法为 yaml design: templates: experience_entry: main_column: |- **COMPANY**, POSITION SUMMARY HIGHLIGHTS date_and_location_column: |- LOCATION DATE4.2 展开过程的三个关键步骤render_entry_templates()对模板字符串做如下处理字段占位符替换把条目字段转成大写键COMPANY、POSITION、LOCATION、SUMMARY、HIGHLIGHTS、DATE、START_DATE、END_DATE等替换进模板。空字符串值视为未提供会在第 3 步被清理。特殊占位符预处理HIGHLIGHTS→process_highlights()每个要点转成- 内容其中用-分隔的子要点转为缩进的二级列表entry_templates_from_input.pySUMMARY→ 若模板中SUMMARY独占一行则包成!!! summaryadmonition这正是模板 2.3 节过滤!!! summary行的来源若与其它占位符同行如**COMPANY**, SUMMARY则保持内联不包裹测试见 test_entry_templates_from_input.pyDATE/START_DATE/END_DATE→ 交由日期管线格式化见第五节。缺失占位符清理remove_not_provided_placeholders()会移除未提供字段对应的占位符及其周边标点并通过remove_connectors_of_missing_placeholders()一并删除占位符之间的连接词如in、at避免出现 Engineer at 这类残句最后用clean_trailing_parts()清理行尾残留的逗号、冒号等。测试 test_entry_templates_from_input.py 印证了完整行为NormalEntry(nameProject, date2023-05, highlights[Alpha,Beta], locationRemote)渲染后main_column为**Project**\n- Alpha\n- Betadate_and_location_column为Remote\nMay 2023。五、日期与时间段present关键字、date_range 与 time_span工作经历几乎总是日期区间而非单日期因此 ExperienceEntry 的日期格式化是整个展开管线中最复杂的部分实现在 date.py 与process_date()entry_templates_from_input.py。5.1 支持的日期输入格式start_date/end_date支持三种 ISO 风格与关键字2020仅年份可写整数20202020-09年月2020-09-24精确日期present仅end_date表示进行中get_date_object()entry_with_complex_fields.py负责把上述输入解析为 PythonDate对象present解析为当前日期取自设置中的_resolved_current_date。5.2 date_range 模板区间按design.templates.date_range格式化默认值为START_DATE – END_DATE其中起止日期各自再按single_date模板默认MONTH_ABBREVIATION YEAR如 Jun 2023渲染present会替换为本地化文本如英文present、法文présent见format_date_range()date.py。因此start_date: 2023-06, end_date: present得到Jun 2023 – present。5.3 time_span 时长计算若该 section 被列入design.sections.show_time_spans_in设计文档示例中即包含experience见 design.md则process_date()还会调用compute_time_span_string()计算任职时长并追加到日期区间之后。时长按time_span模板默认HOW_MANY_YEARS YEARS HOW_MANY_MONTHS MONTHS输出并依据 locale 自动处理单复数year/years、month/months例如 3 years 4 months。实现细节仅年份输入时按整年差计算含月份输入时按天数换算365 天/年、30 天/月并处理溢出如 12 个月进位为 1 年。六、同一数据、三种输出与 Typst / HTML 模板的对照ExperienceEntry 的 Markdown 模板只是渲染面之一同一数据模型还有对应的 Typst 模板 ExperienceEntry.j2.typ 与 HTML 输出路径理解对照有助于把握 Markdown 模板的设计取舍Typst通过#regular-entry(...)双栏函数把main_column与date_and_location_column排成左右两栏日期/地点在右、正文在左并受design.entries.short_second_row、allow_page_break、space_between_columns等排版参数控制参数定义见 classic_theme.py。其中main_column.splitlines()[:first_row_lines]决定首行与第二行的切分方式与 Markdown 模板中[0]/[1:]的切分逻辑同源。HTML先走与本模板完全相同的 Markdown 渲染路径再由render_html()调用markdown_to_html()markdown_parser.py把 Markdown 转为 HTML 并套入 Full.html。Typst 内容转换Markdown 语法加粗、斜体、链接等由markdown_to_typst()markdown_parser.py逐行转换为 Typst 标记!!! summaryadmonition 块则转换为#summary[...]见to_typst_string()的div分支markdown_parser.py这也解释了为何 Markdown 模板需要单独跳过!!! summary行——它是 Typst/HTML 提示框语法的中间标记。七、自定义工作经历条目的输出如需调整工作经历的 Markdown/PDF 表现有两种途径均无需修改仓库代码7.1 修改 design.templates.experience_entry在用户自己的rendercv.yaml或John_Doe_CV.yaml之类输入文件的design.templates下覆盖experience_entry的两个模板字符串即可。例如把公司移到第二行、把摘要换成斜体design: templates: experience_entry: main_column: |- **POSITION** *COMPANY* SUMMARY HIGHLIGHTS date_and_location_column: |- LOCATION DATE所有条目字段均可作为大写占位符使用可参考 cv.md 中 ExperienceEntry 字段表与 design.md 的模板配置说明。7.2 使用任意自定义字段arbitrary keys除标准字段外可为经历条目添加任意键例如revenue: $5M ARR然后在模板中以REVENUE占位符引用官方文档示例见 cv.md 与 arbitrary_keys_in_entries.mdexperience: - company: Startup Inc position: Founder start_date: 2020-01 end_date: present revenue: $5M ARR # 自定义字段 highlights: - Built product from zero to profitabilitydesign: templates: experience_entry: main_column: |- **COMPANY**, POSITION (REVENUE) SUMMARY HIGHLIGHTS【免费下载链接】rendercvResume builder for academics and engineers项目地址: https://gitcode.com/GitHub_Trending/re/rendercv创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
