Documentation/zh/web/manuals.itexi

   1 \input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: zh -*-
   2 @c This file is part of web.texi
   3 @ignore
   4     Translation of GIT committish: 46ec3bd9ded640faef62938929a0af97345cf955
   5
   6     When revising a translation, copy the HEAD committish of the
   7     version that you are working on.  See TRANSLATION for details.
   8 @end ignore
   9
  10 @c Translators: Ben Luo
  11
  12 @node 手册
  13 @unnumbered 手册
  14 @translationof Manuals
  15
  16 @macro details{reference}
  17 @spanClass{detail}
  18 (@ref{\reference\, details of \reference\})
  19 @spanEnd
  20 @end macro
  21
  22 @divClass{heading-center}
  23 @ifclear web_version
  24   @heading LilyPond @version 手册
  25 @end ifclear
  26 @ifset web_version
  27   @heading LilyPond @versionStable 手册
  28 @end ifset
  29
  30 @divEnd
  31
  32 @divClass{link-headings}
  33
  34 @divClass{column-center-top}
  35
  36
  37 @subheading 简介
  38
  39 @itemize
  40
  41 @item
  42 @ref{Text input}:
  43 LilyPond 是@strong{基于文本} 的音乐雕版印刷程序。首先读这里！
  44
  45 @item
  46 @ifWebLinks{@manualStableLearningSplitNoName,@rlearningnamed{Top,Learning}}
  47  @qq{must-read} LilyPond 的简单介绍。
  48 @details{Learning}
  49
  50 @item
  51 @ifWebLinks{@manualStableGlossarySplitNoName,@rglosnamed{Top,Glossary}}
  52 @emph{(optional reading)} 音乐术语和翻译。
  53 @details{Glossary}
  54
  55 @item
  56 @ifWebLinks{@manualStableEssaySplitNoName,@ressaynamed{Top,Essay}}
  57 @emph{(optional reading)} 计算机雕版印刷程序的背景信息。
  58 @details{Essay}
  59
  60 @end itemize
  61
  62 @divEnd
  63
  64 @divClass{column-left-top}
  65
  66 @subheading 正式用法
  67
  68 @itemize
  69
  70 @item
  71 @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}}
  72 语法参考。
  73 @details{Notation}
  74
  75 @item
  76 @ifWebLinks{@manualStableUsageSplitNoName,@rprogramnamed{Top,Usage}}
  77 运行程序。
  78 @details{Usage}
  79
  80 @item
  81 @ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Snippets}}
  82 短的技巧和窍门。
  83 @details{Snippets}
  84
  85 @end itemize
  86
  87 @divEnd
  88
  89
  90 @divClass{column-right-top}
  91
  92 @subheading 不常用的用法
  93
  94 @itemize
  95
  96 @item
  97 @ref{FAQ}:
  98 常见问题。
  99
 100 @item
 101 @ref{Top, Web}:
 102 本文档。
 103 @details{Web}
 104
 105 @item
 106 @ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Changes}}
 107 有什么新东西？
 108 @details{Changes}
 109
 110 @item
 111 @ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extending}}
 112 有想像力的调整。
 113 @details{Extending}
 114
 115 @item
 116 @ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Internals}}
 117 调整参考。
 118 @details{Internals}
 119
 120 @end itemize
 121
 122 @divEnd
 123
 124
 125 @divClass{column-center-bottom}
 126
 127 @subheading 其它资料
 128 @itemize
 129
 130 @item
 131 @ref{Translated}:
 132 针对非英语读者的翻译情况。
 133
 134 @item
 135 @ref{All}:
 136 可下载和旧的手册。
 137
 138 @item
 139 @ref{Development}:
 140 不稳定版的手册
 141
 142 @item
 143 @ref{FDL}:
 144 这些文档在 GNU 自由文档许可证下发行。
 145
 146 @end itemize
 147
 148 @divEnd
 149
 150 @divEnd
 151
 152
 153 @divClass{hide}
 154
 155 @menu
 156 * 学习::        学习。
 157 * 术语表::      术语表。
 158 * 文章::        文章。
 159 * 五线谱::      参考。
 160 * 使用::        使用。
 161 * 片断::        片断。
 162 * 常见问题::    常见问题。
 163 * Web::         Web.
 164 * 变化::        新闻。
 165 * 扩展::        编程。
 166 * 内部::        内部。
 167 * 翻译::        翻译。
 168 * 所有::        所有手册。
 169 * FDL::         许可证。
 170 @end menu
 171
 172 @divEnd
 173
 174
 175 @c TRANSLATORS, most of the text in this file came from
 176 @c LM 1.1 About the documentation  (before this section was
 177 @c removed in July 2009).
 178
 179 @node 学习
 180 @unnumberedsec 学习
 181 @translationof Learning
 182
 183 @divClass{column-left-top}
 184 @subheading 学习手册
 185 本书解释了如何开始学习 LilyPond，同时也用简单的术语解释了一些关键的概念。
 186 你应该顺序地读这些章节。
 187
 188 在每一大段的后面有@strong{参见}一段，它包含有对其它大段的交叉参考：
 189 在第一次阅读的时候你不应该去看这些交叉参考。当你读完所有手册，你可能希望
 190 再读某些段，并去看些交叉参考来得到更多的信息。
 191 @divEnd
 192
 193 @divClass{column-right-bottom}
 194
 195 @docLinks{Learning, learning,
 196   @rlearningnamed{Top,Learning},
 197   @manualStableLearningSplit,
 198   @manualStableLearningBig, 1.5 MB,
 199   @manualStableLearningPdf, 3 MB}
 200
 201 @divEnd
 202
 203 @node 术语表
 204 @unnumberedsec 术语表
 205 @translationof Glossary
 206
 207 @divClass{column-left-top}
 208 @subheading 术语表
 209 这解释了音乐术语也包括了不同语言的翻译。如果你对五线谱不熟悉，或者对音乐术语（尤其如果你不是以英语为母语的人）不熟悉，强烈建议你看术语表。
 210
 211 @divEnd
 212
 213 @divClass{column-right-bottom}
 214
 215 @docLinks{Music glossary, music-glossary,
 216   @rglosnamed{Top,Music glossary},
 217   @manualStableGlossarySplit,
 218   @manualStableGlossaryBig, 1 MB,
 219   @manualStableGlossaryPdf, 1.5 MB}
 220
 221 @divEnd
 222
 223
 224 @node 文章
 225 @unnumberedsec 文章
 226 @translationof Essay
 227
 228
 229 @divClass{column-left-top}
 230 @subheading 文章
 231
 232 本书给出了音乐出版的简要历史，随后检查了 LilyPond 的雕版印刷技术。
 233 也对比了 LilyPond 和其它雕版印刷系统的不同。
 234
 235 @warning{更详细的印刷例子都是以PDF的形式进行分析，因为PDF版本有更高的分辨率。}
 236
 237 @divEnd
 238
 239 @divClass{column-right-bottom}
 240
 241 @docLinks{Essay, essay,
 242   @ressaynamed{Top,Essay},
 243   @manualStableEssaySplit,
 244   @manualStableEssayBig, 2 MB,
 245   @manualStableEssayPdf, 2.5 MB}
 246
 247 @divEnd
 248
 249 @node 五线谱
 250 @unnumberedsec 五线谱
 251 @translationof Notation
 252
 253 @divClass{column-left-top}
 254 @subheading 五线谱参考
 255 本书解释了 LilyPond 所有生成五线谱的命令。
 256
 257 @warning{五线谱参考假设读者知道学习手册里的基本资料，也熟悉在术语表里
 258 英语音乐术语。}
 259
 260 @divEnd
 261
 262 @divClass{column-right-bottom}
 263
 264 @docLinks{Notation, notation,
 265   @rusernamed{Top,Notation},
 266   @manualStableNotationSplit,
 267   @manualStableNotationBig, 7 MB,
 268   @manualStableNotationPdf, 18 MB}
 269
 270 @divEnd
 271
 272
 273 @node 使用
 274 @unnumberedsec 使用
 275 @translationof Usage
 276
 277 @divClass{column-left-top}
 278 @subheading 使用手册
 279
 280 这本书解释如何执行程序，如何让 LilyPond 五线谱和其它程序集成，也提出
 281 一些为了有效使用的 @qq{best practices} 。
 282
 283 @divEnd
 284
 285 @divClass{column-right-bottom}
 286
 287 @docLinks{Usage, usage,
 288   @rprogramnamed{Top,Usage},
 289   @manualStableUsageSplit,
 290   @manualStableUsageBig, 300 KB,
 291   @manualStableUsagePdf, 400 KB}
 292
 293 @divEnd
 294
 295 @node 片断
 296 @unnumberedsec 片断
 297 @translationof Snippets
 298
 299 @divClass{column-left-top}
 300 @subheading 片断
 301
 302 这里显示的 LilyPond 片断集是从
 303 @uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}
 304 (LSR)来的。所有的片断都是在公共域内。
 305
 306 注意：本文档不是 LSR 的精确子集。LSR 运行在 LilyPond 的稳定版上，所以任何
 307 发行版中有关新特性的示例必须单独添加。它们保存在 @file{Documentation/snippets/new/}  LilyPond 的源代码树里。
 308
 309 The list of snippets for each subsection of the Notation are also
 310 linked from the @strong{参见} portion.
 311 @divEnd
 312
 313 @divClass{column-right-bottom}
 314
 315 @docLinks{Snippets, snippets,
 316   @rlsrnamed{Top,Snippets},
 317   @manualStableSnippetsSplit,
 318   @manualStableSnippetsBig, 2.5 MB,
 319   @manualStableSnippetsPdf, 8 MB}
 320
 321 @divEnd
 322
 323 @node 常见问题
 324 @unnumberedsec 常见问题
 325 @translationof FAQ
 326
 327 @divClass{column-center-top}
 328 @subheading 问题简介
 329
 330 @subsubheading Where are the graphical canvas, menus, and toolbars?
 331
 332 LilyPond 要求你以文本的方式写音乐。请阅读有关我们的 @ref{Text input}.
 333
 334 @subsubheading 这里有很多文档！我都要读吗？
 335
 336 你需要读 @ref{Learning, Learning manual}。对于其它文档，你只需要读那些和
 337 你创作有关的段落。
 338
 339 @subsubheading 那里仍然有许多读物！这值得吗？
 340
 341 请你自己决定；那些你可能想要用 LilyPond 的原因在 @ref{Introduction}里。
 342
 343 @divEnd
 344
 345 @divClass{column-center-bottom}
 346 @subheading 使用的问题
 347
 348 @subsubheading 有些不工作！我如何修正？
 349
 350 这在 @rprogram{Troubleshooting}里解释。
 351
 352 @subsubheading 为什么你要改变语法？
 353
 354 这在 @rprogram{Why does the syntax change?} 里解释。
 355
 356 @divEnd
 357 @node Web
 358 @unnumberedsec Web
 359 @translationof Web
 360
 361 @divClass{column-left-top}
 362 @subheading Web
 363
 364 本手册提供了有关 LilyPond 的通用信息。它也包含了有关不同社区论坛，缺陷
 365 报告和开发的信息。
 366
 367 @divEnd
 368
 369 @divClass{column-right-bottom}
 370 @subheading 读它
 371
 372 @subsubheading 最新手册
 373
 374 @divClass{keep-bullets}
 375 @itemize
 376 @ref{Top,Web}
 377 @end itemize
 378 @divEnd
 379
 380 @subsubheading 在 @versionDevel 里的 Web 手册
 381
 382 @docLinksBare{Web, web,
 383   @ref{Top,Web},
 384   @manualDevelWebSplit,
 385   @manualDevelWebBig, 1 MB,
 386   @manualDevelWebPdf, 2 MB}
 387
 388 @divEnd
 389
 390 @node 变化
 391 @unnumberedsec 变化
 392 @translationof Changes
 393
 394 @divClass{column-left-top}
 395 @subheading 变化
 396
 397 这总结了从上一个稳定版的 LilyPond 之后的重要变化和新特性。
 398
 399 @divEnd
 400
 401 @divClass{column-right-bottom}
 402
 403 @docLinks{Changes, changes,
 404   @rchangesnamed{Top,Changes},
 405   @manualStableChangesSplit,
 406   @manualStableChangesBig, 6 KB,
 407   @manualStableChangesPdf, 200 KB}
 408
 409 @divEnd
 410
 411 @node 扩展
 412 @unnumberedsec 扩展
 413 @translationof Extending
 414
 415 @divClass{column-left-top}
 416 @subheading 扩展 LilyPond
 417
 418 本手册解释了如何为 Lilypond 写扩展程序。
 419
 420 @divEnd
 421
 422 @divClass{column-right-bottom}
 423
 424 @docLinks{Extending, extending,
 425   @rextendnamed{Top,Extending},
 426   @manualStableExtendingSplit,
 427   @manualStableExtendingBig, 200 KB,
 428   @manualStableExtendingPdf, 400 KB}
 429
 430 @divEnd
 431
 432 @node 内部
 433 @unnumberedsec 内部
 434 @translationof Internals
 435
 436 @divClass{column-left-top}
 437 @subheading 内部参考
 438
 439 这是一个交叉链接页面的集合，这些页面把每一个 LilyPond 的类，对象和函数
 440 的本质细节进行了归档。它是从格式化好的源码中直接生成的。
 441
 442 几乎所有格式化好的内部函数用户可以直接使用。例如，绝大部分控制粗细值，距
 443 离等的变量可以在输入文件中改变。LilyPond 有大量格式化选项，所有这些选项
 444 都在这份文档中进行了描述。每一个五线谱的段都有一个子段 @b{参见}，它指向
 445 生成的文档。
 446
 447 @divEnd
 448
 449 @divClass{column-right-bottom}
 450
 451 @docLinks{Internals, internals,
 452   @rinternalsnamed{Top,Internals},
 453   @manualStableInternalsSplit,
 454   @manualStableInternalsBig, 2.5 MB,
 455   @manualStableInternalsPdf, 2.8 MB}
 456
 457 @divEnd
 458
 459 @node 翻译
 460 @unnumberedsec 翻译
 461 @translationof Translated
 462
 463 @divClass{column-center-bottom}
 464 @subheading 翻译状态
 465 @include translations.itexi
 466 @divEnd
 467
 468 @node 所有
 469 @unnumberedsec 所有
 470 @translationof All
 471
 472 @divClass{column-left-top}
 473 @subheading 可下载的版本
 474 @ifclear web_version
 475 可下载的压缩包只在 @uref{http://lilypond.org} 可见。
 476 @end ifclear
 477 @ifset web_version
 478
 479 @divClass{keep-bullets}
 480 @itemize
 481
 482 @item @doctarballStable
 483
 484 @end itemize
 485
 486 @divEnd
 487 @end ifset
 488
 489 @divEnd
 490
 491 @divClass{column-right-bottom}
 492 @subheading 前一个稳定版
 493 @divClass{keep-bullets}
 494 @itemize
 495
 496 @item @uref{http://lilypond.org/doc/v2.12/Documentation/,
 497 LilyPond 2.12 Documentation}
 498
 499 @item @uref{http://lilypond.org/doc/v2.11/Documentation/,
 500 LilyPond 2.11 Documentation}
 501
 502 @item @uref{http://lilypond.org/doc/v2.10/Documentation/,
 503 LilyPond 2.10 Documentation}
 504
 505 @item @uref{http://lilypond.org/doc/v2.8/Documentation/,
 506 LilyPond 2.8 Documentation}
 507
 508 @item @uref{http://lilypond.org/doc/v2.6/Documentation/,
 509 LilyPond 2.6 Documentation}
 510
 511 @item @uref{http://lilypond.org/doc/v2.4/Documentation/out-www/,
 512 LilyPond 2.4 Documentation}
 513
 514 @item @uref{http://lilypond.org/doc/v2.2/Documentation/out-www/,
 515 LilyPond 2.2 Documentation}
 516
 517 @item @uref{http://lilypond.org/doc/v2.0/Documentation/out-www/,
 518 LilyPond 2.0 Documentation}
 519
 520 @item @uref{http://lilypond.org/doc/v1.8/Documentation/out-www/,
 521 LilyPond 1.8 Documentation}
 522
 523 @item @uref{http://lilypond.org/doc/v1.6/Documentation/out-www/,
 524 LilyPond 1.6 Documentation}
 525
 526 @end itemize
 527
 528 @divEnd
 529 @divEnd
 530
 531 @node FDL
 532 @unnumberedsec FDL
 533 @translationof FDL
 534
 535 @divClass{column-center-top}
 536 @subheading 文档许可证
 537 GNU LilyPond 在 GNU 通用公共许可证下发布。
 538 在 @ref{Freedom} 里我们介绍了这个许可证以及我们选择它的原因。
 539
 540 @divEnd
 541
 542 @divClass{column-center-bottom}
 543 @subheading GNU 自由文档许可证 1.1
 544 @include fdl.itexi
 545 @divEnd