我正在使用 Django & DRF 来编写 REST API。最近我集成了 django-rest-framework-swagger 来自动填充 API 文档。
今天，我遇到了 swagger-ui 模板 [https://github.com/jensoleg/swagger-ui]，现在想用这个替换默认的 swagger 主题。
我将dist目录的所有内容复制到/venv/lib/python2.7/site-packages/rest_framework_swagger/static/ rest_framework_swagger 目录。但它不起作用（UI 看起来一点也不好看）。
【问题讨论】：
标签： django django-rest-framework swagger-ui django-swagger
要自定义 django-rest-swagger ui 模板，您只需在 root 模板目录中包含 rest_framework_swagger/index.html。就我而言，我将所有这些都放在我自己的 templates 目录下，该目录就在实际项目文件夹下。
这个index.html 文件应该类似于：
{% extends 'rest_framework_swagger/index.html' %}
{% load staticfiles %}
<!-- Your custom code -->
查看他们已经存在的模板：
{% load staticfiles %}
{% spaceless %}
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width initial-scale=1.0, maximum-scale=1.0, user-scalable=0">
<title>{% block title %}Swagger UI{% endblock %}</title>
{% block style %}
<link href="//fonts.googleapis.com/css?family=Droid+Sans:400,700" rel="stylesheet" type="text/css"/>
<link href="{% static 'rest_framework_swagger/css/highlight.default.css' %}" media="screen" rel="stylesheet" type="text/css"/>
<link href="{% static 'rest_framework_swagger/css/atelier-dune.light.css' %}" media="screen" rel="stylesheet" type="text/css"/>
<link href="{% static 'rest_framework_swagger/css/rest_framework_swagger.css' %}" media="screen" rel="stylesheet" type="text/css"/>
<link href="{% static 'rest_framework_swagger/css/screen.css' %}" media="screen" rel="stylesheet" type="text/css"/>
{% endblock %}
</head>
<body>
{% block body %}
{% block header %}
<div id="header">
<div class="swagger-ui-wrap">
{% block branding %}
<a id="logo" href="http://swagger.wordnik.com">swagger</a>
{% endblock %}
{% block api_selector %}
<form id="api_selector">
<div class="input icon-btn">
<img id="show-wordnik-dev-icon" src="{% static 'rest_framework_swagger/images/wordnik_api.png' %}" title="Show Wordnik Developer Apis">
</div>
<div class="input"><input placeholder="http://example.com/api" id="input_baseUrl" name="baseUrl" type="text"/></div>
<div class="input"><input placeholder="api_key" id="input_apiKey" name="apiKey" type="text"/></div>
<div class="input"><a id="explore" href="#">Explore</a></div>
</form>
{% endblock %}
</div>
</div>
{% endblock %}
{% block django_rest_swagger %}
<div id="django-rest-swagger">
<div class="swagger-ui-wrap">
<a href="https://github.com/marcgibbons/django-rest-swagger/">Django REST Swagger</a>
</div>
</div>
{% endblock %}
<div id="message-bar" class="swagger-ui-wrap"></div>
<div id="swagger-ui-container" class="swagger-ui-wrap"></div>
<script>
window.static_url = "{{ STATIC_URL }}";
</script>
<script src="{% static 'rest_framework_swagger/lib/shred.bundle.js' %}" type="text/javascript"></script>
<script src="{% static 'rest_framework_swagger/lib/jquery-1.8.0.min.js' %}" type="text/javascript"></script>
<script src="{% static 'rest_framework_swagger/lib/jquery.slideto.min.js' %}" type="text/javascript"></script>
<script src="{% static 'rest_framework_swagger/lib/jquery.wiggle.min.js' %}" type="text/javascript"></script>
<script src="{% static 'rest_framework_swagger/lib/jquery.ba-bbq.min.js' %}" type="text/javascript"></script>
<script src="{% static 'rest_framework_swagger/lib/jquery.cookie.js' %}" type="text/javascript"></script>
<script src="{% static 'rest_framework_swagger/lib/handlebars-1.0.0.js' %}" type="text/javascript"></script>
<script src="{% static 'rest_framework_swagger/lib/underscore-min.js' %}" type="text/javascript"></script>
<script src="{% static 'rest_framework_swagger/lib/backbone-min.js' %}" type="text/javascript"></script>
<script src="{% static 'rest_framework_swagger/lib/swagger.js' %}" type="text/javascript"></script>
<script src="{% static 'rest_framework_swagger/swagger-ui.min.js' %}" type="text/javascript"></script>
<script src="{% static 'rest_framework_swagger/lib/highlight.8.0.pack.js' %}" type="text/javascript"></script>
<script type="text/javascript">
$(function () {
window.swaggerUi = new SwaggerUi({
url: '{{ swagger_settings.discovery_url }}',
apiKey: '{{ swagger_settings.api_key }}',
dom_id: 'swagger-ui-container',
supportedSubmitMethods: {{ swagger_settings.enabled_methods }},
onComplete: function (swaggerApi, swaggerUi){
log('Loaded SwaggerUI')
$('pre code').each(function(i, e) {hljs.highlightBlock(e)});
},
onFailure: function (data) {
log('Unable to Load SwaggerUI');
},
docExpansion: '{{ swagger_settings.doc_expansion }}',
csrfCookieName: {{ django_settings.CSRF_COOKIE_NAME }}
});
$('#input_apiKey').change(function () {
var key = $('#input_apiKey')[0].value;
log('key: ' + key);
if (key && key.trim() != '') {
console.log('added key ' + key);
window.authorizations.add('key', new ApiKeyAuthorization('Authorization', '{{ swagger_settings.token_type }} ' + key, 'header'));
}
});
{% if swagger_settings.api_key %}
window.authorizations.add('key', new ApiKeyAuthorization('Authorization', '{{ swagger_settings.token_type }} ' + '{{ swagger_settings.api_key }}', 'header'));
{% endif %}
{# Add version to Accept header, if AcceptHeaderVersioning is used. #}
{% if swagger_settings.api_version and rest_framework_settings.DEFAULT_VERSIONING_CLASS == 'rest_framework.versioning.AcceptHeaderVersioning' %}
window.authorizations.add('version', {
apply: function(obj, authorizations) {
$.each(obj.headers, function(k, v) {
if (k.toLowerCase() === "accept") {
if (v.indexOf('; version=') === -1) {
obj.headers[k] += "; version={{ swagger_settings.api_version }}";
}
return false; // break.
}
});
return true;
}
});
{% endif %}
window.swaggerUi.load();
});
</script>
{% endblock %}
</body>
</html>
{% endspaceless %}
这个库代码位于rest_framework_swagger/base.html，他们的rest_framework_swagger/index.html看起来像这样：
{% extends 'rest_framework_swagger/base.html' %}
{# Override this template in your own templates directory to customize #}
注意：此解决方案适用于 rest_framework_swagger 0.3.x。他们最新的 rest_framework_swagger (2.x)，有一个重大变化，我强烈建议不要使用它，因为你不能做太多的自定义（例如，不能使用 YAML 字符串）。我在我的项目中使用 0.3.x，它工作得非常好。
【讨论】：