[LinuxCNC/linuxcnc PR#190] fix docs/2.7/2.8 add img alt

未分类 bolang 4个月前 (10-15) 23次浏览

Issue #190 | 状态: 已关闭 | 作者: tseufl | 创建时间: 2016-10-22


For HTML output, it is recommended with asciidocs the alt-tag to use on images (e. g. for seo).
Recommended for PDF output with asciidocs it is to use the “caption” attribute.
At the moment a “.title” command is this still about 90 percent of cases used for captions.
Maybe I’ll replace later this “.title” commands with caption tags …
Signed-off-by: Thoren Seufl t_seufl@gmx.de


评论 (4)

#1 – SebKuzminsky 于 2016-10-23

Are these commits intended for master or 2.7?


#2 – tseufl 于 2016-10-23

@SebKuzminsky
for 2.7 and 2.8 (master).
at the moment, all the image-alt-tags in the docs on the website contains the path and filename.
Example: view-source: http://linuxcnc.org/docs/2.7/html/user/starting-linuxcnc.html (line 61).
For the image-alt-tag is not intended as used at the moment …

In the asciidoc-engine you could probably turn off (path and file name in image-alt-tag) but currently (2.7) and for the future (2.8) should be the image-alt-tag-attribute for seo [search engine optimization] use…

Consistently, it would have to actually go back to the oldest available html version which uses images in the docs …


#3 – jepler 于 2017-05-11

This encounters a build error on debian jessie
~~~~
-image::images/tkemc-override-limits.png[align=”center”]
+image::images/tkemc-override-limits.png[align=”center”, alt=”TkLinuxCNC Override Limits & Jogging increments example”]
~~~~

~~~~
/home/jepler/src/linuxcnc/master/docs/src/Master_Documentation.xml:10701: parser error : xmlParseEntityRef: no name
TkLinuxCNC Override Limits & Jogging increments example


#4 – jepler 于 2017-05-11

I merged this to master only.


原始Issue: https://github.com/LinuxCNC/linuxcnc/pull/190

喜欢 (0)