packages/docutils/rstidx

Nim idx файл формата определения.

Импорты

strutils, syncio, hashes, os

Типы

IndexEntry = object
  kind*: IndexEntryKind      ## 0.
  keyword*: string           ## 1.
  link*: string              ## 2.
  linkTitle*: string         ## 3. contains a prettier text for the href
  linkDesc*: string          ## 4. the title attribute of the final href
  line*: int                 ## 5.
  module*: string            ## origin file, NOT a field in ``.idx`` file
  aux*: string               ## auxuliary field, NOT a field in ``.idx`` file

Source Edit

IndexEntryKind = enum
  ieMarkupTitle = "markupTitle", ## RST/Markdown title, text in `keyword` +
                                  ## HTML text in `linkTitle`
  ieNimTitle = "nimTitle",  ## Nim title
  ieHeading = "heading",    ## RST/Markdown markup heading, escaped
  ieIdxRole = "idx",        ## RST :idx: definition, escaped
  ieNim = "nim",            ## Nim symbol, unescaped
  ieNimGroup = "nimgrp"      ## Nim overload group, unescaped

тег-дискриминатор Source Edit

Процедуры

proc `$`(e: IndexEntry): string {....raises: [ValueError], tags: [], forbids: [].}

Source Edit

proc cmp(a, b: IndexEntry): int {....raises: [], tags: [], forbids: [].}

Сортирует два IndexEntry сначала по полю keyword, а затем по полю link. Source Edit

proc formatIndexEntry(kind: IndexEntryKind;
                      htmlFile, id, term, linkTitle, linkDesc: string; line: int): tuple[
    entry: string, isTitle: bool] {....raises: [], tags: [], forbids: [].}

Source Edit

proc hash(x: IndexEntry): Hash {....raises: [], tags: [], forbids: [].}

Возвращает хеш для объединенных полей типа.

Хеш вычисляется как цепной хеш отдельных хешей строк.

Source Edit

proc isDocumentationTitle(hyperlink: string): bool {....raises: [], tags: [],
    forbids: [].}

Возвращает true, если гиперссылка фактически является заголовком документации.

У заголовков документации отсутствует хеш. См. mergeIndexes() для более подробного объяснения.

Source Edit

proc parseIdxFile(path: string): tuple[fileEntries: seq[IndexEntry],
                                       title: IndexEntry] {.
    ...raises: [IOError, ValueError], tags: [ReadIOEffect], forbids: [].}

Source Edit

proc unquoteIndexColumn(text: string): string {....raises: [], tags: [],
    forbids: [].}

Возвращает необработанную версию, сгенерированную quoteIndexColumn. Source Edit