DOCC (XCODE 16) генерирует пустой индекс.html для статического сайта, несмотря на действительные данные .doccarchive & J ⇐ IOS

[Anonymous]

Я использую xcode 16.2 для создания статической документации HTML для моего проекта iOS swiftfulcrypto для страниц Gitlab.
Проблема
(~ 2KB), хотя:

• Промежуточный .doccarchive можно просмотреть в просмотре документации Xcode.
• Появляется Spect Pilots/wiftfulcrycry. Данные графа символа. < /p>
  < /li>
  могут быть сгенерированы отдельные страницы символов, но основные точки входа не функциональны из-за пустых файлов индекса. локально:

  двухэтапный процесс

  генерирует достоверность .doccarchive , но static index.html пуст:
  step 1: Generate .doccarchive (Br/>
  
  xcodebuild docbuild \ -project swiftfulcrypto.xcodeproj \ -Scheme
  swiftfulcrypto \ -destination "generic /platform = ios" \
  
  -deriveddatapath ./build_archive \ code_signity = "" " Code_signing_allowed = no
  
  Шаг 2: преобразование .doccarchive к статическому html (завершает, но index.html пуст)
  Пример: PATH_TO_YOUR_DOCCARCHIVE = "./ BUILD_ARCHIVE/BUILD/PRODUCTS/DEBUG-IPHONEOS/SWIFTFULCRYPTO.DOCCARCHIVE"

  Код: Выделить всё

  xcrun docc process-archive transform-for-static-hosting \
  PATH_TO_YOUR_DOCCARCHIVE \
  --output-path ./public/swiftfulcrypto \
  --hosting-base-path swiftfulcrypto
  

  одноэтапный xcodebuild

  также приводит к пустому index.html :

  Код: Выделить всё

  xcodebuild clean docbuild \   -scheme SwiftfulCrypto \   -destination
  generic/platform=iOS \   CODE_SIGNING_ALLOWED=NO \
  CODE_SIGN_IDENTITY="" \   CODE_SIGNING_REQUIRED=NO \
  OTHER_DOCC_FLAGS="--transform-for-static-hosting \
  --hosting-base-path swiftfulcrypto \
  --output-path ./public/swiftfulcrypto"
  

  примечание

  Я также попробовал--output-dir здесь, в соответствии с некоторыми предложениями, аналогичным результатом. SwiftfulCrypto.md Целевая страница:

  Код: Выделить всё

  # ``SwiftfulCrypto``
  
  Welcome to the SwiftfulCrypto app documentation.
  ## Overview
  This app helps you track cryptocurrency prices...
  ### Key Components
  - ``HomeView``
  - ``CoinDataService``
  - ``CoinModel``
  

  (inline /// Комментарии существуют и для символов)
  наблюдаемая структура вывода (например, из public/wiftfulcrypto/):
  

  Код: Выделить всё

  css/

  , js/, data/documentation/swiftfulcrypto/*. json (jsons выглядят хорошо)

• Код: Выделить всё

  documentation/swiftfulcrypto/index.html

  (пусто или ~ 2 кб)

• Код: Выделить всё

  index.html

  (в корне вывода, также пусто или ~ 2 кб)

Другие активы кажутся хорошими.
Вопрос
Почему Docc создает пустой основной индекс. Сгенерируются JSON? Это известное поведение Xcode 16, или я не буду упускаю ключевую конфигурацию DOCC для генерации основной страницы статического сайта, несмотря на то, что у меня есть каталог документации и целевую страницу?>

Подробнее здесь: https://stackoverflow.com/questions/796 ... lid-doccar