个人中心
gpt4 book ai didi

java - 将 JavaHelp 用于有关基于 NetBeans 的应用程序、工具或插件的最终用户文档以使其更容易？

转载 作者：行者123 更新时间：2023-11-30 09:38:49 24 4
gpt4 key购买 nike

这篇文章的顶部较短的部分是我想要做的。第二部分是到目前为止已经完成的工作。它真的很长，但你应该能够从这里的顶部看到我在做什么。如果您对更多细节感兴趣，只需查看注释即可。

我正在使用 NetBeans 平台作为起点构建一个应用程序。以前的版本使用 JavaHelp 作为最终用户文档。在编写所有新文档时，我可以继续练习，但如果使用它的信息，我会发现它很缺乏。

我已经了解了如何创建新的 HelpSet 以及 XML 到 HTML 的关系。可以在新建文档中手写代码&截图，但是感觉很手工，不知道有没有什么插件或者工具可以方便制作？

通过 Google-foo，我找到了几篇围绕该主题的帖子，但大多数帖子都与 2003 年相关，现在已是死胡同。使用 JavaHelp 是否过时？下面我概述了我为启发人们搜索相同内容所做的工作，也许有人可以指出我这样做的方式效率低下。

这不是一个糟糕的方法，但是必须为我上传的每个文件向两个 XML 文件添加行，然后每次都必须指向一个长代码 URL，这对于快速写出这些东西来说感觉很麻烦。

感谢阅读。

编辑:有一件事我确实有问题。我不知道如何更改 JavaHelp 的初始登录页面。现在它说“这列出了 IDE 加载的所有文档，单击左侧以通读它”。这对我的最终用户没有任何意义。

另外，我不知道如何更改左侧主题的顺序。现在它们似乎没有任何有用的顺序。我想按字母顺序排列，或者将它们按某种有用的顺序排列。

在Netbeans中，右击模块New->Other点击Module Development选择JavaHelp Help Set。这将在模块下创建一个新包。它将遵循模块的命名约定，并在末尾附加一个 .docs。例如 org.netbeans.newmodule.docs。

在此之下它将创建 6 个文件:

package-info.java (package info file)
<modulename>-about.html (As seen HTML help file)

<modulename>-map.xml (creates a connection to the HTML pages (E.G about) to a target, used in making links & building the hierarchy for the table of contents)
<modulename>-toc.xml (Table of contents XML)
<modulename>-hs.xml (Specifies the Table of contents view & javax control, & index)
<modulename>-idx.xml (Controls the index)

第一个 HTML 文件是初始信息页面。这是最终用户将阅读的帮助文件。它只是特定格式的常规 HTML。

<modulename>-about.html
<!--
To change this template, choose Tools | Templates
and open the template in the editor.
-->
<html>
    <head>
        <title>About Module</title>
        <link rel="stylesheet" href="nbdocs:/org/netbeans/modules/usersguide/ide.css" type="text/css">
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    </head>
    <body>
        <h2>About Module</h2>
        <p>
            <!-- TODO describe your module, add more pages... -->
        </p>
    </body>
</html>
<!--
Tip: to create a link which will open in an external web browser, try:
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
    <param name="content" value="http://www.netbeans.org/">
    <param name="text" value="<html><u>http://www.netbeans.org/</u></html>">
    <param name="textFontSize" value="medium">
    <param name="textColor" value="blue">
</object>
To create a link to a help set from another module, you need to know the code name base and path, e.g.:
<a href="nbdocs://org.netbeans.modules.usersguide/org/netbeans/modules/usersguide/configure/configure_options.html">Using the Options Window</a>
(This link will behave sanely if that module is disabled or missing.)
-->

任何东西都可以添加到 <body> 中文档的一部分。我使用过简单的内联 CSS 并使用 <FONT>标签到目前为止有效。它还链接到外部 CSS 文件，因此我认为这也可以。您可以通过指定路径链接到其他帮助文件。该路径将始终以 nbdocs:/<yorumodulepath> 开头

例如:Any event added here will show up on the <a href="nbdocs:/com/mymodule/mod1/start/docs/start-about.html">start page</a>

如果图像与javahelp在同一个源码包中，则可以相对链接。

例如:<img src="startPageLogo.png">

XML 文件很重要，因为它们设置了帮助文档的结构。

 <modulename>-map.xml

此文件将 HTML 文件链接到 nbdocs 文件。这将允许您在 HTML 文件中创建指向其他帮助文件位置的链接，并使其正确打开和关闭 JavaHelp 树。结构似乎是:<mapID target="<com.yoruproject.modname" url="<htmlfilename/.html"/>

E.G

  <?xml version="1.0" encoding="UTF-8"?>
<!--
To change this template, choose Tools | Templates
and open the template in the editor.
-->
<!DOCTYPE map PUBLIC "-//Sun Microsystems Inc.//DTD JavaHelp Map Version 2.0//EN" "http://java.sun.com/products/javahelp/map_2_0.dtd">
<map version="2.0">
    <mapID target="com.mymodule.mod1.start.about" url="start-about.html"/>
    <mapID target="com.mymodule.mod1.start.calevents" url="start-calevents.html"/>
    <mapID target="com.mymodule.mod1.start.backupreminder" url="start-backupreminder.html"/>

</map>




<modulename>-toc.xml

此文件控制 JavaHelp 左侧的结构，用户可以使用该结构深入了解帮助文档的不同区域。格式如下:

 <toc version="2.0">
        <tocitem text="Top Category">
            <tocitem text="SubItem" target="com.mymod.mod1.start.about"/>
            <tocitem text="SubCategory">
                <tocitem text="SubCategoryItem1" target="com.mymod.mod1.start.backupreminder"/>
                <tocitem text="SubCategory2" target="com.mymod.mod1.start.about">
                    <tocitem text="SubCategoryItem2" target="com.mymod.mod1.start.classifyreminder"/>
                </tocitem>
     </tocitem>
    </tocitem>
</toc>

这是一个完整文件的示例:

    <?xml version="1.0" encoding="UTF-8"?>
<!--
To change this template, choose Tools | Templates
and open the template in the editor.
-->
<!DOCTYPE toc PUBLIC "-//Sun Microsystems Inc.//DTD JavaHelp TOC Version 2.0//EN" "http://java.sun.com/products/javahelp/toc_2_0.dtd">
<toc version="2.0">
    <tocitem text="Start Page">
        <tocitem text="Getting Started" target="com.mymodule.mod1.start.about"/>
        <tocitem text="Calendar Events" target="com.mymodule.mod1.start.calevents"/>
        <tocitem text="Notification Pane">
            <tocitem text="Backup Reminders" target="com.mymodule.mod1.start.backupreminder"/>
            <tocitem text="New Classification Downloads" target="com.mymodule.mod1.start.backupreminder"/>
        </tocitem>
    </tocitem>
</toc>







<modulename>-hs.xml

我还没有弄乱这个文件。它似乎概述了目录、索引的 IDX 文件和 SearchView 文件(这是默认的 Java 位置)的位置。

    <?xml version="1.0" encoding="UTF-8"?>
<!--
To change this template, choose Tools | Templates
and open the template in the editor.
-->
<!DOCTYPE helpset PUBLIC "-//Sun Microsystems Inc.//DTD JavaHelp HelpSet Version 2.0//EN" "http://java.sun.com/products/javahelp/helpset_2_0.dtd">
<helpset version="2.0">
    <title>HMSStart Help</title>
    <maps>
        <homeID>com.mymodule.mod1.start.about</homeID>
        <mapref location="start-map.xml"/>
    </maps>
    <view mergetype="javax.help.AppendMerge">
        <name>TOC</name>
        <label>Table of Contents</label>
        <type>javax.help.TOCView</type>
        <data>start-toc.xml</data>
    </view>
    <view mergetype="javax.help.AppendMerge">
        <name>Index</name>
        <label>Index</label>
        <type>javax.help.IndexView</type>
        <data>start-idx.xml</data>
    </view>
    <view>
        <name>Search</name>
        <label>Search</label>
        <type>javax.help.SearchView</type>
        <data engine="com.sun.java.help.search.DefaultSearchEngine">JavaHelpSearch</data>
    </view>
</helpset>

最佳答案

首要问题是什么？是不是现在的流程太费劲了？我认为如果您一次问一个明确的问题会更容易提供帮助。不管怎样，这里有一些可能有用的提示。

据我所知，Sun JavaHelp 的开发已经停止。您可能想尝试 Oracle Help反而。它与 JavaHelp 非常相似，但维护更为积极。

有一些商业创作工具可以帮助您摆脱制作 JavaHelp(或 Oracle Help)的苦差事。示例:

  • Helen : 2012 年 4 月发布的最新版本的 JavaHelp-only 工具(所以 JavaHelp 毕竟不会死......)
  • WebWorks ePublisher : 除了 JavaHelp 之外，还可以生成更多帮助格式的工具

其他选项是免费的基于 XML 的文档框架 DocBook 和 DITA，它们都提供样式表(请参阅 here 和 here )从 XML 源代码生成 JavaHelp(我认为为了实现这个需要很少的东西也适用于 Oracle Help)。

还有其他(非 JavaHelp)替代品。例如，DocBook 还提供了基于 Web 的帮助格式:WebHelp .也许您会发现这很有趣。

关于java - 将 JavaHelp 用于有关基于 NetBeans 的应用程序、工具或插件的最终用户文档以使其更容易？，我们在Stack Overflow上找到一个类似的问题： https://stackoverflow.com/questions/9994373/

24 4 0
文章推荐： javascript - 在 Node - Express 中执行 POST 操作后更改 EJS 中的元素样式
文章推荐： javascript - React/JS - 如何将附加参数传递给 onClick 处理程序
文章推荐： javascript - 如何比较 JavaScript 中的两个数组，即使它们没有排序？
文章推荐： python - 使用经过训练的神经网络来显示更广泛的周围环境的图像
行者123
个人简介

我是一名优秀的程序员,十分优秀！

滴滴打车优惠券免费领取
滴滴打车优惠券
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com