> For the complete documentation index, see [llms.txt](https://thus-1.gitbook.io/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://thus-1.gitbook.io/doc/chapter-1/01-html.md). # HTML 开发规范指南 HTML 开发规范指南 ## 1.文档目录结构 ``` . ├── assets │ ├── css │ ├── fonts │ ├── images │ ├── js │ └── pic ├── favicon.ico ├── index.html ``` ## 2.文档类型统一使用HTML5的标准文档类型：\ ```markup ``` ## 3.语言属性对不同语言文件使用正确的语言设定。 ```markup ``` ## 4.移动端设置 ```markup ``` ## 5.meta设定了解各种meta的设定，针对具体项目取舍。 ```markup value ``` ## 6.缩进使用tab（4个空格宽度）来进行缩进，可以在IDE里进行设置 ## 7.语义化标签 * 根据HTML元素的本身用途去使用它们； * 禁止使用被废弃的用于表现的标签，如 center, font 等； * 部分在XHTML1中被废弃的标签，在HTML5中被重新赋予了新的语义，在选用时请先弄清其语义，如:b, i, u等。不允许： ```markup

标题

``` 应该： ```markup

标题

``` > 虽然使用p标签，也可以通过CSS去定义它的外观和标题相同，但p标签本身的并不是表示标题，而是表示文本段落 ## 8.模块化 * 每个模块必须有一个模块名； * 每个模块的基本组成部分应该一致； * 模块的子节点类名需带上模块名（防止模块间嵌套时产生不必要的覆盖）； * 孙辈节点无需再带模块名。代码如： ```markup

模块标题

一些实际内容

``` > 其中 `.m-detail-hd`, `.m-detail-bd`, `.m-detail-ft` 为可选，视具体模块情况决定是否需要抽象为这种 **头，中，尾** 的结构 ## 示例文件 [HTML示例文件](https://github.com/thus/doc/tree/106d01ce2108410907eda3021a8184317a3dc334/code/chapter-1/01-html.html) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://thus-1.gitbook.io/doc/chapter-1/01-html.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.