This repository hold the content and design of following web pages:
tclb.io- TCLB Solver websitemcf.tclb.io- UQ's MCF Group website
The sites are generated from common content with Hugo static webpage generator.
The repository uses git submodules for the external hugo themes (hugo-creative-portfolio-theme and congo). To download everything:
git clone git@github.com:CFD-GO/sites.git
cd sites
git submodule init
git submodule updateWhen doing changes, you can inspect the results by running Hugo locally. To preview the MCF webpage:
hugo --config mcf serverThis will start up a local server. Just ctrl+click the displayed address and inspect. Changes you make will be immediately refreshed in browser.
For the TCLB site:
hugo --config tclb serverAny changes on the master branch will be published on the webpages.
All major changes should be done through a Pull Request.
The repo is designed to hold data for multiple sites. Most content should be kept in the common folders.
Most of the content is organised in .md markdown files (Goldmark). The markdown format is quite standard, with the exception of so-called shortcodes, which can include special content.
The .md files have a data segment at the beginning called "front matter". The data is formatted using YAML format and should include such things as title: or date:. In this repo, front matter data is also used to assign content to different categories of different websites.
To assign a page to publications and news category on the MCF website, add:
mcf:
- publications
- newsBy default a page is visible in all website it was assigned to something. Any reference to them on other websites will be redirected.
If a page is assigned multiple sites, but should be visible only in one, a sites: data can be added. For example:
title: Some job offer at MCFmcf:
- news
- jobstclb:
- news
- jobssites:
- mcfThis way, the job offer will be visible in the news on TCLB site, but will redirect to the MCF website.
Content about people. The names of the files should be the person id, written lowercase and with - in place of spaces (eg. content/people/l-laniewski-wollk.md). The person id is: First letter of first name, space and surname. All latin characters.
In the front matter of the .md file we need:
short: L Laniewski-Wollk # person IDtitle: Łukasz Łaniewski-Wołłk # full name, the way you like to write it.tclb: people # if you're on TCLB teammcf: people # if you're on MCF teamscopus: '56719775800'# Scopus ID if you have one (can be a list)orcid: 0000-0002-3026-5881 # ORCID if you have oneIn the content you can include the {{< publist >}} shortcode to have a publication list.
Content about publications. The names of the files should be named content/doi/[DOI].md.
In the front matter of the .md file we need:
doi: 10.1016/j.camwa.2015.12.043 # DOItitle: Adjoint Lattice Boltzmann for topology optimization on multi-GPU architectureauthors: # Author IDs
- L Laniewski-Wollk
- J Rokickikeywords: # Keywords if you want
- adjoint
- lattice boltzmann method
- optimizationdate: '2016-02-01'# Date of publicationjournal: Computers and Mathematics with Applicationspublisher: Elsevier Ltdauto_content: yes # DELETE THIS TO NOT AUTO GENERATE CONTENTauto_data: yes # DELETE THIS TO NOT AUTO GENERATE METADATAredirect: https://doi.org/10.1016/j.camwa.2015.12.043 # DELETE THIS TO NOT REDIRECTrealauthors: # This is needed to know how the names on the publication correspond to our IDsL Laniewski-Wollk: Ł. Łaniewski-WołłkJ Rokicki: J. Rokickiimage: /img/doi/10.1016/j.camwa.2015.12.043/firstpage.pngshowonlyimage: yesMain place for general posts.
Place for TCLB website specific content.
Place for MCF website specific content.
All static files (like images, data, etc) should be placed here.
Place for images. All files here will be visible on the server at https://domain.name/img/
Place for DOI images. Images should be placed in static/img/doi/[DOI]/...
A lot of data can be harvested from Scopus. The scripts related to that are placed in auto/ folder.
Please use them with caution and inspect the changes they make.