1

API ドキュメントを Markdown で記述し、MkDocs を使用して静的サイトを生成する傾向があります。ただし、ドキュメントをホストしたいサイトは Django サイトです。私の質問は、グーグルで答えが見つからないようです.MkDocs静的生成サイトファイルを次のような場所にホストし、/api/v1/docsそのURLで静的サイトを表示できるようにするにはどうすればよいですか?

更新: 私は Apache の下ですべての静的ファイルを提供し、runserver またはデバッグ モードを使用して静的ファイルを提供しないことを指摘しておく必要があります。このサイトは完全に構築されており、REST API と連動しています。

私の質問は、特定の URL で MkDocs によって生成された静的サイト (API ドキュメント用) を Django (または Apache と言うべきか) に提供するにはどうすればよいかということでした。サイトのメディア ファイルと静的ファイルを提供する方法は理解していますが、MkDocs が生成するものを提供する方法は必ずしも理解していません。HTML とアセット ファイルを含む完全に静的な「サイト」ディレクトリを生成します。

4

3 に答える 3

4

Django は、静的ファイルをホストし、それらを Nginx や Apache などで提供するために必要な単なるフレームワークです。

于 2015-09-10T21:15:20.807 に答える
2

apache にエイリアスディレクティブが必要で、それを使用して特定の URL を静的ドキュメント サイトにリダイレクトする必要があると思います。

于 2015-09-11T23:24:25.437 に答える
-1

ドキュメントから

urls = [
    static(settings.STATIC_URL, document_root=settings.STATIC_ROOT),
    ("/home","views.home"),
    ...

 ]

https://docs.djangoproject.com/en/1.8/howto/static-files/#serving-static-files-during-development

あなたの要求では、あなたはに変更します

 static("/api/v0/docs",document_root="/home/docs/")
于 2015-09-10T21:15:49.403 に答える