From 4a8f8248be5102e34aa89e96100464de25d92e0e Mon Sep 17 00:00:00 2001 From: gclove Date: Fri, 18 Oct 2019 15:40:59 +0800 Subject: [PATCH] =?UTF-8?q?=E5=8D=87=E7=BA=A7=20typo.css=20=E5=88=B0=202.1?= =?UTF-8?q?.2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- libs/typo.css/2.1.2/README.md | 43 ++++ libs/typo.css/2.1.2/license.txt | 22 ++ libs/typo.css/2.1.2/typo.css | 345 ++++++++++++++++++++++++++++++++ libs/typo.css/package.json | 33 +-- 4 files changed, 429 insertions(+), 14 deletions(-) create mode 100755 libs/typo.css/2.1.2/README.md create mode 100755 libs/typo.css/2.1.2/license.txt create mode 100755 libs/typo.css/2.1.2/typo.css diff --git a/libs/typo.css/2.1.2/README.md b/libs/typo.css/2.1.2/README.md new file mode 100755 index 000000000..32bc276dc --- /dev/null +++ b/libs/typo.css/2.1.2/README.md @@ -0,0 +1,43 @@ +## 中文网页重设与排版： + +目标：一致化浏览器排版效果，构建最适合中文阅读的网页排版。包括桌面和移动平台。 + +预览：[typo.css](http://typo.sofi.sh) + +### 一、目录结构 + . + ├── README.md --- 使用帮助 + ├── license.txt --- 许可证 + ├── typo.css --- 将应用于你的项目 + └── typo.html --- Demo/预览 + + +### 二、TYPO.CSS 的设计和使用 + + +## TYPO.CSS 主要包括： + +1、一般 reset.css 所需的内容 + +目前的设计是这样的，尽量保持完整的 reset，比如让 ul/ol 无样式并且无多余的 `padding`/`margin`，这是必须的，因为一个网可能需要很多自定义的的内容，在实践中我们并不希望像 ul/ol 有样式，这样我们得用优先级去覆盖，这是非常麻烦的事。所以 typo.css 并不像 normalize.css，后者给每一个元素都预先定义了样式，这样在自定义的时候将是非常痛苦的。要大保持干净的所有元素一致化的 reset 才是最佳实践。 + +2、`class="typo"` 阅读内容排版 + +在文章/文档阅读的页面，需添加 `.typo` 这个 class，这样 table/ol/ul 等都会有预定的样式，让你的排版像 [http://typo.sofi.sh](http://typo.sofi.sh) 一样，让用户阅读起来更舒服。 + +在父容器在没有添加 `class="typo"` 的时候，可以使用 `class="typo-标签"`（如 `class="typo-ul"`）来实现像 `.typo > ul` 这样结构的样式。 + +3、增加类： + +主要是一些需要中文日常排版需要的元素和语文对应样式的增强，目前包括： + +(1) 专名号：使用标签 `` 或者 `.typo-u`
+(2) 着重号：使用 class `.typo-em`
+(3) 清理浮动：与一般 reset.css 保持一致 `.clearfix`
+(4) 强制换行：添加 `.textwrap` 到文本所在的容器，如果是 `table` 测还需要 `.textwrap-table`
+(5) 衬线字体：添加 `.serif`
+(6) 创建 border-box：在 html 中添加 `.borderbox` [#why](http://www.paulirish.com/2012/box-sizing-border-box-ftw/) + + +### 三、开源许可 +基于 [MIT License](http://zh.wikipedia.org/wiki/MIT_License) 开源，使用代码只需说明来源，或者引用 [license.txt](https://github.com/sofish/typo.css/blob/master/license.txt) 即可。 diff --git a/libs/typo.css/2.1.2/license.txt b/libs/typo.css/2.1.2/license.txt new file mode 100755 index 000000000..ed9873113 --- /dev/null +++ b/libs/typo.css/2.1.2/license.txt @@ -0,0 +1,22 @@ +TYPO.CSS - a better way to manage the typography of your Chinese-lang-base site. + +Copyright (C) 2012 Sofish Lin http://sofish.de + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + diff --git a/libs/typo.css/2.1.2/typo.css b/libs/typo.css/2.1.2/typo.css new file mode 100755 index 000000000..a3b90baf2 --- /dev/null +++ b/libs/typo.css/2.1.2/typo.css @@ -0,0 +1,345 @@ +@charset "utf-8"; + +/* 防止用户自定义背景颜色对网页的影响，添加让用户可以自定义字体 */ +html { + color: #333; + background: #fff; + -webkit-text-size-adjust: 100%; + -ms-text-size-adjust: 100%; + text-rendering: optimizelegibility; +} + +/* 如果你的项目仅支持 IE9+ | Chrome | Firefox 等，推荐在 中添加 .borderbox 这个 class */ +html.borderbox *, html.borderbox *:before, html.borderbox *:after { + -moz-box-sizing: border-box; + -webkit-box-sizing: border-box; + box-sizing: border-box; +} + +/* 内外边距通常让各个浏览器样式的表现位置不同 */ +body, dl, dt, dd, ul, ol, li, h1, h2, h3, h4, h5, h6, pre, code, form, fieldset, legend, input, textarea, p, blockquote, th, td, hr, button, article, aside, details, figcaption, figure, footer, header, menu, nav, section { + margin: 0; + padding: 0; +} + +/* 重设 HTML5 标签, IE 需要在 js 中 createElement(TAG) */ +article, aside, details, figcaption, figure, footer, header, menu, nav, section { + display: block; +} + +/* HTML5 媒体文件跟 img 保持一致 */ +audio, canvas, video { + display: inline-block; +} + +/* 要注意表单元素并不继承父级 font 的问题 */ +body, button, input, select, textarea { + font: 300 1em/1.8 PingFang SC, Lantinghei SC, Microsoft Yahei, Hiragino Sans GB, Microsoft Sans Serif, WenQuanYi Micro Hei, sans; +} + +button::-moz-focus-inner, +input::-moz-focus-inner { + padding: 0; + border: 0; +} + +/* 去掉各Table cell 的边距并让其边重合 */ +table { + border-collapse: collapse; + border-spacing: 0; +} + +/* 去除默认边框 */ +fieldset, img { + border: 0; +} + +/* 块/段落引用 */ +blockquote { + position: relative; + color: #999; + font-weight: 400; + border-left: 1px solid #1abc9c; + padding-left: 1em; + margin: 1em 3em 1em 2em; +} + +@media only screen and ( max-width: 640px ) { + blockquote { + margin: 1em 0; + } +} + +/* Firefox 以外，元素没有下划线，需添加 */ +acronym, abbr { + border-bottom: 1px dotted; + font-variant: normal; +} + +/* 添加鼠标问号，进一步确保应用的语义是正确的（要知道，交互他们也有洁癖，如果你不去掉，那得多花点口舌） */ +abbr { + cursor: help; +} + +/* 一致的 del 样式 */ +del { + text-decoration: line-through; +} + +address, caption, cite, code, dfn, em, th, var { + font-style: normal; + font-weight: 400; +} + +/* 去掉列表前的标识, li 会继承，大部分网站通常用列表来很多内容，所以应该当去 */ +ul, ol { + list-style: none; +} + +/* 对齐是排版最重要的因素, 别让什么都居中 */ +caption, th { + text-align: left; +} + +q:before, q:after { + content: ''; +} + +/* 统一上标和下标 */ +sub, sup { + font-size: 75%; + line-height: 0; + position: relative; +} + +:root sub, :root sup { + vertical-align: baseline; /* for ie9 and other modern browsers */ +} + +sup { + top: -0.5em; +} + +sub { + bottom: -0.25em; +} + +/* 让链接在 hover 状态下显示下划线 */ +a { + color: #1abc9c; +} + +a:hover { + text-decoration: underline; +} + +.typo a { + border-bottom: 1px solid #1abc9c; +} + +.typo a:hover { + border-bottom-color: #555; + color: #555; + text-decoration: none; +} + +/* 默认不显示下划线，保持页面简洁 */ +ins, a { + text-decoration: none; +} + +/* 专名号：虽然 u 已经重回 html5 Draft，但在所有浏览器中都是可以使用的， + * 要做到更好，向后兼容的话，添加 class="typo-u" 来显示专名号 + * 关于 标签：http://www.whatwg.org/specs/web-apps/current-work/multipage/text-level-semantics.html#the-u-element + * 被放弃的是 4，之前一直搞错 http://www.w3.org/TR/html401/appendix/changes.html#idx-deprecated + * 一篇关于 标签的很好文章：http://html5doctor.com/u-element/ + */ +u, .typo-u { + text-decoration: underline; +} + +/* 标记，类似于手写的荧光笔的作用 */ +mark { + background: #fffdd1; + border-bottom: 1px solid #ffedce; + padding: 2px; + margin: 0 5px; +} + +/* 代码片断 */ +pre, code, pre tt { + font-family: Courier, 'Courier New', monospace; +} + +pre { + background: #f8f8f8; + border: 1px solid #ddd; + padding: 1em 1.5em; + display: block; + -webkit-overflow-scrolling: touch; +} + +/* 一致化 horizontal rule */ +hr { + border: none; + border-bottom: 1px solid #cfcfcf; + margin-bottom: 0.8em; + height: 10px; +} + +/* 底部印刷体、版本等标记 */ +small, .typo-small, + /* 图片说明 */ +figcaption { + font-size: 0.9em; + color: #888; +} + +strong, b { + font-weight: bold; + color: #000; +} + +/* 可拖动文件添加拖动手势 */ +[draggable] { + cursor: move; +} + +.clearfix:before, .clearfix:after { + content: ""; + display: table; +} + +.clearfix:after { + clear: both; +} + +.clearfix { + zoom: 1; +} + +/* 强制文本换行 */ +.textwrap, .textwrap td, .textwrap th { + word-wrap: break-word; + word-break: break-all; +} + +.textwrap-table { + table-layout: fixed; +} + +/* 提供 serif 版本的字体设置: iOS 下中文自动 fallback 到 sans-serif */ +.serif { + font-family: Palatino, Optima, Georgia, serif; +} + +/* 保证块/段落之间的空白隔行 */ +.typo p, .typo pre, .typo ul, .typo ol, .typo dl, .typo form, .typo hr, .typo table, +.typo-p, .typo-pre, .typo-ul, .typo-ol, .typo-dl, .typo-form, .typo-hr, .typo-table, blockquote { + margin-bottom: 1.2em +} + +h1, h2, h3, h4, h5, h6 { + font-family: PingFang SC, Verdana, Helvetica Neue, Microsoft Yahei, Hiragino Sans GB, Microsoft Sans Serif, WenQuanYi Micro Hei, sans-serif; + font-weight: 100; + color: #000; + line-height: 1.35; +} + +/* 标题应该更贴紧内容，并与其他块区分，margin 值要相应做优化 */ +.typo h1, .typo h2, .typo h3, .typo h4, .typo h5, .typo h6, +.typo-h1, .typo-h2, .typo-h3, .typo-h4, .typo-h5, .typo-h6 { + margin-top: 1.2em; + margin-bottom: 0.6em; + line-height: 1.35; +} + +.typo h1, .typo-h1 { + font-size: 2em; +} + +.typo h2, .typo-h2 { + font-size: 1.8em; +} + +.typo h3, .typo-h3 { + font-size: 1.6em; +} + +.typo h4, .typo-h4 { + font-size: 1.4em; +} + +.typo h5, .typo h6, .typo-h5, .typo-h6 { + font-size: 1.2em; +} + +/* 在文章中，应该还原 ul 和 ol 的样式 */ +.typo ul, .typo-ul { + margin-left: 1.3em; + list-style: disc; +} + +.typo ol, .typo-ol { + list-style: decimal; + margin-left: 1.9em; +} + +.typo li ul, .typo li ol, .typo-ul ul, .typo-ul ol, .typo-ol ul, .typo-ol ol { + margin-bottom: 0.8em; + margin-left: 2em; +} + +.typo li ul, .typo-ul ul, .typo-ol ul { + list-style: circle; +} + +/* 同 ul/ol，在文章中应用 table 基本格式 */ +.typo table th, .typo table td, .typo-table th, .typo-table td, .typo table caption { + border: 1px solid #ddd; + padding: 0.5em 1em; + color: #666; +} + +.typo table th, .typo-table th { + background: #fbfbfb; +} + +.typo table thead th, .typo-table thead th { + background: #f1f1f1; +} + +.typo table caption { + border-bottom: none; +} + +/* 去除 webkit 中 input 和 textarea 的默认样式 */ +.typo-input, .typo-textarea { + -webkit-appearance: none; + border-radius: 0; +} + +.typo-em, .typo em, legend, caption { + color: #000; + font-weight: inherit; +} + +/* 着重号，只能在少量（少于100个字符）且全是全角字符的情况下使用 */ +.typo-em { + position: relative; +} + +.typo-em:after { + position: absolute; + top: 0.65em; + left: 0; + width: 100%; + overflow: hidden; + white-space: nowrap; + content: "・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・"; +} + +/* Responsive images */ +.typo img { + max-width: 100%; +} diff --git a/libs/typo.css/package.json b/libs/typo.css/package.json index cea84be58..4d3795fab 100644 --- a/libs/typo.css/package.json +++ b/libs/typo.css/package.json @@ -1,22 +1,27 @@ { "name": "typo.css", "filename": "typo.css", - "version": "1.1", + "version": "2.1.2", "description": "一致化浏览器排版效果，构建最适合中文阅读的网页排版", - "homepage": "http://typo.sofish.de", + "homepage": "http://typo.sofi.sh", "keywords": [ - "typo", "css" - ], - "maintainers": [ - { - "name": "Sofish Lin", - "web": "http://sofish.de/" - } - ], - "repositories": [ - { + "typo", + "css" + ], + "maintainers": [ + { + "name": "Sofish Lin", + "web": "http://sofish.de/" + }, + { + "name": "gclove", + "web": "https://github.com/gclove" + } + ], + "repositories": [ + { "type": "git", "url": "https://github.com/sofish/typo.css" } - ] -} + ] +} \ No newline at end of file