go x/tools/cmd/present: 添加对引号的支持

q43xntqr  于 4个月前  发布在  Go
关注(0)|答案(7)|浏览(38)

这个建议是关于在现有工具中添加对引用的支持。
一个实现在这里:golang/tools/pull/30
它将“quote”功能引入模板,以插入引用和引文。
在处理样式后,“.quote”后的文本嵌入到一个blockquote元素中。在处理样式后,可选的“//CITATION:”后的文本被视为引用,并嵌入到cite元素中。
示例:

.quote Never memorize something that you can look up //CITATION: Albert Einstein
yiytaume

yiytaume1#

/cc @andybons@dmitshur

klr1opcd

klr1opcd2#

感谢您的提议!

从观察的Angular 来看,接受这个提议将导致以当前格式提供的调用次数从8增加到9:

.code x.go /^func main/,/^}/
 .play y.go
 .image image.jpg
 .background image.jpg
 .iframe http://foo
 .link http://foo label
 .html file.html
 .caption _Gopher_ by [[https://www.instagram.com/reneefrench/][Renée French]]
+.quote Never memorize something that you can look up //CITATION: Albert Einstein

这意味着现有用户需要学习一个额外的动词,并在何时使用它而不是不使用它时做出决策。

@lucor 在您的提议中,您描述了这种新的调用方式,但没有太多的理由说明为什么要添加它以及它打算解决什么问题。

您能否详细说明它将如何融入整个当前格式?在提出这个提议之前,在当前演讲中添加引用的经验是什么,以及在提出这个提议之后它是如何改变的?提供一些当前文本的例子以及渲染结果的屏幕截图将会非常有帮助。

乍一看,它似乎与标题调用相似/相关。标题是否可以用来替代引用以达到类似的效果,还是专用的引用调用是有道理的?

pzfprimi

pzfprimi3#

@dmitshur 感谢反馈!
目前看来,在当前的演讲中无法将某些文本高亮显示为引用。
这个想法是将引用呈现为HTML blockquote元素。
示例:

* Quote Example

.quote Never memorize something that you can look up //CITATION: Albert Einstein

关于标题调用,这也是我最初的尝试...但如果它似乎与为图片添加标题有关。

s4n0splo

s4n0splo5#

感谢提供示例和截图,这非常有帮助。
目前看来,在当前的演讲中无法将某些文本高亮显示为引用。
我不确定你是否意味着“除了使用iframe”,但如果不是,可以通过使用自定义HTML/CSS的iframe来实现。
我见过一些使用iframe的例子,用于实现当前格式不提供原生支持的功能。当然,这样做不太方便,需要更多的工作,但好处是任何自定义行为都是可能的,而且特殊当前语法的数量保持得更小。例如,在这个幻灯片上的灰色文本框上用鼠标点击会通过iframe出现一只Gopher。
为了做出一个明智的决定,判断这个引用功能是否值得在当前格式中获得一流的语法支持,我认为提供一些关于现有的当前演讲的统计数据是有帮助的,看看人们尝试包含引用的频率有多高。
如果结果表明有相当数量的此类演讲,那么我们应该接受这个建议。但如果结果表明很少有现有的演讲倾向于包含引用,那么最好不要添加新的语法,让人们继续依赖iframe来为他们的演讲实现自定义功能。

rkkpypqq

rkkpypqq6#

感谢您的反馈。
我不确定您是否意味着“除了使用iframe之外”,但如果不是,那么可以使用自定义HTML/CSS的iframe来实现。
抱歉,我没有意识到可以通过iframe添加它。
如果发现有大量的此类演讲,那么我们应该接受这个建议。但是,如果发现现有的演讲中很少包含引用,那么最好不要添加新的语法,让人们继续依赖iframe来实现他们的演讲的自定义功能。
同意 :)

pgvzfuti

pgvzfuti7#

让我们试试这个。我们会边做边解决的。

相关问题