📄 kdevelop-manual-6.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><HTML><HEAD> <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21"> <TITLE>Kdevelop使用手册: 帮助系统</TITLE> <LINK HREF="kdevelop-manual-7.html" REL=next> <LINK HREF="kdevelop-manual-5.html" REL=previous> <LINK HREF="kdevelop-manual.html#toc6" REL=contents></HEAD><BODY><A HREF="kdevelop-manual-7.html">Next</A><A HREF="kdevelop-manual-5.html">Previous</A><A HREF="kdevelop-manual.html#toc6">Contents</A><HR><H2><A NAME="The Help System"></A> <A NAME="s6">6.</A> <A HREF="kdevelop-manual.html#toc6">帮助系统</A></H2><P>大多数Kdevelop的精力都花在了帮助系统上。这应作为一个如何使用一套完整的帮助功能来扩展你自己的KDE 应用的例子来理解，而且已经在template应用中部分实现, 因此由应用向导生成的KAppWizardKDE/Qt application frameworks 已经包含了为状态条帮助和文档提供的基本功能，那只需由程序员扩展即可。因此本节将介绍IDE提供的一般帮助的使用及帮助浏览器Helpbrowser的使用, 巧妙的使用它将使你得到开发所需的信息变的十分容易。</P><H2><A NAME="ss6.1">6.1</A> <A HREF="kdevelop-manual.html#toc6.1">"这是什么 ?"-按钮及快速帮助Quickhelp</A></H2><P>看看Kdevelop的顶部工具条, 你会在最右边看见 "这是什么?" 按钮。选择这 一按钮, 光标会变为一个指针，右边带一个问号, 和工具条中的那个按钮一样。现在，你可以选择Kdevelop用户界面中的任何一个可视化部件。单击它会显示一个帮助窗口，为你简要描述该部件可为你提供的功能或它可以为你完成的任务，为主视，树视图，及工具条上的每一个按钮提供解说帮助。再次用鼠标单击或输入键盘上某键，这是什么帮助窗口将消失，你的鼠标会设置到上一次的位置。注意，如果你将鼠标指针放于某键上，该键会突起，接着出现一个快书-Tip-窗口, 为你描述该按钮在菜单条中代表的功能；将鼠标指针移开窗口就会消失。</P><P>对于用户交互对话, 快速帮助Quickhelp 为你提供帮助窗口，简要描述你需要得到帮助的选中条目。这可通过在项目上右击鼠标来进入, 一个内容目录会弹出,允许选择"快速帮助"。选中它会弹出帮助窗口。这在你还对Kdevelop不熟悉，不知道某操作对话的目的时很有用。注意，大多数对话提供一个帮助按钮，在帮助浏览器的在线手册中为你提供对话选项的详细文本帮助。</P><H2><A NAME="ss6.2">6.2</A> <A HREF="kdevelop-manual.html#toc6.2">状态条Statusbar 帮助</A></H2><P>Kdevelop的状态条帮助提供给你很多的功能，告知你当前操作状态的相关信息并显示为你提供命令简要描述的"状态信息"。</P><H3>状态条项目 Statusbar Entries</H3><P>状态条Statusbar 包括:<OL><LI> 一个一半信息域, 多数居左。常用于帮助信息及显示当前操作。</LI><LI> 进展条, 指示需要相当长一段时间才能完成的操作的进展, 例如保存文件及类浏览器的扫描过程。进展条只有在那样的程序执行时才会出现。</LI><LI> 一个插入/改写指示器。它将显示编辑器editor 模式，对于插入操作将由INS表示插入模式，改写模式则使用OVR 。也可通过键盘上的INS-键转变模式。</LI><LI> 一个行计数器, 显示光标当前所在的行。</LI><LI> 一个列计数器, 指示光标当前在一行中所在的列位置。</LI></OL></P><H3>帮助信息</H3><P>当你选择了菜单条中某菜单的一个操作但并未执行，状态条告诉你关于该菜单条目的操作。此外，如果你按下了工具条按钮, 但还未松开鼠标键, 该按钮的帮助信息会以和菜单条目相同的方式显示。你可以一直按住鼠标，通过将鼠标指针移开该按钮来阻止所选按钮的执行。一旦光标移开，鼠标按钮即可松开。</P><P>对于当前正执行的操作, Kdevelop会显示其执行过程。这对在后台运行的程序其作用，例如保存文件及对话。如果程序已经存在，例如一个make-invocation, 状态条会将改变显示回"Ready"状态。而且, 在使用文档浏览器documentation browser时, 只要将光标置于浏览器窗口中一个URL连接上，状态条会显示连接地址。因此, 你可以轻易的发现文件是本地的还是只有通过网络连接才能访问的远程文件。</P><P>Kdevelop项目编辑器的字表明了当前在顶部窗口打开的文件的名称。这可能是文档浏览器documentation browser的一个 HTML 文件，或编辑窗口的一个文本文件。此外还将显示项目名, 这样你可以一直控制你的位置及你当前的操作对象。</P><H2><A NAME="ss6.3">6.3</A> <A HREF="kdevelop-manual.html#toc6.3">配置HTML 浏览器</A></H2><P>Kdevelop中包含的浏览器是完全基于HTML的, 因此你可以指定一般选项，例如背景等。你可以通过"选项菜单的"文档浏览器"项设置所有的参数。配置对话configurationdialog 未你显示两个定位装置；第一个是进行字体参数设置, 第二个是颜色选项设置。</P><H3>字体参数</H3><P>字体显示的第一个选项是字体大小。可选项由小号, 中号和大号。一般用途的最佳显示缺省设置为小号。</P><P>对于字体选择，你必须为普通文本指定显示在HTML文档中的标准字体；固定的字体是用于例如在HTML文件中显示代码的。</P><H3>颜色参数</H3><P>颜色参数对话允许设置背景, 标准文本, URL连接及连接后的颜色。右端的有色按钮显示的是当前设置；选择一个按钮将打开"颜色选择"对话。在那里，你可以通过在多色窗口中选择一个系统色, 一个自定义色,或通过直接设置颜色值来指定颜色。中部是对所选颜色的预览。另外, 你可以指定浏览器是否应该将连接下划线以更醒目及你是否希望使用你自己选择的颜色，而不管页面预先设置的颜色。"应用" 会执行所有的改动, "确定"则运用所有的改动并关闭对话。"取消" 不会改变任何设置并退出配置。</P><H2><A NAME="Using the Documentation Browser"></A> <A NAME="ss6.4">6.4</A> <A HREF="kdevelop-manual.html#toc6.4">使用文件浏览器</A></H2><P>文件浏览器documentation browser 允许快捷的访问随Kdevelop提供的或自动生成的所有的手册及文件, 包括KDE 库KDE-libraries 及你的项目文件的在线文档。另外, 树视图中的文件树允许你设置一个额外的包含了所有个人加入文件的"其他" 文件夹。</P><H3>要求</H3><P>要使用帮助浏览器Helpbrowser的所有特色, 你应该线安装KDoc及glimpse。KDoc 将在setup过程中为KDE 库KDE-libraries生成各种各样的在线类--文件, 但也可通过<A HREF="kdevelop-manual-14.html#General Configuration">KDevelop Setup</A>中的选项激活。对于一个你的项目的类classes的API (Application Programming Interface)文件的生成, KDoc也会被项目菜单中"生成API-Doc"使用和访问。这将处理项目所有的当前的头文件及对Qt和KDE-libraries前后参照，如果它们在帮助浏览器Helpbrowser中可用。对于项目手册的生成, 你应该至少在你的系统上安装KSgml2Html (由KDE-SDK提供)及, SGML-tools。要扩展及更改你的项目的在线文件, 你必须通过在RFV中选择它来为你的项目编辑文档文件。在保存了你的改动后，从项目菜单中访问"建立用户手册" 。假如 SGMLtools 检测到格式化错误errors, 错误将会显示在输出output 窗口，允许你直接找出错误行。"glimpse"程序用于自动为你的文件创建一个个人的搜寻索引。索引通常在安装过程中建立, 但也可利用<A HREF="kdevelop-manual-14.html#General Configuration">KDevelop Setup</A>对话建立。要得到所提供的搜寻功能的描述，请参见<A HREF="#Using the Searchindex">使用搜索索引</A>。</P><H3>提供的文档</H3><P>KDevelop IDE 有两套在线文档, 可以通过帮助菜单或在Kdevelop文件夹中通过树视图的文档树来获得。所提供的第一本书就是这本包含了所有你需要的安装及设置，可用功能及应用开发介绍信息的在线手册。第二本书的首版是<A HREF="programming/index.html">KDevelop编程手册</A>。编程手册包括与创建及扩展由KDevelop生成的项目相关的大多数问题。通过此教程，用户得到关于由Qt- 和/或 KDE-libraries创建的应用所提供的丰富功能的介绍，还为保证KDE-compliance 提供了指导,在位于<A HREF="http://developer.kde.org">http://developer.kde.org</A>的Internet 网站上提供相同介绍。然而, 编程手册不能代替任何其他可用的关于C++编程语言打印出的或是电子形式的文件，及关于Qt-库的使用的文件。</P><P>KDevelop 使用的C/C++-参考Reference 当前只有在位于<A HREF="http://www.kdevelop.org">http://www.kdevelop.org</A>的Kdevelop主页上可用。在发布时该参考可能会包括进去, 可参见所发布的安装程序索引以获得更多信息。它可通过下载和拷贝源文件到主要的KDE-目录($KDEDIR)来轻易安装。然后，你必须使用<CODE>tar zxvf c_c++_reference.tar.gz</CODE>将它作为根部, 然后参考将被拷贝KDevelop的文件目录。要卸载参考文件，你只需在($KDEDIR)/share/doc/HTML/default/kdevelop/reference下删除"参考"文件夹。</P><P>Qt/KDE-libraries文件夹允许直接访问你的Qt-库拷贝的HTML-在线文件。库文件的路径通常使由Kdevelop安装程序自动检测, 但也可在<A HREF="kdevelop-manual-14.html#General Configuration">KDevelop Setup</A>对话中手动设置。而且，所有KDE库KDE-libraries的可用文件都以库名顺序列出, 因此如果你要使用某个库的类classes，你可以很容易的决定要加入项目中连接器Linker设置的库的类型。注意，整个KDE-库文件只有当由KDoc生成时才可进入---因此包含于KDE-SDK中的这个程序, 必须文件生成以前安装。由于Kdevelop的安装程序自动完成次步骤, 它应当在运行KDevelop 安装程序前安装。如果不是这样且文件不能建立, 你可以利用<A HREF="kdevelop-manual-14.html#General Configuration">KDevelop Setup</A>对话在其后任何时间创建它。文件树还包含"其他" 文件夹，这些文件夹旨在包含所有个人设置的文档，如下。最后, 文档树允许访问API 及你当前项目的手册。</P><H3>将文件加入帮助浏览器Helpbrowser</H3><P>要设置你的帮助浏览器Helpbrowser, 先打开树视图并选择"DOC"定位装置。 你会看见一个打开包含四哥文件夹的树。"其他" 文件夹缺省为空。用鼠标在这个文件夹上右击, 一个上下文菜单会打开，它包含了一个"增加入口"项。选择它会打开增加入口对话，你必须在此输入两个值: 上面一个是文档在文档树中显示的文件名，下面一个是文件入口行,你必须在此输入其后通过选择该入口将被打开的起始页的路径和文件名。你可以直接输入路径及文件名或通过选择右边的按钮来打开一个文件选择对话。这允许对你的系统进行快速浏览以查找你的起始页的路径。注意，只有HTML-文件可以选择, 所以只允许选择HTML 文件。选择OK 会将入口加入文档树并可直接使用。</P><H3><A NAME="Using the Searchindex"></A> 使用搜寻索引</H3><P>KDevelop 包含了一套功能，帮助你利用HTML文件查找信息。要使用这些特色, 你的系统需要安装"glimpse"程序, 一个免费的数据库生成器-它会生成搜寻索引search index 并在文件内执行搜寻操作。要建立索引, 请参见<A HREF="kdevelop-manual-14.html#General Configuration">KDevelop Setup</A>。索引也可在安装程序中自动生成。</P><P>如下，有几种方式可以进入查寻功能，你可以选择:<OL><LI>在编辑器editor中, 选择你想要获得帮助的文本活将光标置于你要查寻的单词中。然后右击鼠标选择设置: "语句"。这也可通过从帮助菜单中选择"搜寻标注文本"、按下快捷键F2 或通过从工具条选择搜寻按钮来完成。</LI><LI>在文件浏览器中选择你要找寻的文本并按下鼠标右键, 选择找寻:"语句" 或选择 "找寻标注文本" 或如上使用找寻按钮。</LI><LI>如果你想要查找一个特定的关键字, 在帮助菜单中选择"查找对...的帮助" 或从工具条中选择"查找对...的帮助" 按钮, 然后会打开一个查找对话，你可以在此输入你想要得到信息的词句。</LI></OL>可通过在"DOC" -树-浏览中选择相关按钮或通过帮助菜单的条目直接进入特定文件。</P><P>帮助浏览器Helpbrowser 还提供对文本查找工具grep 在你当前的文档中查找所选文本的支持, 例如，你已经为<CODE>KTMainWindow</CODE> class (KDEUI library)打开文档页并希望知道<CODE>KTMainWindow</CODE>出现在你代码中的哪个位置。标注<CODE>KTMainWindow</CODE>并选择"文本查找工具: KT主视窗"或按下Shift+F2。"在文件中查找"对话会打开并直接显示你的文本查找工具grep 的搜寻结果。然后你可以选择一个结果行并跳至相关资源代码。</P><HR><A HREF="kdevelop-manual-7.html">Next</A><A HREF="kdevelop-manual-5.html">Previous</A><A HREF="kdevelop-manual.html#toc6">Contents</A></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -