添加bulma css框架及其扩展的django应用程序
django-simple-bulma的Python项目详细描述
Django简单球茎
在您的django项目中settings.py
文件:
- 将django_simple_bulma添加到已安装的应用程序中
INSTALLED_APPS=[#...'django_simple_bulma',#...]
- 将
django_simple_bulma.finders.simplebulmafinder
添加到staticfiles_finders
中。这通常包含两个您可能希望保留的默认处理程序,因此,除非您有任何其他自定义查找程序,否则它应该如下所示:STATICFILES_FINDERS=[# First add the two default Finders, since this will overwrite the default.'django.contrib.staticfiles.finders.FileSystemFinder','django.contrib.staticfiles.finders.AppDirectoriesFinder',# Now add our custom SimpleBulma one.'django_simple_bulma.finders.SimpleBulmaFinder',]
运行 此应用程序可与whitenoise一起正常工作,这是一种提供静态文件而无需干扰web服务器的好方法。python manage.py collectstatic
命令以构建bulma并将其移动到staticfiles
文件夹。请注意,每次更改配置时都需要使用此命令,因为这是重建bulma css文件的唯一方法。如果您没有使用collectStatic,请阅读并开始使用它。
django simple bulma
现在应该可以工作了!要将其导入到模板中,请首先使用{%load django_simple_bulma%}
加载应用程序,然后使用{%bulma%}
模板标记。如果您打算使用图标,还应该使用{%font_awesome%}
<head><!-- ... --> {% load django_simple_bulma %} {% bulma %} {% font_awesome %} <!-- ... --></head>
- 你们都准备好了!你申请的所有布尔马课程现在都应该开始工作了!
定制
Bulma在默认情况下看起来不错,但大多数用户都希望自定义它的外观和感觉。为此,我们提供了一种超级简单的方法来更改bulma变量,并选择要加载到项目中的bulma扩展。
为了做到这一点,我们我只需在settings.py中创建一个名为
bulma_settings
的字典,然后在那里进行配置。下面是一个这样的例子:
# Custom settings for django-simple-bulmaBULMA_SETTINGS={"extensions":["bulma-accordion","bulma-calendar",],"variables":{"primary":"#000000","size-1":"6rem",}}
您可以在这里定义在bulma variables页面上找到的任何变量,您可以使用任何有效的sass或css作为值。例如,hsl(21771%,53%)
将是颜色变量的有效值,与ffff00
一样。请注意,任何语法上不正确的值都可能会妨碍Bulma的正确构建,因此请注意此处添加的内容,除非您确切知道自己在做什么。
如果未找到扩展名
键,则默认为加载所有扩展名。如果不需要任何扩展名,只需将其设置为空列表即可。
其他脚本
为了您的方便,我们还为您提供在Bulma应用程序中添加其他生活质量改进的选项。如果您没有在bulma_settings
中指定任何扩展名,则默认情况下都将加载这些扩展名。如果是的话,如果听起来有用,也可以添加这些内容。
bulma file upload
将处理在文件上载输入中显示文件名的操作bulma navbar burger
将自动连接您的navbar burger
s和navbar菜单,为移动用户提供切换。我们使用稍有更新的版本,即bulma文档中的示例-只需将一个
数据目标
属性添加到您的导航栏汉堡
中,该菜单应该展开d按按钮折叠。bulma通知
允许您通过单击x按钮关闭通知。
附加功能
如果您正在为应用程序编写自定义scs,django simple bulma
确实提供了一种非常基本的编译机制
这是给你的。这是因为,当前,django simple bulma
将导致当前django应用程序存在问题
为您编译scss。
要使用此功能,请在定义bulma_设置时指定
custom_css
键。这应该是一份清单
字符串,包含要编译的.scss
文件的相对路径。
BULMA_SETTINGS={"custom_scss":["myapp/static/css/base/base.scss"],}
请注意:收集静态文件时的默认django行为是保留
当它们被复制到最终的静态文件目录时。我们试图通过解析给定的
指向.scss
文件的路径,使用以下策略:
- 如果包含路径存在于
staticfiles\u dirs
设置中,则假设这是要使用的基本路径,并且 下面的目录结构将用于包含生成的.css
文件 - 否则,如果路径包含
static/
,则假定基路径结束于此并使用路径的其余部分 在它下面包含生成的.css
文件。
如果这两种策略都无法确定要使用的基本路径,则会引发异常。
故障排除
- 如果您安装了模块sass,请注意它与此项目不兼容。在
sass
和libsass
之间存在命名空间冲突,当您尝试执行collectStatic
时,这将使django简单bulma
崩溃。要解决这个问题,只需卸载sass
并改用libsass
。
如果你碰到其他人此应用程序有问题,请创建一个问题,我们很乐意为您提供帮助。或者,前往我们位于https://discord.gg/python的Discord服务器rel="nofollow">https://discord.gg/python,我们将帮助您通过聊天解决问题。