经验首页 前端设计 程序设计 Java相关 移动开发 数据库/运维 软件/图像 大数据/云计算 其他经验
当前位置:技术经验 » 程序设计 » Django » 查看文章
django Admin文档生成器使用详解
来源:jb51  时间:2019/7/23 8:30:31  对本文有异议

前言

Django的admindocs应用可以从模型、视图、模板标签等地方获得文档内容。

一、概览

要激活admindocs,请按下面的步骤操作:

  • 在INSTALLED_APPS内添加django.contrib.admindocs
  • 在urlpatterns内添加url(r'^admin/doc/',include('django.contrib.admindocs.urls'))。确保它处于r'^admin/'条目之前,原因你懂的。
  • 安装Python的docutils模块(http://docutils.sf.net/)(pip3 install docutils)
  • 可选:想使用admindocs的书签小工具,需要安装django.contrib.admindocs.middleware.XViewMiddleware

如果上述步骤顺利完成,那么你可以从admin界面访问doc界面,也可以直接访问/admin/doc,如下图:

它看起来是下面的样子:

下面的这些特殊标记,可帮助你在文档字符串中,快速创建指向其它组件的链接:

二、模型

在doc页面的模型部分,列出了所有的模型,点击可以查看具体的字段等细节信息。信息主要来自字段的help_txt部分和模型方法的docstring部分。如下面图中展示:

有用的帮助信息看起来是这个样子的:

  1. class BlogEntry(models.Model):
  2. """
  3. Stores a single blog entry, related to :model:`blog.Blog` and
  4. :model:`auth.User`.
  5. """
  6. slug = models.SlugField(help_text="A short label, generally used in URLs.")
  7. author = models.ForeignKey(
  8. User,
  9. models.SET_NULL,
  10. blank=True, null=True,
  11. )
  12. blog = models.ForeignKey(Blog, models.CASCADE)
  13. ...
  14.  
  15. def publish(self):
  16. """Makes the blog entry live on the site."""
  17. ...

三、视图

站点内的每个URL都会在doc内享有一个页面,点击某个URL将会展示对应的视图信息。主要包括下面这些信息,请尽量丰富它们:

  • 视图功能的简单描述
  • 上下文环境,或者视图模块里的变量列表
  • 视图内使用的模板

例如:

  1. from django.shortcuts import render
  2.  
  3. from myapp.models import MyModel
  4.  
  5. def my_view(request, slug):
  6. """
  7. Display an individual :model:`myapp.MyModel`.
  8.  
  9. **Context**
  10.  
  11. ``mymodel``
  12. An instance of :model:`myapp.MyModel`.
  13.  
  14. **Template:**
  15.  
  16. :template:`myapp/my_template.html`
  17. """
  18. context = {'mymodel': MyModel.objects.get(slug=slug)}
  19. return render(request, 'myapp/my_template.html', context)

四、模板标签和过滤器

所有Django内置的或者你自定义的或者第三方app提供的标签和过滤器都将在页面内展示:

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持w3xue。

 友情链接:直通硅谷  点职佳  北美留学生论坛

本站QQ群:前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

W3xue 的所有内容仅供测试,对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接(目前9元/月)请联系QQ:27243702 沸活量
皖ICP备17017327号-2 皖公网安备34020702000426号