联邦政府门户标准主题
项目描述
简介
此软件包提供了2个联邦政府主题（Diazo）模型，用于巴西联邦政府Plone网站的用途。
该软件包的开发是作为标准门户社区PloneGov.Br倡议的一部分。
主题
标准主题
白色主题
此软件包的状态
brasil.gov.temas 具有自动化测试，并且每次对其代码进行更改时，测试都会通过 Travis 服务执行。
以下图像显示了当前测试状态、代码覆盖率和此软件包的下载次数
安装
要在使用 buildout 的环境中启用此产品的安装
编辑 buildout.cfg 文件（或另一个配置文件）并将包 brasil.gov.temas 添加到安装 eggs 列表中
[buildout]
...
eggs =
brasil.gov.temas修改配置文件后，必须执行“bin/buildout”，该命令将更新您的安装。
重新启动 Plone
访问控制面板，在 主题 选项中，您将看到此软件包提供的主题列表。
开发
步骤
打开终端，进入项目文件夹，运行 buildout 并启动实例；
打开另一个终端，进入项目文件夹，启动 bin/watch-brasilgovtemas 命令；
修改 webpack 文件夹中的文件。
更多详情
我们使用 webpack 来管理主题的静态内容，并利用各种工具和插件来满足我们的需求。
我们使用 buildout 菜谱 sc.recipe.staticresources 将 webpack 集成到 Plone。
在开发主题时，我们启动了 webpack 监视器，并在“webpack”文件夹中仅修改文件；webpack 负责处理和生成最终地址的文件。
以下是一些主要文件的列表
$ tree webpack/app
webpack/app
├── brasilgovtemas.js
├── favicons
│ └── Lista de imagens para o Favicon
├── fonts
│ └── Lista de Fontes utilizadas no site
├── index.html
├── js
│ └── Lista de módulos Javascript
├── rules.xml
├── scss
│ └── Lista de módulos Scss
├── tema-1
│ ├── brasilgovtemas.scss
│ ├── favicons
│ │ ├── browserconfig.xml
│ │ └── manifest.json
│ ├── img
│ │ └── sprite.png
│ ├── manifest.cfg
│ ├── preview.png
│ ├── sprite
│ │ └── Lista de Imagens para criação do sprite
│ └── _sprite.scss
├── tema-2
│ └── Arquivos do tema 2
└── tema-3
└── Arquivos do tema 3在当前结构中，存在一些所有主题共有的文件和一些针对每个主题的不同文件。全局文件位于 webpack/app 文件夹中，而其他文件则位于每个主题的文件夹中。
我们采用了在 Plone 中不常见的策略，不在 portal_css 和 portal_javascripts 中注册 CSS 和 JS 文件；相反，我们将生成新文件名的任务留给了 webpack。
文件 brasilgovtemas.js 使用 ES6 编写，在处理过程中，通过编译器 Babel 将其转换为 ES5，生成一个 brasilgovtemas-[hash].js 文件，并为每个主题创建该文件的副本。
在 favicons 文件夹中包含用于在所有平台上包含网站 favicons 所需的图像。
在 fonts 文件夹中包含本包主题中使用的 Web 字体。
Diazo 文件夹中的 index.html 文件不在版本控制中。相反，在 "webpack" 文件夹中存在一个 index.html 文件，每次执行 buildout 或 webpack 时都会进行处理，并在 Diazo 文件夹中生成 JS、CSS 和 index.html 文件。JS 和 CSS 文件具有特殊的名称，包含 hash，该 hash 在每次执行 buildout 时都会更新。
文件 rules.xml 被复制到每个主题中，并且最初对每个主题都是相同的。
在 scss 文件夹中存在实际的样式文件，我们应在此处更改所有主题共享的 CSS 结构，并且在该文件夹中的更改会在 webpack 执行后反映到所有主题中。
每个主题都有一个 brasilgovtemas.scss 文件；其中包含每个主题中变化的变量定义，如字体、大小和颜色，并导入 "scss" 文件夹中的文件以处理每个主题。该文件在处理后会转换为 brasilgovtemas-[hash].css。
在主题文件夹中的 favicons 文件夹内包含与 favicon 相关的配置文件，这些文件为某些平台创建，需要针对每个主题进行更改。
还存在 manifest.cfg 和 preview.png 文件，每个主题都有其独特性，并且对于 Diazo 是必需的。
每个主题都有一个 "sprite" 文件夹，其中包含在主题中使用的图标。这些图标在主题中被处理后生成 _sprite.scss 和 img/sprite.png 文件。第一个文件创建主题中使用的 mixins，以简化 sprite 规则的插入，第二个文件是 sprite 本身，它将 "sprite" 文件夹中存在的所有图像组合在一起。
添加了一个插件来删除带有 hash 的旧文件，以防止 CSS 和 JS 文件在文件夹中积累。
此包在 buildout 的 bin 文件夹中添加了以下命令以自动处理静态资源。
$ bin/env-brasilgovtemas此命令将 buildout 的 node 添加到系统的 PATH 中，这样就可以按照官方文档使用 webpack。
$ bin/watch-brasilgovtemas此命令指示 Webpack 等待 SASS 文件中的任何更改，并为应用程序生成压缩后的 CSS 版本。
$ bin/debug-brasilgovtemas此命令与 watch 命令类似，但不压缩最终的 CSS。用于调试 CSS 生成。
$ bin/build-brasilgovtemas此命令创建压缩后的 CSS，但不等待更改。
顶部语言链接（国际化）
在当前的 CSS 文件中存在显示语言链接的规则，例如类 language-en 和 language-es。为了添加这些语言的链接而不必自定义主题，请在 site_actions 中添加具有相同 id 的 actions，并且 Diazo 规则将正确地将渲染的链接放置在主题的语言列表中。
使用 zest.releaser 进行发布
该包的静态资源使用webpack生成，并且不包含在VCS中。如果您使用zest.releaser进行发布，则需要手动上传文件到PyPI，否则您将创建一个损坏的发布版本。上传文件。
执行longtest，如常。
执行fullrelease，如常，回答“否”以避免上传到PyPI。
检出您要发布的发布标签。
执行bin/build-brasilgovtemas以创建静态资源。
使用python setup.py sdist bdist_wheel创建分发文件，如常。
使用twine upload dist/*手动上传文件。
如果发生错误，您将需要创建一个新的发布版本，因为PyPI仓库不允许重复使用文件名。
贡献者
没有以下人员的贡献，brasil.gov.temas将无法实现。
André Nogueira
Carlos Vieira
Danilo Barbato
Érico Andrei
Héctor Velarde
Igor Prado
Felipe Duardo
Rennan Rodrigues
Rodrigo Ferreira de Souza
Tânia Andrea
要报告问题或提出改进建议，请在此包的存储库中创建一个ticket。
变更日志
2.0.3 (2019-02-22)
修复了顶部响应式中的文字重叠问题。[agnogueira]
正确显示了Body标签的“data-base-url”属性的值。[agnogueira]
2.0.2 (2018-12-28)
修复了响应式中的搜索结果。[agnogueira]
修复了响应式中的可展开顶部。[agnogueira]
修复了响应式中的实时博客帖子。[agnogueira]
调整了页眉和缩略图的字体。[agnogueira]
调整了封面行的边距。[agnogueira]
修复了可展开页眉中的“Em Alta”位置。[agnogueira]
2.0.1 (2018-12-07)
重新定位了阻止在更改密码标签页上点击的链接。[agnogueira]
修复了响应式中的样式。[agnogueira]
修复了允许启动实时博客视频的链接。[rodfersou, agnogueira]
2.0 (2018-12-04)
使用YouTube API控制实时博客顶部的视频。[rodfersou]
为收藏夹缩略图添加了样式。[agnogueira]
为页眉可展开搜索添加了背景视频的样式。[agnogueira]
调整了缩略图标题的响应式样式。[agnogueira]
2.0rc1（2018-11-23）
修复了由于Social Like位置更改而导致的顶部突出显示位置错误。[agnogueira]
调整了主题（缩略图和菜单）的响应式样式。[agnogueira]
调整了实时博客的布局。[agnogueira]
2.0b5（2018-10-17）
限制了社交媒体图标的运动，以防止其侵入网站页脚。[rodfersou]
修复了插入门户操作链接。[rodfersou]
更新了webpack的配置。[rodfersou]
修复了插入用于国际化的网络视图。[rodfersou]
将返回顶部的链接移动到brasil.gov.portal中的视图，以允许国际化。[rodfersou]
修复了扩展头（关闭#543）。[rodfersou, agnogueira]
将使用许可的文本移动到brasil.gov.portal中的视图，以允许国际化。[rodfersou]
修复了新闻分享按钮的位置。[agnogueira, rodfersou]
2.0b4（2018-10-05）
调整了菜单的宽度。[agnogueira, rodfersou]
修复了顶部突出显示行的宽度。[agnogueira, rodfersou]
2.0b3（2018-09-28）
为控制顶部突出显示的渐变添加了样式。[agnogueira]
更改了主题的基本背景颜色。[agnogueira]
为封面顶部添加了背景图像的样式。[agnogueira]
修复了链接缩略图样式的图标。[agnogueira]
避免了静态资源的source maps的生成。[hvelarde]
2.0b2（2018-09-04）
初始样式以允许使用带颜色的封面。为了使样式生效，用户必须创建名为“突出显示背景封面”的封面模板。[agnogueira]
修正了导航瓷砖的宽度。[agnogueira]
修正了配置屏幕上的宽度（关闭 #211）。[agnogueira]
更新了 Node.js 和 sc.recipe.staticresources 的版本。[rodfersou]
更改了主题默认新闻页眉的颜色。[agnogueira]
修正了瓷砖分享的样式。[agnogueira]
为叠加照片添加了新的尺寸变化。[agnogueira]
为突出显示的新闻添加了新的大标题。[agnogueira]
当通过键盘访问时，使跳转链接可见。[agnogueira]
添加了键盘导航的视觉反馈。[agnogueira]
2.0b1（2018-08-31）
添加了结果过滤器视图。[rodfersou]
添加了内容中心视图。[rodfersou]
为页眉变化添加了新的样式。[agnogueira]
添加了新的白色主题。[agnogueira, rodfersou]
修正了 SCSS 以使其从变量开始工作。[agnogueira, rodfersou]
为瓷砖添加了新的样式。[agnogueira]
为页眉变化添加了额外的模板。[agnogueira]
删除了社交媒体图标中的 ID 冲突。[agnogueira]
从导航栏使用页脚徽标。[agnogueira]
添加了新的主要字体变化。[agnogueira]
对页眉、页脚、内容和瓷砖中的字体进行了全面审查。[agnogueira]
改变了门户网站的总体宽度。[agnogueira]
为标签添加了新样式。[agnogueira]
对集合视图和过滤器视图进行了视觉调整。[agnogueira]
改变了对比度图标。[agnogueira]
修正了网站许可证文本的显示，并在所有页面上显示（参考 #190）。[hvelarde, agnogueira]
修正了支持网站统计的脚本显示（关闭 #188）。[agnogueira]
2.0a6（2018-07-06）
调整了页面宽度、背景色和字体。[agnogueira]
审查了门户网站顶部的字体。[agnogueira]
审查了 brasil.gov.agenda 的样式。[agnogueira]
2.0a5（2018-06-06）
审查了照片画廊视图。[rodfersou]
审查了门户网站顶部的样式。[agnogueira]
为门户网站的瓷砖创建样式。[agnogueira]
为门户网站顶部的突出显示瓷砖创建样式。[agnogueira]
为瓷砖添加了默认 Flex 行为。[agnogueira]
为特定部分更改了页眉的颜色。[agnogueira]
为响应式设计进行了样式演变。[agnogueira]
对行和列进行了视觉变化。[agnogueira]
为新闻和页面中的文本添加了通用样式。[agnogueira]
2.0a4（2018-02-08）
修正了主题的默认路径，不以“/”开头。[rodfersou]
不隐藏移动设备上的门户网站标题。[rodfersou]
2.0a3（2018-01-11）
修正了损坏的发布版本。[hvelarde]
2.0a2（2018-01-11）
调整了响应式设计。[agnogueira]
调整了搜索。[rodfersou, agnogueira]
添加了 favicon。[rodfersou]
修正了对比度的功能。[rodfersou, agnogueira]
格式化了内容。[agnogueira]
在顶部和页脚添加了社交媒体图标。[agnogueira]
为瓷砖添加了样式。[agnogueira]
修正了门户网站的标题和徽标。[agnogueira]
2.0a1（2017-12-27）
初始发布。[agnogueira, rodfersou, hvelarde]
下载文件
下载适用于您平台的文件。如果您不确定选择哪一个，请了解更多关于 安装包 的信息。
