注释
.png "新的 asciidoc 语法问题 #1717"){kind=avatar}
|
哎哟。谢谢你。我也不确定，在发布之前我/每个人都应该通读文档以检查是否存在明显的混乱。我相信只有空白被触及。而“+”，我想他们可以走了。会检查。 |
.png "新的 asciidoc 语法问题 #1717"){kind=avatar}
|
大海。20 平均 2022 年 17:13，塞巴斯蒂安·库兹明斯基 ***@***.***> 评论：
An asciidoc syntax problem was introduced in @smoe < https://github.com/smoe > ‘s commit fb3e8fb < fb3e8fb > : The commit before is wrong, but in a different way: 我不确定正确的asciidoc语法是什么应该在这里，但两者都不是；-)
|
|
大海。20 平均 2022 年 17:34，Steffen Möller ***@***.***> 评论：
哎哟。谢谢你。我也不确定，在发布之前我/每个人都应该通读文档以了解明显的混乱。我相信只有空白被触及。而“+”，我想他们可以走了。会检查。
这确实是一个缩进问题，其中链接块（带有“+”）不应在源代码中缩进，但仍会在输出中继承格式（以及缩进）。链接是在两个连续块之间的行的开头单独使用单个“+”完成的，例如，允许将列表条目的内容扩展到多个段落、代码块等。
|
|
我被分配了 – 太棒了 |
不过我真的不知道这意味着什么。我的理解是，一旦我们合并，这个问题就会消失.jpg "新的 asciidoc 语法问题 #1717"){kind=avatar}
|
我注意到在文档的主版本中删除了换行符。我在 qtvcp 文档中注意到了。 |
|
首先，我可能需要道歉，我承认在语言之间同步时删除了“+”。从技术上讲，一旦文档同步（现在），我们就可以再次介绍它们。 我删除“+”可能会破坏某些东西。我刚刚检查了一下，是的，需要重新添加一些换行符。其他的删除都很好（适合我的阅读风格）。我可以想到很多更改来尝试在不缩短行的情况下提高可读性 – 你会允许吗@silopolis（谁可能是起草风格指南的人）和我自己与您一起对您的 qtvcp 文档进行头脑风暴？这是一个非常好的（而且很长）文档。我喜欢。 |
|
感谢您的回复和您对文档的辛勤工作。 |
|
感谢您的建设性和善意的答复。 我的想法是将文档视为对话。段落的第一句话介绍了一个事实或概念——然后你可以（假想的）看着与你（假想的）交谈的人的眼睛，这样你就可以评估那个人是否有兴趣听那段的其余部分. 读者将继续阅读该段落或跳至下一段并阅读下一个第一句，依此类推。这允许根据读者的体验/兴趣调整阅读体验。在这些段落之间还有一些额外的空白。 我试着按照这个基本概念来格式化我的回复。其他位解决拼写一致性（QtVCP/Qtvcp/…）、代码和叙述的分离。 |
|
哎哟，现在看起来确实有点笨重? 让我来为您解决这个问题… Le dim。2022 年 5 月 15 日 à 18:31，c-morley ***@***.***> a écrit :
感谢您的回复和您对文档的辛勤工作。
并感谢您在 QtVCP 上提供如此优质的文档！希望我们在整个过程中拥有相同的水平…
我当然对新想法持开放态度，但冗长无休止的段落（恕我直言）使找到相关信息变得更加困难。
绝对地 ！我的 PoV 是段落分隔应该既遵循内容的语义，也确实有助于识别/发现信息。
|
|
乐暗淡。2022 年 5 月 15 日 à 18:43，Steffen Möller ***@***.***> a écrit :
感谢您的建设性和善意的答复。我的想法是将文档视为对话。段落的第一句话介绍了一个事实或概念——然后你可以（假想的）看着与你（假想的）交谈的人的眼睛，这样你就可以评估那个人是否有兴趣听那段的其余部分. 读者将继续阅读该段落或跳至下一段并阅读下一个第一句，依此类推。这允许根据读者的体验/兴趣调整阅读体验。在这些段落之间还有一些额外的空白。
我喜欢它，而且布置得很好?
|
.jpg "新的 asciidoc 语法问题 #1717"){kind=avatar}
|
我对当前版本很满意。礼貌地撤消了我的任务，不应该。对不起。 |
|
这看起来已经在 master 中修复了，谢谢大家！ |
asciidoc语法问题被引入@smoe的提交fb3e8fb：
之前的提交是错误的，但是以不同的方式：
我不确定这里应该有什么正确的 asciidoc 语法，但这两者都不是；-)
我也不确定在fb3e8fb的所有修复中是否引入了任何其他新错误。