文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载本文以 tldr-pages 仓库中的 a2ping 孟加拉语速查页 为核心骨架结合仓库内英文原版 pages/common/a2ping.md、客户端规范 与样式指南 展开成文。读完本文你将掌握a2ping将图像转换为 EPS/PDF 的核心用法、压缩控制、HiResBoundingBox 处理、外部工具参数透传等全部速查条目并理解这类 tldr 页面中占位符与选项占位符的约定能够直接照抄运行、举一反三。a2ping 是什么a2ping是一款用于把图像image转换为 EPSEncapsulated PostScript或 PDF 文件的命令行工具。它常用于排版、打印出版以及文档预处理流程中当上游素材是位图或矢量图、而下游流程需要 EPS/PDF 时一条a2ping命令即可完成格式转换。在 tldr-pages 仓库中该命令的速查页被收录在common平台目录下见 pages/common/a2ping.md意味着它的行为在多数主流操作系统上保持一致属于“跨平台通用命令”。除了英文原版仓库还维护了孟加拉语pages.bn/common/a2ping.md、中文pages.zh/common/a2ping.md、西班牙语、印地语、印尼语、韩语、荷兰语等多个翻译版本页面结构完全对齐仅描述与占位符文案做了本地化。一、核心用法将图像转换为 PDFtldr 页面中的第一个示例就是最常用的操作——把一张图像转换成 PDFa2ping {{ছবি/এর/পাথ.ext}} {{আউটপুট/এর/পাথ.pdf}}对应的英文原版为a2ping {{path/to/image.ext}} {{path/to/output.pdf}}两条命令的语义一致第一个参数是输入图像路径如.ext所提示可携带任意图像扩展名第二个参数是输出 PDF 路径。注意指定输出文件名是可选的。即使省略第二个参数a2ping也能基于输入文件自动推导输出名称完成转换。这一点在描述行中已被明确标注是 tldr 速查页刻意保留的“实战提示”。换成一个可直接运行的例子把当前目录下的scan.png转成scan.pdfa2ping scan.png scan.pdf二、压缩控制--nocompress 指定压缩方法当转换结果体积过大时可以用--nocompress显式指定文档压缩方式a2ping --nocompress {{none|zip|best|flate}} {{ফাইল/এর/পাথ}}{{none|zip|best|flate}}是一个互斥参数占位符表示四选一取值含义none不做压缩zip使用 ZIP 压缩best使用最优压缩策略flate使用 FlateDEFLATE压缩算法# 用 Flate 压缩生成 PDF a2ping --nocompress flate scan.png scan.pdf--nocompress的措辞看似“否定式”但它实际上是对压缩行为的手动干预开关——tldr 页面以“使用指定方法压缩文档”来描述其意图使用时按需选择四种取值之一即可。压缩算法属于 tldr 样式指南要求使用反引号标注的技术词因此在页面中直接以none|zip|best|flate原样呈现参见 contributing-guides/style-guide.md 中关于zip、7z、xz等压缩算法书写规范的说明。三、HiResBoundingBox 扫描--nohiresPostScript/EPS 的页面边界框BoundingBox是下游排版引擎确定图像占位尺寸的依据而 HiResBoundingBox 则以更高精度描述边界。tldr 页面给出了相关控制项a2ping --nohires {{ফাইল/এর/পাথ}}默认行为是如果源文件包含 HiResBoundingBoxa2ping会将其扫描进输出文档从而获得更精确的版面尺寸。--nohires的作用关闭该扫描。描述行中的“若存在则扫描默认为是”点明了默认值与关闭开关的对应关系。当下游工具对高精度边界框兼容性不佳、或希望强制使用常规边界框时追加--nohires即可a2ping --nohires scan.png scan.pdf四、页面原点控制--belowa2ping允许内容相对于页面原点origin进行偏移tldr 页面记录了一个容易被忽略的开关a2ping --below {{ফাইল/এর/পাথ}}默认行为否默认情况下页面内容不允许出现在原点下方和左方。--below的作用放宽这一限制允许页面内容位于原点的下方和左侧。这一参数在处理负坐标内容、出血bleed区域或来源坐标不规整的图像时非常有用a2ping --below scan.png scan.pdf五、向外部程序透传参数a2ping的转换管线依赖外部工具如 Ghostscriptgs、pdftops等tldr 页面专门记录了两个“透传”开关a2ping --gsextra {{আর্গুমেন্ট}} {{ফাইল/এর/পাথ}} a2ping --extra {{আর্গুমেন্ট}} {{ফাইল/এর/পাথ}}选项目标程序典型用途--gsextragsGhostscript把额外参数直接传给 Ghostscript 解释器--extra外部程序如pdftops把额外参数传给 PDF 处理的外部程序# 向 gs 透传参数例如设定分辨率的选项 a2ping --gsextra -r300 scan.png scan.pdf # 向 pdftops 等外部程序透传参数 a2ping --extra --some-option value scan.png scan.pdf当遇到a2ping自身参数覆盖不到的底层需求时这两个选项提供了“逃生舱”不必放弃转换管线另起炉灶。六、帮助信息[-h|--help] 选项占位符速查页的最后一个示例展示如何查看帮助a2ping {{[-h|--help]}}这里的{{[-h|--help]}}是 tldr 规范中的选项占位符option placeholder左侧为短选项-h右侧为长选项--help由单个|分隔。根据 CLIENT-SPECIFICATION.md 中的定义客户端可以按用户偏好只显示短选项、只显示长选项或同时展示两者a2ping -h # 短选项 a2ping --help # 长选项这也呼应了 contributing-guides/style-guide.md 的约定跨平台通用页面优先使用 GNU 风格长选项但具体展示哪种形式由客户端决定因此写作时使用{{[-h|--help]}}这类占位符而非写死某一个。同时样式指南要求将帮助与版本命令放在页面最后两个示例本页正是以“显示帮助”收尾。七、深入理解tldr 页面背后的格式规范a2ping 这一页之所以信息密度高且可读是因为它严格遵循了 tldr-pages 的页面模板详见 contributing-guides/style-guide.md标题与描述首行# a2ping必须与命令名一致描述行以开头用一句话说明功能“将图像转换为 EPS 或 PDF 文件”并附带“更多信息”链接。示例数量单页最多 8 个示例本页恰好以 7 个示例覆盖了转换、压缩、边界框、原点、参数透传、帮助六个核心场景。命令式语气所有描述均以祈使句书写“Convert…”“Compress…”翻译页保持相同结构。占位符语法{{ }}用户需替换的值如{{path/to/image.ext}}、{{path/to/file}}客户端渲染时会高亮并移除花括号{{a|b|c}}互斥取值如{{none|zip|best|flate}}{{[-h|--help]}}短/长选项变体。此外孟加拉语翻译页pages.bn/common/a2ping.md中的ফাইল/এর/পাথ文件路径等占位符对应了 contributing-guides/translation-templates/common-arguments.md 里为每种语言统一维护的常用参数翻译表从而保证多语言页面之间占位符风格一致、便于客户端解析。小结通过 tldr-pages 仓库中的a2ping速查页英文原版见 pages/common/a2ping.md孟加拉语翻译见 pages.bn/common/a2ping.md中文翻译见 pages.zh/common/a2ping.md我们可以一条命令完成图像到 EPS/PDF 的转换并通过--nocompress、--nohires、--below、--gsextra、--extra五个开关精细控制压缩、边界框、页面原点与外部工具透传。同时该页面也是学习 tldr 占位符与选项占位符语法的极佳范例——掌握了{{ }}、{{a|b|c}}、{{[-h|--help]}}这三种写法你就能无障碍阅读整个仓库近万个速查页。赞分享文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载相关推荐Duix.Avatar终极指南零成本打造专属AI数字分身实战手册Duix.Avatar终极指南零成本打造专属AI数字分身实战手册 想象一下只需一段10秒视频就能拥有一个能说会道、表情生动的数字分身而且完全免费、完全离人工智能AI 应用数字人媒体生成桌面应用tldr-pages革命性命令行速查告别man手册冗长的终极指南tldr pages革命性命令行速查告别man手册冗长的终极指南 在Linux和Unix系统中 man 手册是开发者的必备工具但它常常因内容过于详尽而显得文档教程知识库tldr-pages 中的 openai 速查页全解析用 openai 命令行工具调用 OpenAI API 的实践指南tldr pages 中的 openai 速查页全解析用 openai 命令行工具调用 OpenAI API 的实践指南 本文以 tldr pages 仓库中文档教程知识库上一篇Argilla 数据集卡片模板解析to_hub 自动生成 Hugging Face Hub 数据集 README 的结构与原理下一篇从打不开的 .pkg 到能编辑的素材库Wallpaper Engine 资源提取完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考