添加bulma css框架及其扩展的django应用程序

django-simple-bulma的Python项目详细描述


Django简单球茎

build statusdiscordpipfile)

  • 在您的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',]
  • 运行python manage.py collectstatic命令以构建bulma并将其移动到staticfiles文件夹。请注意,每次更改配置时都需要使用此命令,因为这是重建bulma css文件的唯一方法。如果您没有使用collectStatic,请阅读并开始使用它。

    此应用程序可与whitenoise一起正常工作,这是一种提供静态文件而无需干扰web服务器的好方法。

  • 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 burgers和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,请注意它与此项目不兼容。在sasslibsass之间存在命名空间冲突,当您尝试执行collectStatic时,这将使django简单bulma崩溃。要解决这个问题,只需卸载sass并改用libsass

    如果你碰到其他人此应用程序有问题,请创建一个问题,我们很乐意为您提供帮助。或者,前往我们位于https://discord.gg/python的Discord服务器rel="nofollow">https://discord.gg/python,我们将帮助您通过聊天解决问题。

    欢迎加入QQ群-->: 979659372 Python中文网_新手群

    推荐PyPI第三方库


    热门话题
    java InputStream对象在声明后关闭   java未定义名为“transactionManager”的bean重命名transactionManager   java“jar”命令何时会拒绝将类添加到java中。jar文件?   java JPA标准依赖WHERE子句   安卓中从SD卡读取文本文件时出现java错误   java直接启用类似位置的权限   使用@WebMvcTest和Mockito-BDDMockito对SpringBoot-RestController进行java测试   java JSESSIONID存储在哪里?   java jtextarea鼠标事件覆盖容器鼠标事件   java DRL无法解析动态加载的类   java是从一个方法返回多个对象的最简单方法   java自定义按钮/编辑框是否不可见?   java GUI如何在保存用户输入的同时在面板或框架之间切换   swing Java自定义JSlider不会更新   GridBagLayout中的java超过1个JPanel   java从ProjectReactor中的flux中采样除第一个元素外的所有元素   Java泛型和泛型类型   Java代码生成宽指令的jvm