Infra:websiteinfosec: Difference between revisions

From UNamur InfoSec
Jump to navigation Jump to search
No edit summary
Line 2: Line 2:


= Technical Specification =
= 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 https://forge.infosec.unamur.be/infrastructure/team_front_page_website].
The site is built using Jekyll (a static site generator based on Ruby) and it uses markdown to format text.
 
The website source file is stored on a git repository [https://forge.infosec.unamur.be/infrastructure/team_front_page_website https://forge.infosec.unamur.be/infrastructure/team_front_page_website].


The git repository has two main branches:
The git repository has two main branches:

Revision as of 14:36, 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) and it uses markdown to format text.

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:

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/

Site structure

The website uses minima template Theme preview.

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 says Template:Content and are linked to this file via FrontMatter declaration layout: 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 defined title attribute 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 preprocessed main.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.