搜索ven7ura / laravel-html5-boilerplate
HTML5 Boilerplate 模板集成到 Laravel。
This package is not auto-updated.
Last update: 2024-09-29 05:01:28 UTC
README
本包为用户提供了一个基本的页面模板，用于启动任何项目。它受到了HTML5 Boilerplate 项目的极大影响，并利用了 Laravel 提供的 Blade 模板引擎。
本包包含布局的基本结构（骨架结构）和 Blade 文件，以供您开始编码和添加内容。它不包括任何 CSS 框架（如 Bootstrap）或其他 JS 库，除了 HTML5 Boilerplate 项目中包含的一些。
安装
使用 composer 安装此包。
composer require ven7ura/laravel-html5-boilerplate
将包的内容发布到您的项目中。
php artisan vendor:publish --provider="Ven7ura\Html5Boilerplate\Html5BoilerplateServiceProvider"
结构
现在您将在 views 文件夹中看到两个新的文件夹，每个文件夹中都有具有独特目的的新文件。默认的结构和名称如下
- common
- footer.blade.php
- header.blade.php
- navigation.blade.php
- layout
- body.blade.php
- head.blade.php
- master.blade.php
- tail.blade.php
详细结构
common 文件夹包含在整个模板中可重用的文件。当然，您可以删除任何不必要的文件，并确保在 body.blade.php 文件中删除导入。
layout 文件夹包含布局的结构。这些文件很少更改。
- body.blade.php：包含所有
<body>内容的结构。 - head.blade.php：所有元数据、标题、描述和样式表的导入都包含在这个 Blade 文件中。
- master.blade.php：这是应该扩展的文件。整个模板都包含并导入到这个文件中。
- tail.blade.php：这个文件应该用于在
</body>标签关闭之前包含 JavaScript 和其他数据。
使用方法
发布文件后，您的 config 文件夹中将有一个名为 h5b.php 的文件。该文件包含一些可以用于启动您应用程序的配置。
manifest的值相对于 public 文件夹。一旦您准备好了该文件，您可以将路径设置为其路径，或者将其设置为false以移除加载 manifest 文件。appleicon的配置与 manifest 相同，即相对于 public 文件夹，并且如果您的应用程序没有使用它，则可以将其设置为false。- 您可以通过将
ga值设置为true并设置您的ga_id来设置 Google Analytics。 - jQuery 默认在 HTML5 Boilerplate 项目中使用，因此在这里也包括了。最好使用 Laravel 提供的工具进行编译和使用，以只生成一个 CSS 和 JS 文件。这些选项用于启动您的应用程序。
layout 文件夹中的 body.blade.php 文件应仅导入您将要使用的 common 文件。简单删除未使用的文件即可。
请确保 layout 文件夹中的 head.blade.php 文件中编译的 CSS 文件的路径正确，并且元数据（如标题）的使用正确。
要使用布局，非常简单
@extends('layout.master')
@section('title', 'The title of the page')
@section('description', 'Description of the page')
@section('content')
<p>Hello world! This is HTML5 Boilerplate.</p>
@stop
高级
您可以利用两个部分。一个是 head.blade.php 文件中的，另一个是 tail.blade.php 文件中的。
在 head.blade.php 文件中，你会找到一个名为 styles 的部分。使用 blade 引擎，你可以通过使用以下方法在你的应用程序的特定页面中包含自定义样式来充分利用它：
@section('styles')
@parent
<link rel="stylesheet" href="{{ asset('css/anotherfile.css') }}">
@endsection
另一个部分在 tail.blade.php 文件中，称为 scripts 部分。当你在应用程序的某些部分加载 JS 库或框架时，这也很有用。
许可证
Laravel HTML5 模板是在 MIT 许可证（MIT）下授权的。