Firebird Docbuilding Howto Spanish

• 语言: 西班牙语
• 格式: .pdf
• 来源: firebirdsql.org

摘要

这份文档指导用户如何从SourceForge下载并构建Firebird项目的模块手册。模块手册采用Docbook XML格式，需通过构建过程生成易读的HTML或PDF文档。文档详细介绍了使用CVS客户端获取模块手册的步骤，包括匿名和SSH两种访问方式，并说明了构建文档所需的Java环境配置。同时，文档还解释了如何保持模块手册的最新 version及处理构建过程中可能出现的错误。

AI总结

# 《Firebird Docbuilding Howto Spanish》中文总结

## 引言：本指南的目的与目标读者
本指南详细介绍了如何从Firebird项目在SourceForge上的“manual”模块中下载并生成文档。该模块是Firebird关系数据库管理系统（RDBMS）的官方文档来源，内容以DocBook XML格式存储，需通过构建过程生成易于阅读的HTML或PDF文档。此外，Firebird的其他文档资源可通过以下网址获取：
- [IBPhoenix官网](http://www.ibphoenix.com)
- [Firebird官方文档页面](http://www.firebirdsql.org/index.php?op=doc)

## 关于“manual”模块
“manual”模块是Firebird项目中的一个子项目，旨在通过社区协作生成精确且易于理解的文档。尽管目前该模块尚在初期阶段，用户仍可通过构建本地副本获取最新文档，或参与文档编写工作。

## 是否需要自行生成文档？
如果用户只需使用现有文档，通常可以从Firebird官网直接下载。然而，如果用户希望获取最新内容、参与编写或学习构建流程，则需要自行生成文档。

## 获取与构建“manual”模块
### 获取模块
1. **CVS简介**：Concurrent Versions System（CVS）是一种版本控制工具，广泛用于软件开发。Firebird项目的代码库通过CVS管理。
2. **CVS客户端**：用户需安装CVS客户端以获取模块。推荐的客户端包括：
- **Linux/BSD/Unix**：命令行工具（预装）或gCvs。
- **Windows**：WinCVS或TortoiseCVS。
- **Mac OS X**：内置命令行工具或第三方工具（如MacCvsX）。
3. **匿名检出**：任何用户均可匿名下载模块，命令如下：

   cvs -d:pserver:[e-mail]:/cvsroot/firebird login
   cvs -z6 -d:pserver:[e-mail]:/cvsroot/firebird checkout manual

4. **SSH检出**：项目成员可通过SSH协议检出模块，以确保同步更新：

   cvs -d:ext:[e-mail]:/cvsroot/firebird checkout manual

其中，`username`为用户的SourceForge用户名。

### 构建文档
1. **环境配置**：需安装Java 2 SDK并设置`JAVA_HOME`环境变量，指向Java安装目录。
- **Windows示例**：

     set JAVA_HOME=C:\Program Files\Java\j2re1.4.2_01

- **Linux示例**：

     export JAVA_HOME=/usr/lib/java/jre

2. **构建命令**：
- 进入`manual\src\build`目录，执行构建命令：
- **Windows**：

       build

- **Linux**：

       ./build.sh

- 构建完成后，文档将生成在`manual\dist`目录下。

### 生成选项
- 指定文档ID和语言：

  build pdf -Drootid=qsg15-es -Dsfx=es

以上命令将生成西班牙语的快速入门指南PDF。

## 维护与更新
1. **更新模块**：定期使用CVS更新本地模块以获取最新内容：

   cvs -z6 update -d

2. **解决冲突**：更新过程中若发生冲突，需手动编辑文件解决。

## 常见问题
- PDF生成过程中的错误消息可安全忽略，只需确保最后输出“BUILD SUCCESSFUL”。
- 如需进一步帮助，可参考Firebird文档项目页面：[Firebird文档子项目](http://www.firebirdsql.org/index.php?op=devel&sub=doc)。

通过以上步骤，用户可以成功获取并构建Firebird的“manual”模块，以生成所需的文档。此外，用户还可通过参与文档编写为Firebird社区贡献力量。