# tidy

**Repository Path**: dourylee/tidy

## Basic Information

- **Project Name**: tidy
- **Description**: Utility to clean up and pretty print HTML/XHTML/XML
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 11
- **Created**: 2021-07-16
- **Last Updated**: 2021-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tidy

#### 介绍
用于清理、美化HTML/XHTML/XML文件的工具

#### 软件架构
软件架构说明


#### 安装教程

1.  dnf install tidy
2.  yum install tidy

#### 使用说明

tidy [选项...] [文件...] [选项...] [文件...]

文件操作
-----------------
````
-output <file>, -o <file>   将输出写入指定的 <file>
-config <file>              从指定的 <file> 设置配置选项
-file <file>, -f <file>     将错误和警告写入指定的 <file>
-modify, -m                 修改原始输入文件
````

处理指令
---------------------
````
-indent, -i                 缩进元素内容
-wrap <column>, -w          在指定的 <column> 处换行文本。假设为 0
<column>                    如果 <column> 缺失。当省略此选项时，配置选项 'wrap' 的默认值适用。
-upper, -u                  强制标签为大写
-clean, -c                  用 CSS 替换 FONT、NOBR 和 CENTER 标签
-bare, -b                   去掉智能引号和破折号等。
-gdoc, -g                   生成 Google Docs 导出的 html 的干净版本
-numeric, -n                输出数字而不是命名实体
-errors, -e                 只显示错误和警告
-quiet, -q                  抑制不必要的输出
-omit                       省略可选的开始标签和结束标签
-xml                        指定输入是格式良好的 XML
-asxml, -asxhtml            将 HTML 转换为格式良好的 XHTML
-ashtml                     强制 XHTML 为格式良好的 HTML
-access <level>             做额外的可访问性检查 (<level> = 0, 1, 2, 3)。如果 <level> 缺失，则假定为 0。
````

字符编码
-------------------
````
-                           未转换为实体的原始输出值高于 127
-ascii                      使用 ISO-8859-1 作为输入，US-ASCII 作为输出
-latin0                     输入使用 ISO-8859-15，输出使用 US-ASCII
-latin1                     使用 ISO-8859-1 作为输入和输出
-iso2022                    输入和输出都使用 ISO-2022
-utf8                       输入和输出都使用 UTF-8
-mac                        使用 MacRoman 输入，US-ASCII 输出
-win1252                    使用 Windows-1252 作为输入，US-ASCII 作为输出
-ibm858                     使用 IBM-858 (CP850+Euro) 作为输入，US-ASCII 作为输出
-utf16le                    对输入和输出都使用 UTF-16LE
-utf16be                    对输入和输出都使用 UTF-16BE
-utf16                      输入和输出都使用 UTF-16
-big5                       使用 Big5 作为输入和输出
-shiftjis                   使用 Shift_JIS 作为输入和输出
````

杂项
-------------
````
-version, -v                显示 Tidy 的版本
-help，-h，-？              列出命令行选项
-help-config                列出所有配置选项
-help-env                   显示有关环境和运行时配置的信息
-show-config                列出当前的配置设置
-export-config              列出当前的配置设置，适用于一个配置文件
-export-default-config      列出默认配置设置，适用于一个配置文件
-help-option <option>       显示 <option> 的描述
-language <lang>            将 Tidy 的输出语言设置为 <lang>。指定“-language help”以获得更多帮助。在导致输出的参数之前使用以确保语言生效，例如`tidy -lang es -lang help`。
````

XML
----
````
-xml-help                   列出XML格式的命令行选项
-xml-config                 以XML格式列出所有配置选项
-xml-strings                以XML格式输出Tidy的所有字符串
-xml-error-strings          以XML格式输出错误常量和字符串
-xml-options-strings        以XML格式输出选项描述
````

tidy的配置选项
--------------
````
 使用 Tidy 的配置选项作为表单中的命令行参数“--some-option <value>”，例如“--indent-with-tabs yes”。
 您还可以使用以下命令指定包含配置选项的文件-config <file> 指令，或在一个或多个特定于您的文件中环境（见下一节）。
 有关所有配置选项的列表，请使用“-help-config”或参考到手册页（如果您的操作系统有）。
````

配置文件
--------
````
 如果您的环境将 $HTML_TIDY 变量设置为指向 Tidy 配置文件，然后 Tidy 将尝试使用它。
 此外，Tidy 将自动尝试使用指定的配置在这些文件中（如果存在）：
 /etc/tidy.conf
 ~/.tidyrc
 使用“-help-env”获取有关如何使用环境的更多信息来指定tidy选项。
````

其他
-----
````
 输入/输出分别默认为 stdin/stdout。
 除了 -f 之外的单个字母选项可以组合使用，如：tidy -f errs.txt -imu foo.html
````

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request