如何从命令行运行 Saxon

Question

谁能发布详细的分步说明如何安装 Saxon (10 HE) 以及如何在 MacOS (10.13.6) 中从命令行运行转换？

我已经在我的电脑上安装了 Java。
我已经从 SourceForge 下载了SaxonHE10-6J.zip 文件。
根据here 的建议，我已将saxon-he-10.6.jar 放在myUserName/Library/Java/Extensions 文件夹中。
然后我打开终端应用程序并输入基于this answer的命令：

java -jar saxon-he-10.6.jar -'/Users/myUserName/Documents/path/to/mystylesheet.xsl' -s:'/Users/myUserName/Documents/path/to/some.xml'

这会导致：

Unable to access jarfile saxon-he-10.6.jar

我的所有尝试，包括将 .jar 文件移动到 /Library/Java/Extensions directory 或在命令中包含 .jar 文件的完整路径，都失败并显示相同的错误消息。

请注意，我不是 Java 开发人员，我不打算在应用程序中使用它。我想要的只是能够偶尔进行一次转换。

我还应该注意，我的 XML 和 XSLT 文件的位置可能会因情况而异。我希望能够将 .jar 文件保存在一个恒定位置并根据需要提供 XML 和 XSLT 文件的路径 - IOW，我想要一个命令模板，我只需要更改 2 个文件路径（可能为转换添加一些选项）。

我需要做什么？

Answer 1

我自己从不使用它：但是 myUserName/Library/Java/Extensions 就类路径而言是特殊的（您不需要将 JAR 文件放在类路径上的此目录中），但就类路径而言它并不特殊与 -jar 选项有关 - 它需要是正常方式的绝对或相对文件名，与类路径无关。

如果您选择将 JAR 文件放在这个神奇的位置，那么我将使用命令 java net.sf.saxon.Transform options 从类路径中选择 Saxon，而不是直接识别 -jar 位置。

不过，不把撒克逊人放在这个神奇的地方是有充分理由的；一个原因是它会影响实际上不想使用 Saxon 的应用程序（它们可能被编写为使用其他一些 XSLT 处理器，而您可能实际上根本不知道它们使用 XSLT，直到它们停止工作）。

Answer 2

最终我得到了它的工作。虽然这些并不是我所希望的详细的分步说明，但我将在此总结我到目前为止所学到的知识。希望这可以让我免去我不得不经历的几个小时的挫败感。

• 确保您的计算机上安装了 Java。如果没有，请下载 从 Oracle 安装。

• 从 SourceForge 下载 Saxon。解压缩并将其放在您的任意位置 硬盘，除了：

  • 不要放在/Library/Java/Extensions或myUserName/Library/Java/Extensions；
  • 请勿将其放置在名称中包含/ 的文件夹中（请参阅下面的说明）。

• 要启动转换，请发出命令：

  java -jar 'path/to/saxon-he-10.6.jar' -xsl:'path/to/mystylesheet.xsl' -s:'path/to/some.xml'
  

• 或者，您可以使用：

  java -cp 'path/to/saxon-he-10.6.jar' net.sf.saxon.Transform -xsl:'path/to/mystylesheet.xsl' -s:'path/to/some.xml'
  

  此表单也可用于运行 XQuery，方法是更改 net.sf.saxon.Transform 到 net.sf.saxon.Query。

• 要为您的命令添加更多选项和/或参数，请参阅 此处给出的说明：
  https://www.saxonica.com/html/documentation10/using-xsl/commandline/
  但不要按照页面顶部关于 基本命令的形式。

欢迎指正/补充。

---

文件夹名称包含/的问题描述：

1. 将所有 3 个文件（saxon-he-10.6.jar、mystylesheet.xsl 和 some.xml 在我的 Documents 文件夹中名为 XML/RSS 的文件夹中；

2. 运行以下命令：

   java -jar '/Users/myUserName/Documents/XML:RSS/saxon-he-10.6.jar' -xsl:'/Users/myUserName/Documents/XML:RSS/mystylesheet.xsl' -s:'/Users/myUserName/Documents/XML:RSS/some.xml' 
   

   收到以下错误：

   Error: Could not find or load main class net.sf.saxon.Transform Caused by: java.lang.ClassNotFoundException: net.sf.saxon.Transform
   

3. 仅将 .jar 文件移动到父文件夹并运行以下命令 命令：

   java -jar '/Users/myUserName/Documents/saxon-he-10.6.jar' -xsl:'/Users/myUserName/Documents/XML:RSS/mystylesheet.xsl' -s:'/Users/myUserName/Documents/XML:RSS/some.xml' 
   

   结果：成功转型。

4. 将 .jar 文件移回，将文件夹重命名为 XMLRSS 并运行 以下命令：

   java -jar '/Users/myUserName/Documents/XMLRSS/saxon-he-10.6.jar' -xsl:'/Users/myUserName/Documents/XMLRSS/mystylesheet.xsl' -s:'/Users/myUserName/Documents/XMLRSS/some.xml' 
   

   结果：成功转型。