README

已弃用

此主题已合并到主仓库。对此仓库的任何更改都不会出现在网站上。

nicsdru_nidirect_theme

此仓库包含nidirect Drupal 8网站主题的代码。

快速开始

composer config repositories.repo-name vcs git@github.com:dof-dss/nicsdru_nidirect_theme.git
composer require dof-dss/nicsdru_nidirect_theme:dev-
在终端中cd到目录（[DRUPAL_ROOT]/themes/custom/nicsdru_nidirect_theme）并运行 npm install

包含内容

该套件使用NPM脚本和包来创建工具，以

将scss编译成css
为css规则应用适当的命名空间
编写和压缩js
检测用户浏览器提供的功能（通过Modernizr）
代码检查
优化和压缩网络图像
通过kss提供代码的实时样式指南

在下载中，您将找到以下目录和文件，逻辑上分组常用资产，您将看到类似以下内容

nicsdru_origins_theme/
└── config/
└── css/
└── docs/
└── inc/
└── js/
└── src/
│   ├── images/
│   ├── js/
│   ├── scss/
│   ├── styleguide/
└── templates/
└── .gitignore
└── composer.json
└── mkdocs.yml
└── nicsdru_nidirect_theme.breakpoints.yml
└── nicsdru_nidirect_theme.info.yml
└── nicsdru_nidirect_theme.layouts.yml
└── nicsdru_nidirect_theme.libraries.yml
└── nicsdru_nidirect_theme.theme
└── package.json
└── README.md
└── screenshot.png

使用NPM脚本

package.json 包含以下命令和任务

任务	描述
`npm run build`	`npm run build` 将文件编译到构建目录，以用于生产环境。使用 Sass、Autoprefixer、Modernizr 和 UglifyJS。
`npm run watch`	监视scss和js文件的变化，并编译它们以用于开发目的。
`npm run lint`	将所有 `.scss` 和 `.js` 文件通过它们各自的检查工具进行检查 - eslint 和 sass-lint
`npm run lint-scss`	将所有 `.scss` 文件通过 sass-lint 进行检查。该命令还可以接受一个参数来检查单个文件。为此，请运行 `npm run lint-scss -- scssfile:name-of-file`，其中 `name-of-file` 是相对于项目 `package.json` 的文件名。

运行 npm run 以查看所有npm脚本。

主题钩子

常见的主题钩子，如 hook_preprocess、hook_alter，不应添加到 .theme 文件中，而应添加到 /inc 目录下的相应包含文件中。目前有如下钩子文件：

alter
preprocess
process
theme

实用类

src/LayoutClasses.php 类提供常用CSS类组的静态常量。

src/Helpers.php 类包含常用或有帮助的函数。'blockContent' 方法将加载一个块并返回视图构建器的渲染数组。

文档

页面标题处理

Drupal 通常会将标签或标题变量添加到 page.twig.html 模板中，如果需要在其他内容变体中的单独位置显示，则需要使用辅助模板变量加预处理来显示/隐藏正确的值。

Drupal 8 引入了一个页面标题块，该块使用 {{ drupal_block('page_title_block', wrapper=false) }} Twig 扩展在给定的模板中渲染。这种方法提供了最大灵活性，并将任何条件逻辑从预处理钩子移动到块配置本身。

dof-dss / nicsdru_nidirect_theme

维护者

详细信息