我正在使用DITA-OT 3.0.4。
我正在尝试使用以下命令将我的markdown文件转换为html5。
dita --input="note.ditamap" --output="out" --format=html5 --args.css=style.css --args.cssroot=metadata --args.copycss=yes --args.csspath=css
而且我有这些目录结构。
├── note.ditamap
├── metadata
│ ├── note.properties
│ └── style.css(this is my custom CSS)
作为上述命令的结果,转换成功,但是输出html(即index.html)不包含自定义CSS。
我也尝试使用这些命令和属性,但结果与以前相同。
dita --input="note.ditamap" --output="out" --format=html5 --propertyfile="metadata/note.properties"
这是
note.properties
内容。args.csspath = css
args.copycss = YES
args.css = style.css
args.cssroot = metadata
我发现输出html引用了
${DITA_INSTALL_DIR}/dita-ot-3.0.4/plugins/org.dita.html5/css/commonltr.css
,因此我将CSS附加到了它,预期的输出即将到来,但是我认为这样做不好,因为这些更改将影响所有其他项目。我在GitHub上检查了一些文档和问题,但是找不到解决方案。你有什么建议吗?
参考文献:
Customizing HTML with a .properties file
Adding custom CSS
Setting build parameters with .properties files
最佳答案
您的“ args.cssroot”作为相对位置“元数据”给出。
参数的文档说明如下:
The value you enter here will be interpreted relative to the location of the input map file.
但是从我在构建文件中查看的结果来看,这是不正确的,相对位置似乎相对于发布过程开始的当前文件夹(可能是“ DITA-OT \ bin”)。
因此,也许您可以尝试将args.cssroot作为绝对路径传递,看看它是否对您更好。
通常在这种情况下,我没有通过args.cssroot而是直接通过了“ args.css”作为绝对路径,这似乎也对我有用。