Infra:websiteinfosec: Difference between revisions
No edit summary |
No edit summary |
||
| Line 19: | Line 19: | ||
In case you want to test your changes first, after cloning the repository switch to branch '''dev'''. This will also trigger the build and deploy the dev version of the site which can be accessible at this location: [http://138.48.246.5:8888/ http://138.48.246.5:8888/] | In case you want to test your changes first, after cloning the repository switch to branch '''dev'''. This will also trigger the build and deploy the dev version of the site which can be accessible at this location: [http://138.48.246.5:8888/ http://138.48.246.5:8888/] | ||
= minima = | |||
''Minima is a one-size-fits-all Jekyll theme for writers''. It’s Jekyll’s default (and first) theme. It’s what you get when you run <code>jekyll new</code>. | |||
[https://jekyll.github.io/minima/ Theme preview] | |||
[[File:/screenshot.png|thumb|none|alt=minima theme preview|minima theme preview]] | |||
== Installation == | |||
Add this line to your Jekyll site’s Gemfile: | |||
<source lang="ruby">gem "minima"</source> | |||
And add this line to your Jekyll site: | |||
<source lang="yaml">theme: minima</source> | |||
And then execute: | |||
<pre>$ bundle</pre> | |||
== Contents At-A-Glance == | |||
Minima has been scaffolded by the <code>jekyll new-theme</code> command and therefore has all the necessary files and directories to have a new Jekyll site up and running with zero-configuration. | |||
=== Layouts === | |||
Refers to files within the <code>_layouts</code> directory, that define the markup for your theme. | |||
* <code>default.html</code> — The base layout that lays the foundation for subsequent layouts. The derived layouts inject their contents into this file at the line that says <code>{{ content }}</code> and are linked to this file via [https://jekyllrb.com/docs/frontmatter/ FrontMatter] declaration <code>layout: default</code>. | |||
* <code>home.html</code> — The layout for your landing-page / home-page / index-page. [[[#home-layout|More Info.]]] | |||
* <code>page.html</code> — The layout for your documents that contain FrontMatter, but are not posts. | |||
* <code>post.html</code> — The layout for your posts. | |||
=== Includes === | |||
Refers to snippets of code within the <code>_includes</code> directory that can be inserted in multiple layouts (and another include-file as well) within the same theme-gem. | |||
* <code>disqus_comments.html</code> — Code to markup disqus comment box. | |||
* <code>footer.html</code> — Defines the site’s footer section. | |||
* <code>google-analytics.html</code> — Inserts Google Analytics module (active only in production environment). | |||
* <code>head.html</code> — Code-block that defines the <code><head></head></code> in ''default'' layout. | |||
* <code>header.html</code> — Defines the site’s main header section. By default, pages with a defined <code>title</code> attribute will have links displayed here. | |||
=== Sass === | |||
Refers to <code>.scss</code> files within the <code>_sass</code> directory that define the theme’s styles. | |||
* <code>minima.scss</code> — The core file imported by preprocessed <code>main.scss</code>, it defines the variable defaults for the theme and also further imports sass partials to supplement itself. | |||
* <code>minima/_base.scss</code> — Resets and defines base styles for various HTML elements. | |||
* <code>minima/_layout.scss</code> — Defines the visual style for various layouts. | |||
* <code>minima/_syntax-highlighting.scss</code> — Defines the styles for syntax-highlighting. | |||
=== Assets === | |||
Refers to various asset files within the <code>assets</code> directory. Contains the <code>main.scss</code> that imports sass files from within the <code>_sass</code> directory. This <code>main.scss</code> is what gets processed into the theme’s main stylesheet <code>main.css</code> called by <code>_layouts/default.html</code> via <code>_includes/head.html</code>. | |||
This directory can include sub-directories to manage assets of similar type, and will be copied over as is, to the final transformed site directory. | |||
=== Plugins === | |||
Minima comes | |||
Revision as of 14:32, 19 December 2019
The website of Infosec team is accessible at this address infosec.unamur.be.
Technical Specification
The site is built using Jekyll (a static site generator based on Ruby). The website source file is stored on a git repository https://forge.infosec.unamur.be/infrastructure/team_front_page_website.
The git repository has two main branches:
- master: contains a production ready site
- dev: contains some experimental features
Modification of the site
To modify the site, follow these steps:
- Clone the repository https://forge.infosec.unamur.be/infrastructure/team_front_page_website
- Make changes
- Commit the changes
- Push it back to server
- The site will be rebuilt and deployed on server at each commit.
In case you want to test your changes first, after cloning the repository switch to branch dev. This will also trigger the build and deploy the dev version of the site which can be accessible at this location: http://138.48.246.5:8888/
minima
Minima is a one-size-fits-all Jekyll theme for writers. It’s Jekyll’s default (and first) theme. It’s what you get when you run jekyll new.
Installation
Add this line to your Jekyll site’s Gemfile:
<source lang="ruby">gem "minima"</source> And add this line to your Jekyll site:
<source lang="yaml">theme: minima</source> And then execute:
$ bundle
Contents At-A-Glance
Minima has been scaffolded by the jekyll new-theme command and therefore has all the necessary files and directories to have a new Jekyll site up and running with zero-configuration.
Layouts
Refers to files within the _layouts directory, that define the markup for your theme.
default.html— The base layout that lays the foundation for subsequent layouts. The derived layouts inject their contents into this file at the line that saysTemplate:Contentand are linked to this file via FrontMatter declarationlayout: default.home.html— The layout for your landing-page / home-page / index-page. [[[#home-layout|More Info.]]]page.html— The layout for your documents that contain FrontMatter, but are not posts.post.html— The layout for your posts.
Includes
Refers to snippets of code within the _includes directory that can be inserted in multiple layouts (and another include-file as well) within the same theme-gem.
disqus_comments.html— Code to markup disqus comment box.footer.html— Defines the site’s footer section.google-analytics.html— Inserts Google Analytics module (active only in production environment).head.html— Code-block that defines the<head></head>in default layout.header.html— Defines the site’s main header section. By default, pages with a definedtitleattribute will have links displayed here.
Sass
Refers to .scss files within the _sass directory that define the theme’s styles.
minima.scss— The core file imported by preprocessedmain.scss, it defines the variable defaults for the theme and also further imports sass partials to supplement itself.minima/_base.scss— Resets and defines base styles for various HTML elements.minima/_layout.scss— Defines the visual style for various layouts.minima/_syntax-highlighting.scss— Defines the styles for syntax-highlighting.
Assets
Refers to various asset files within the assets directory. Contains the main.scss that imports sass files from within the _sass directory. This main.scss is what gets processed into the theme’s main stylesheet main.css called by _layouts/default.html via _includes/head.html.
This directory can include sub-directories to manage assets of similar type, and will be copied over as is, to the final transformed site directory.
Plugins
Minima comes