# Syslab 报告生成
从 Syslab 设计应用程序并自动生成报告
TyReportGenerator 提供了将报告功能集成到 Syslab 应用程序中的函数和 API。你可以开发能够生成 Microsoft Word 格式报告的程序。TyReportGenerator 使您能够从 Julia 代码中动态捕获结果和数字，并将这些结果记录在单个报表中，以便与其他人共享。您可以使用预生成的、自定义的 Word 模板。
函数库：TyReportGenerator
提示
使用本函数库之前，需要通过import TyReportGenerator或using TyReportGenerator来实现加载。
关于import和using的详细用法，请参见模块的命名空间管理。
# 创建与生成报告
创建程序以生成 Microsoft Word。
创建与生成报告
| 函数名 | 简介 |
|---|---|
| create_document | 创建报告容器 |
| generate_report | 生成报告 |
| compose_report | 合并报告 |
| replace_template | 替换模板内容 |
| rptview | 显示报告 |
# 创建报告内容对象
创建报告内容
创建报告内容对象
| 函数名 | 简介 |
|---|---|
| create_titlepage | 创建封面 |
| create_tableofcontents | 创建目录 |
| create_text | 创建文本 |
| create_paragraph | 创建段落 |
| create_paragraphstyle | 创建段落样式 |
| create_heading | 创建标题 |
| create_bookmark | 创建书签 |
| create_image | 创建图片 |
| create_caption | 创建题注 |
| create_code | 创建代码块 |
| create_linktarget | 创建超链接 |
| create_comment | 创建批注 |
| create_equation | 创建数学公式 |
| create_pagebreak | 创建分页符 |
| create_pagelayout | 创建页面布局 |
| create_list | 创建多级列表 |
| create_table | 创建表格 |
| create_tablestyle | 创建表格样式 |
| create_tblborders | 创建表格边框 |
| create_cell | 创建表格单元格 |
# 添加、修改报告内容对象
添加或修改报告内容格式
添加、修改报告内容对象
| 函数名 | 简介 |
|---|---|
| add_titlepage | 添加封面 |
| add_tableofcontents | 添加目录 |
| add_paragraph | 添加段落 |
| add_paragraphstyle | 添加段落样式 |
| add_heading | 添加标题 |
| add_heading1 | 添加一级标题 |
| add_heading2 | 添加二级标题 |
| add_heading3 | 添加三级标题 |
| add_heading4 | 添加四级标题 |
| add_heading5 | 添加五级标题 |
| add_heading6 | 添加六级标题 |
| add_bookmark | 添加书签 |
| add_image | 添加图片 |
| add_caption | 添加题注 |
| add_code | 添加代码块 |
| add_linktarget | 添加超链接 |
| add_comment | 添加批注 |
| add_equation | 添加数学公式 |
| add_pagebreak | 添加分页符 |
| add_pagelayout | 添加页面布局 |
| add_list | 添加多级列表 |
| add_table | 添加表格 |
| add_tablestyle | 添加表格样式 |
| add_header | 向表格添加行头或列头 |
| add_col | 向表格添加一列 |
| add_row | 向表格添加行 |
| modify_text | 修改 Text 对象属性 |
| modify_cell | 修改 Cell 对象属性 |
| remove_col | 向表格删除指定列 |
| remove_row | 向表格删除指定行 |
# 具有 style 属性的对象
报告生成中的数据可以通过修改 style 属性对文档样式进行修改。style 属性修改支持 Dict 和 Style 两个形式。
Dict 示例：style=Dict("outer_margin" => (0, 0),"font_size"=> 10.5,"font_family"=>"Times New Roman")
Style 示例：style = Style(outer_margin=(0, 0), font_size=10.5, font_family="Times New Roman")
具有 style 属性的数据有：
| 类别 | 简介 |
|---|---|
| 文本 | Text 结构体 |
| 图像 | Image 结构体 |
| 公式 | Equation 结构体 |
| 标题 | Heading 结构体 |
| 表格 | Table 结构体 |
| 列表 | List 结构体 |
# style 属性
style 为结构体数据，存储样式属性。
| 属性 | 简介 |
|---|---|
| bold | 加粗 |
| italic | 斜体 |
| color | 颜色 |
| strike | 删除线 |
| halign | 水平对齐 |
| valign | 垂直对齐 |
| underline | 下划线 |
| style_type | 样式 |
| font_family | 字体 |
| font_size | 字号 |
| background_color | 背景色 |
| left_line_indent | 段落左缩进 |
| line_spacing | 行距 |
| outer_margin | 段前段后间距 |
| background_color_cell | 单元格背景色 |
# 前提条件
Windows 系统中更新文件的目录，生成 pdf、html 文件，需要安装 Microsoft Word 2010 或以上版本；
Linux 系统中预览文档，生成 pdf、html 文件，需要安装 libreoffice。
以 CentOS 系统为例，libreoffice 安装过程：
打开终端，输入以下命令
sudo yum install libreoffice执行该命令后，系统会自动从默认的软件仓库中下载并安装 libreoffice 软件包。
输入 y 确认安装
安装完毕提示
