文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载pw-midiplay是 tldr 文档仓库中针对 PipeWire 播放工具的一个别名页alias page它指向pw-cat --playback --midi专门用于播放 MIDI 文件。本文以该别名页为核心介绍它的查询方式、背后原命令的完整 MIDI 用法以及 tldr 项目如何用模板和脚本维护这类别名页。别名页的核心内容pw-midiplay 指向什么在 tldr 仓库中pages.ar/linux/pw-midiplay.md 是一份阿拉伯语别名页正文仅保留两个核心信息# pw-midiplay هذا الأمر هو اسم مستعار لـ pw-cat --playback --midi. - إعرض التوثيقات للأمر الأصلي: tldr pw-cat翻译过来即pw-midiplay是pw-cat --playback --midi的别名——也就是说执行pw-midiplay等价于通过 PipeWire 以回放playback模式处理 MIDI 数据查看原命令文档tldr pw-cat。与其英文原版 pages/linux/pw-midiplay.md内容为 This command is an alias ofpw-cat --playback --midi.加tldr pw-cat完全对应只是按项目阿拉伯语模板做了翻译。这样的页面在整个仓库共有 39 个语言版本分布在pages.*各语言目录的linux/平台目录下。在 tldr 客户端中如何查询与使用安装了任一 tldr 客户端后查询别名命令的方式与普通命令一致tldr pw-midiplay客户端会渲染出上面的别名页告诉你该命令真实身份是pw-cat --playback --midi并提示你查看原命令文档。接着执行tldr pw-cat即可获得 PipeWire 音频播放/录制工具pw-cat的完整速查页。实际要运行 MIDI 播放时直接输入pw-midiplay或在终端执行pw-cat --playback --midi均可因为pw-midiplay本质上就是后者的便捷别名。原命令pw-cat的 MIDI 实战用法既然pw-midiplay只是入口真正的能力集中在原命令 pages/linux/pw-cat.md 中。pw-cat用于通过 PipeWire 播放和录制音频文件它同时列出wpctl、pw-cli作为相邻参考命令。与 MIDI 直接相关的用法如下播放一个 MIDI 文件这正是pw-midiplay展开后的形式pw-cat --playback --midi {{path/to/file.mid}}录制 MIDI 文件pw-cat --record --midi {{path/to/file.mid}}--playback回放与--record录制是pw-cat的两大核心模式--midi则把 I/O 方向切到 MIDI 类型因此别名页把pw-midiplay定义为pw-cat --playback --midi——它只负责 MIDI 回放录制方向请直接用pw-cat --record --midi。pw-cat还支持其他媒体类型与参数方便与 MIDI 用法对照模式命令示例用途回放 WAVpw-cat --playback {{path/to/file.wav}}默认目标设备播放 WAV回放 DSDpw-cat --playback --dsd {{path/to/file.dsf}}播放 DSD 文件直通压缩音频pw-cat --playback --encoded {{path/to/file.ac3}}需 FFmpeg 集成的 passthrough 播放指定重采样质量pw-cat --playback --quality {{0..15}} {{path/to/file.wav}}质量档 0–15默认 4录制音量pw-cat --record --volume {{1.25}} {{path/to/file.wav}}以 125% 音量录制录制采样率pw-cat --record --rate {{6000}} {{path/to/file.wav}}自定义采样率录制对比可见--midi、--dsd、--encoded是同层级的媒体格式开关而--quality、--volume、--rate属于跨格式的通用参数。tldr 别名页的仓库级规范模板与自动生成pw-midiplay.md并非手工随意书写而是严格遵循项目的别名页模板。在 contributing-guides/translation-templates/alias-pages.md 中阿拉伯语模板### ar定义如下# example هذا الأمر هو اسم مستعار لـ example. - إعرض التوثيقات للأمر الأصلي: tldr example该模板同时规定了 39 种语言的统一结构所有别名页都要求三要素#标题、描述行声明原命令、以及一条tldr 原命令示例行。页面上文件名为pw-midiplay.md、标题为pw-midiplay、原命令为pw-cat --playback --midi、查询命令为pw-cat正是模板中四个example占位符被逐一替换的结果。这个替换过程由仓库脚本 scripts/set-alias-page.py 自动化完成。从源码看它的工作流程是generate_alias_page_content()按顺序把模板中的example替换为标题、原命令和文档命令见#L120-L142set_alias_page()按语言模板将别名页写入对应语言目录并对比现有内容决定新增/更新见#L145-L210sync_alias_page_to_locale()/get_english_alias_pages()负责把英文别名页同步到所有语言目录见#L285-L341。维护者可用如下命令同步所有语言的别名页或限定单语种、仅演练dry-runpython3 scripts/set-alias-page.py --sync # 同步全部语言 python3 scripts/set-alias-page.py --sync -l ar # 仅同步阿拉伯语 python3 scripts/set-alias-page.py --sync --dry-run # 预览变更此外contributing-guides/style-guide.md 的Aliases章节见#L96-L104说明当命令可用别名调用时例如vi之于vim就应创建别名页把用户引向原命令——pw-midiplay正是这一规范在 PipeWire 工具链上的实例。延伸PipeWire 工具链中的相邻命令pw-midiplay所在的 Linux 平台目录还收录了 PipeWire 生态的另外两个管理工具适合一起速查pages/linux/wpctl.md管理 WirePlumberPipeWire 的会话与策略管理器如wpctl status列出所有对象、wpctl set-volume {{sink_id}} {{n}}%设置音量、wpctl set-mute DEFAULT_SINK {{1|0|toggle}}静音/取消静音pages/linux/pw-cli.md管理 PipeWire 实例的模块、对象、节点、设备与链接如pw-cli ls {{Node|Link|Port|Client|...}}列出指定类型对象、pw-cli info {{4}}按 ID 查看对象信息。三者角色互补pw-cat及其别名pw-midiplay负责实际播放/录制wpctl负责会话级控制pw-cli负责底层对象管理共同覆盖 PipeWire 的日常操作。小结pw-midiplay的 tldr 别名页虽短却完整体现了项目的两类设计对外它以最简信息告诉用户该命令就是pw-cat --playback --midi并通过tldr pw-cat引导至包含全部播放/录制参数的完整速查页对内它是模板alias-pages.md与自动化脚本set-alias-page.py协同产出的标准产物。需要播放 MIDI 文件时直接运行pw-midiplay {{path/to/file.mid}}即可需要更复杂操作则回到pw-cat的完整参数体系。赞分享文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载相关推荐tldr 仓库中的 fdfind 别名页命令别名文档机制与 fd 命令速查tldr 仓库中的 fdfind 别名页命令别名文档机制与 fd 命令速查 导读 本文围绕 fdfind.md https://link.gitcode.co文档教程知识库Delve 服务端/客户端 API 接口全解析从 JSON-RPC 到 DAP 的集成开发指南Delve 服务端/客户端 API 接口全解析从 JSON RPC 到 DAP 的集成开发指南 DelveGo 语言调试器不仅自带交互式终端客户端还通过文档教程知识库PixiJS v8 HTMLText 实战指南用 SVG foreignObject 在 WebGL 中渲染富文本 HTML/CSSPixiJS v8 HTMLText 实战指南用 SVG foreignObject 在 WebGL 中渲染富文本 HTML/CSS HTMLText 是 P文档教程知识库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考