dorantes/laravel-pug

Laravel 4 的 Pug 视图适配器

1.2.2 2017-04-14 18:48 UTC

This package is not auto-updated.

Last update: 2024-09-20 20:26:21 UTC


README

这是一个小的包,它通过 Pug.php 支持将 Pug (Jade) 模板编译到 Laravel 中。在视图中支持纯 PHP 和 Blade 语法

安装

  1. 运行 composer require dts/laravel-pug
  2. 将服务提供者添加到 app.php 的 providers 中:DTS\LaravelPug\ServiceProvider,

配置

所有 Pug.php 配置选项都通过 Laravel 配置数组传递。

  • 使用 php artisan config:publish dts/laravel-pug --path=vendor/dts/laravel-pug/config 发布配置文件,并编辑 /app/config/packages/dts/laravel-pug/config.php

用法

Laravel Pug 将 ".pug", ".pug.php", ".pug.blade", 和 ".pug.blade.php" 以及 ".jade", ".jade.php", ".jade.blade", 和 ".jade.blade.php" 扩展名注册为 Laravel,并将编译请求转发到 Pug.php。它以与 Blade 模板相同的方式编译您的 Pug 模板;编译后的模板将放在您的存储目录中。因此,您不会在每次页面加载时都遭受编译时间。

换句话说,只需将您的 Pug 文件放在常规视图目录中,并将其命名为 "whatever.pug"。您可以在 Laravel 中像正常一样引用它们

  • View::make('home.whatever') 对应于 app/views/home/whatever.pug

Pug 视图文件可以与常规 PHP 视图并行使用。要在 Pug 中使用 Blade 模板,只需将文件命名为 ".pug.blade" 或 ".pug.blade.php" 扩展名即可。

扩展布局/包含子视图

模板的默认根目录为 app/views,因此从任何深层次的模板中,您可以使用绝对路径从根目录获取其他 Pug 文件:`extends /layouts/main` 将扩展文件 resources/views/layouts/main.(pug|jade),`include /partial/foo/bar` 将包含 resources/views/partial/foo/bar.(pug|jade)。您可以使用 `basedir` 选项将根目录设置为其他目录。不以斜杠开头的路径将相对于当前模板文件解析。

历史

阅读 Github 项目版本 以获取发布说明。