// Expected
        }
    }

    @Test
    public void test_withRelevantDocs_manyDocs() {
        List<String> docIds = Arrays.asList("doc1", "doc2", "doc3", "doc4", "doc5", "doc6", "doc7", "doc8", "doc9", "doc10");
        List<Integer> indexes = Arrays.asList(1, 2, 3, 4, 5, 6, 7, 8, 9, 10);
        RelevanceEvaluationResult result = RelevanceEvaluationResult.withRelevantDocs(docIds, indexes);

    API docs (normally served at `/docs`).

    You would only call this function yourself if you needed to override some parts,
    for example the URLs to use to load Swagger UI's JavaScript and CSS.

    Read more about it in the
    [FastAPI docs for Configure Swagger UI](https://fastapi.tiangolo.com/how-to/configure-swagger-ui/)

missing_translation_snippet = """
{!../../docs/missing-translation.md!}
"""

non_translated_sections = (
    f"reference{os.sep}",
    "release-notes.md",
    "fastapi-people.md",
    "external-links.md",
    "newsletter.md",
    "management-tasks.md",
    "management.md",
    "contributing.md",
)

docs_path = Path("docs")
en_docs_path = Path("docs/en")
en_config_path: Path = en_docs_path / mkdocs_name

                </project>
                """;

            Document doc1 = Document.of(pomXml);
            Document doc2 = Document.of(pomXml);

            Map<Path, Document> pomMap = new HashMap<>();
            pomMap.put(Paths.get("/project/pom1.xml"), doc1);
            pomMap.put(Paths.get("/project/pom2.xml"), doc2);

            UpgradeContext context = createMockContext();

        with:
          python-version: 3.x

      - run: pip install mkdocs-material mkdocs-redirects

      - name: Generate Docs
        run: ./test_docs.sh

      - uses: actions/upload-artifact@v7
        with:
          name: docs

        Map<String, Object> doc1 = new HashMap<>();
        doc1.put("title", "Doc1");
        Map<String, Object> doc2 = new HashMap<>();
        doc2.put("title", "Doc2");
        Map<String, Object> doc3 = new HashMap<>();
        doc3.put("title", "Doc3");
        documentList.add(doc1);
        documentList.add(doc2);
        documentList.add(doc3);

            uv.lock
      - name: Install docs extras
        run: uv sync --locked --no-dev --group docs
      - name: Export Language Codes
        id: show-langs
        run: |
          echo "langs=$(uv run ./scripts/docs.py langs-json)" >> $GITHUB_OUTPUT

  build-docs:
    needs:
      - changes
      - langs
    if: ${{ needs.changes.outputs.docs == 'true' }}
    runs-on: ubuntu-latest
    strategy:

        final List<Map<String, Object>> docs = new ArrayList<>();
        final Map<String, Object> doc1 = new LinkedHashMap<>();
        doc1.put("url", "https://example.com/page1.html");
        doc1.put("title", "Page 1");
        doc1.put("content", "Content 1");
        doc1.put("lang", "en");
        doc1.put("host", "example.com");
        doc1.put("cache", "cached1");
        docs.add(doc1);

現在，為了測試一切是否正常，建立一個路徑操作：

{* ../../docs_src/custom_docs_ui/tutorial001_py310.py hl[36:38] *}

### 測試 { #test-it }

現在你應該能造訪 [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs)，重新載入頁面後，資源會從新的 CDN 載入。

## 自行託管文件所需的 JavaScript 與 CSS { #self-hosting-javascript-and-css-for-docs }

若你需要應用在離線、無公共網路或僅在區域網路中也能運作，自行託管 JavaScript 與 CSS 會很實用。

以下示範如何在同一個 FastAPI 應用中自行提供這些檔案，並設定文件使用它們。

### 專案檔案結構 { #project-file-structure }

### Tester { #test-it }

Vous devriez maintenant pouvoir aller à vos docs sur [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs), puis recharger la page : elle chargera ces ressources depuis le nouveau CDN.

## Héberger en propre JavaScript et CSS pour les docs { #self-hosting-javascript-and-css-for-docs }