django-htmx 现在开始阅读文档

493 阅读1分钟

我刚刚发布了django-htmx1.9.0,作为该版本的一部分,它现在有了一个用Sphinx构建的文档网站,托管在Read the Docs上,地址是django-htmx.readthedocs.io

文档看起来比GitHub上的README好看多了,特别是得益于Furo主题。 它的几个页面也更容易消化。

我还增加了几个部分,涵盖了一些在Django中使用htmx的有用技巧。

  • django-htmx不包括htmx,所以你可以单独升级这两个。

    我介绍了如何将htmx下载到你的项目的静态文件中。 这与我对htmx的公开PR相一致,不再强调直接使用unpkg.com。

  • 如何让htmx通过Django的CSRF令牌。 这是一个普遍需要的模式。 以前只在包含的 "示例项目 "中涉及,但这并不容易发现。

  • 如何进行部分渲染,这是一个很好的技巧,可以减少服务器端的渲染时间。 这个技术也在示例项目中涉及。

今后,"技巧 "页面可能会增加更多的技术。

感谢。

  • Ben Beecher在PR #194中做了最初的Sphinx和阅读文件的设置。
  • Pradyun Gedam提供的Furo主题
  • Read the Docs团队提供了这么好的文档托管服务!

-阿丹