juddiv3用户文档（一）

前言

 

1. 文档约定

本手册使用几个约定去标示的方式强调一些特定信息的单词和短语。

在PDF和纸制版本，本手册采用Liberation Fonts。这种字体同样适用于HTML，如果你的系统中安装这种字体。如果没有安装，按default字体显示。注：Red Hat Enterprise Linux 5或更高版本采用Liberation Fonts为default字体。

 

 

1.1. 排版约定

有四种排版用适用于特定的单词和短语，这些约定和适用情况，如下所述：

单行间隔加粗

用于系统输入，包括shell语句，文件名和路径。也可以用于快捷键和组合键。例如：

 

要查看目录中my_next_bestselling_novel文件的内容，请在shell中输入 cat my_next_bestselling_novel然后按下 Enter 键执行命令。

以上包括一个文件名，一个shell命令和一个快捷键，所有提交在上下文中显示为单行间隔加粗。

组合键是可以使用多个按键依次连接而成，例如：

 

按下 Enter 去执行命令

 

按下 Ctrl+Alt+F1 键切换到第一个虚拟设备。按下 Ctrl+Alt+F7 键返回你的 X-Windows 会话。

第一句强调特定键按下，第二个强调通过同时按下三个组合键实现。

如果一段源代码被用来讨论,一个段落中的类名，方法名，函数，变量名和返回值等以上都将采用单行间隔加粗处理，例如：

 

文件相关类包括的文件系统，文件和目录，每个类都有它自己的一系列权限。

加粗

标示文字在一个系统中，包括应用名，对话框文字，按钮文字，多选或单选文字，菜单标题和子菜单标题。例如：

通过在主菜单选择 System > Preferences > Mouse 鼠标设置鼠标Preferences，从左到右适用鼠标左键依次选择或者取消选项（使你的鼠标达到合适）。

插入一个特殊字符到gedit文件中，在主菜单中选择Applications > Accessories > Character Map，然后在字符集中选择 Search > Find，键入字符名称在搜索框然后确定。你搜索的字符将在字符表中强调显示，双击强调字符在复制区，然后单击复制按钮。切换回到你的 gedit 文档选择 Edit > Paste 。

以上文字包括应用名称，系统菜单名称和内容；应用菜单名称；还有GUI中的按钮和文字，以上都将使用粗体与上下文区分。

注意 > 用于指示通过菜单到子菜单的过程。为了避免语言中描述“选择 Mouse 从  System 的子菜单 Preferences 中”难以遵循。

单倍行距斜粗体或者斜粗体

无论是单倍行距粗体或者粗体，通过添加斜体得到的效果。斜体表示输入不确定或者有可变因素的效果。例如：

使用ssh连接到远程的机器，在shell提示符下键入shh username@domain.name。如果你的机器名是 example.com 和你的用户名在机器上是john，键入 shh john@example.com。

mount -o remount file-system 命令行重新挂载文件系统。例如，重新挂载 /home 文件系统， 命令行为 mount -o remount /home。

查看当前安装包版本命令，使用命令行 rpm -q package 。它将返回一个结果如：package-version-release。

注意以上粗斜体的文字username, domain.name, file-system, package, version and release。每个单词是一个占位符，无论是命令行还是系统显示的文字。

除了以上典型用法外，斜体还用于在第一次使用的总要名词。例如：

当Apache HTTP Server接受请求后，将分派子进程或线程来处理他们。这些子进程或者子线程被称为服务池。在Apache HTTP Server 2.0中，在创建和维护这些服务池的任务已经抽象成一组模块 Multi-Processing Modules (MPMs)，不像其他模块，只有MPM组中的一个模块可以被Apache HTTP Server加载。

 

 

1.2. 引用约定

两个，一般多行，数据类型被周围的文字视觉衬托。

输出到终端以单倍行距罗马体显示如下：

 

books        Desktop   documentation  drafts  mss    photos   stuff  svn
books_tests  Desktop1  downloads      images  notes  scripts  svgs

源代码列表也以 单倍行距罗马体 强调如下：

 

 

package org.jboss.book.jca.ex1;

import javax.naming.InitialContext;

public class ExClient
{
   public static void main(String args[]) 
       throws Exception
   {
      InitialContext iniCtx = new InitialContext();
      Object         ref    = iniCtx.lookup("EchoBean");
      EchoHome       home   = (EchoHome) ref;
      Echo           echo   = home.create();

      System.out.println("Created Echo");

      System.out.println("Echo.echo('Hello') = " + echo.echo("Hello"));
   }
}

 

 

 

1.3. 注意和警告

总之, 我们用三个视觉来提示信息，否则也许会被忽视。

 

Note

A Note is a tip or shortcut or alternative approach to the task at hand. Ignoring a note should have no negative consequences, but you might miss out on a trick that makes your life easier.

Important

Important boxes detail things that are easily missed: configuration changes that only apply to the current session, or services that need restarting before an update will apply. Ignoring Important boxes won't cause data loss but may cause irritation and frustration.

Warning

A Warning should not be ignored. Ignoring warnings will most likely cause data loss.

2. 我们需要反馈！

如果你发现本文本中一个拼写错误，或者你发现有更好的方法展示，我们欢迎你的声音！

 

任何错误你发现或者你有更好的改进，请注册一个JIRA账号在https://issues.apache.org/jira/secure/Dashboard.jspa并在“jUDDI”组件一个bug。

 

如果你有一个完善的文档建议，尝试努力描述它完整。如果你发现它有一个错误，请指出它的章节和周围的一些文字以使我们能很容易的找到它。