2.2. 创建知识标记文件


在 Red Hat Enterprise Linux AI 版本 1.5 中,您必须以 git 存储库和 markdown 格式托管您的知识文档和数据。您可以使用标准 git 工作流创建文件并上传到存储库。您可以使用各种开源标记转换工具,包括:

  • Pandoc:开源转换工具.
  • Visual Studio Code with All in one extention:您可以在 Visual Studio Code 中打开您的文档,并使用 Markdown All in One 扩展 来转换为 Markdown。
  • IBM Deepsearch/Docling:捆绑 PDF 文档转换为 JSON,并在自包含的软件包中标记。

流程

  1. 选择您首选的 git 托管平台。只要与 git 兼容,就可以在 RHEL AI 上使用任何平台。
  2. 将您的文档转换为 .md 标记格式。您可以使用您想要进行知识数据的任何标记转换软件。

    以下列表包含知识标记文件的指南:

    • 所有文档都必须是文本,当前不支持镜像。
    • 从您的文档中删除任何脚注。
    • 表必须采用 markdown 格式。
    • 目前不支持图表和图形。
  3. 记录您的文件名和提交哈希。这个值在您的 qna.yaml 文件中使用。
  4. 创建 md 文件并将其上传到 git 存储库中。

    知识文档标记示例

    # Phoenix (constellation)
    
    **Phoenix** is a minor constellation in the southern sky. Named after the mythical phoenix,
    it was first depicted on a celestial atlas by Johann Bayer in his 1603 *Uranometria*. The
    French explorer and astronomer Nicolas Louis de Lacaille charted the brighter stars and gave
    their Bayer designations in 1756. The constellation stretches from roughly −39 degrees to −57
    degrees declination, and from 23.5h to 2.5h of right ascension. The constellations Phoenix,
    Grus , Pavo and Tucana, are known as the Southern Birds.
    
    The brightest star, Alpha Phoenicis, is named Ankaa, an Arabic word meaning 'the Phoenix'.
    It is an orange giant of apparent magnitude 2.4. Next is Beta Phoenicis, actually a
    binary system composed of two yellow giants with a combined apparent magnitude of 3.3. Nu Phoenicis
    has a dust disk, while the constellation has ten star systems with known planets and the recently
    discovered galaxy clusters El Gordo and the Phoenix Cluster—located 7.2 and 5.7 billion light years
    away respectively, two of the largest objects in the visible universe. Phoenix is the radiant of
    two annual meteor showers: the Phoenicids in December, and the July Phoenicids.
    
    ## History
    
    Phoenix was the largest of the 12 constellations established by Petrus Plancius from the observations
    of Pieter Dirkszoon Keyser and Frederick de Houtman. It first appeared on a 35-cm diameter celestial
    globe published in 1597 (or 1598) in Amsterdam by Plancius with Jodocus Hondius. The first
    depiction of this constellation in a celestial atlas was in Johann Bayer's*Uranometria* of 1603. De Houtman
    included it in his southern star catalog the same year under the Dutch name *Den voghel Fenicx*,
    "The Bird Phoenix", symbolizing the phoenix of classical mythology. One name of the brightest star Alpha
    Phoenicis—Ankaa—is derived from the Arabic: العنقاء, romanized: al-‘anqā’, lit. 'the phoenix', and was
    coined sometime after 1800 in relation to the constellation.
    
    Celestial historian Richard Allen noted that unlike the other constellations introduced by Plancius and La
    Caille, Phoenix has actual precedent in ancient astronomy, as the Arabs saw this formation as representing
    young ostriches, *Al Ri'āl*, or as a griffin or eagle. In addition, the same group of stars was sometimes
    imagined by the Arabs as a boat, *Al Zaurak*, on the nearby river Eridanus. He observed,
    "the introduction of a Phoenix into modern astronomy was, in a measure, by adoption rather than by invention."
    
    The Chinese incorporated Phoenix's brightest star, Ankaa (Alpha Phoenicis), and stars from the adjacent
    constellation Sculptor to depict *Bakui*, a net for catching birds. Phoenix and the neighboring constellation
    of Grus together were seen by Julius Schiller as portraying Aaron the High Priest. These two constellations,
    along with nearby Pavo and Tucana, are called the Southern Birds.
    
    ## Characteristics
    
    Phoenix is a small constellation bordered by Fornax and Sculptor to the north, Grus to the west, Tucana to the
    south, touching on the corner of Hydrus to the south, and Eridanus to the east and southeast. The bright star
    Achernar is nearby. The three-letter abbreviation for the constellation, as adopted by the International Astronomical
    Union in 1922, is "Phe". The official constellation boundaries, as set by Belgian astronomer Eugène Delporte in
    1930, are defined by a polygon of 10 segments. In the equatorial coordinate system, the right ascension
    coordinates of these borders lie between 23<sup>h</sup> 26.5<sup>m</sup> and 02<sup>h</sup> 25.0<sup>m</sup>, while
    the declination coordinates are between −39.31° and −57.84°. This means it remains below the horizon to anyone
    living north of the 40th parallel  in the Northern Hemisphere, and remains low in the sky for anyone living north
    of the equator. It is most visible from locations such as Australia and South Africa during late Southern Hemisphere spring.
    Most of the constellation lies within, and can be located by, forming a triangle of the bright stars Achernar,
    Fomalhaut and Beta Ceti—Ankaa lies roughly in the centre of this.
    Copy to Clipboard

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat