/wowchemy-rtic-website

New and improved RTIC website, published using Wowchemy and Netlify

Primary LanguageTeXMIT LicenseMIT

RTIC website using wowchemy

Made using wowchemy, deployed using github and netlify. No-code alternative to website building.

Find this website on https://rtic-ucl.netlify.app

This version of an RTIC test website uses the same software as the POND and MANIFOLD LAB groups at UCL.

To edit this "research group" template, explore the "contents" folder, as all the files in this folder are contents that show in the corresponding page of the website. The preview looks like a table, and when the edit button is clicked, the file looks like markdown (simple text file). Change any text or image links directly on the document (remember to upload image to "assets/media/" first).

An exception to this are the personal profiles, which are edited in the "authors" folder in github, but that show up in the "people" page of the website.

For further information, visit the wowchemy documentation: https://wowchemy.com/docs/

How to add a new person profile

  1. Go to rtic-ucl/wowchemy-rtic-website/content/authors Go to rtic-ucl/wowchemy-rtic-website/ repository in github then click content Click authors Authors folder This is the authors folder, where information of group members is stored. It is then displayed to the website via the people widget (../content/people/people.md).

  2. Create a new file, and call it "<person's name>/_index.md". In this example, "Firstname Lastname/_index.md" IMPORTANT: name the folder using the person's name in lowercase letters and with a hyphens instead of spaces to avoid broken urls. So it would be firstname-lastname (the example in the image is wrong). The slash (/) will automatically create a folder called <person's name> with a file called _index.md in that folder. Click add file, a dropdown menu will appear Click Create new file in the dropdown Write person's name in file name input Still in the file name input, write a slash and the _index.md, and it will create a folder

  3. Then, copy the _index.md file from a different person's folder to use as a template. Add contents from another person's _index.md into the file

  4. Replace the name in the title: field to the display name for the person you want to make a profile for. Display name means that this is the name that actually appears on the website, although this is usually the same as the folder name. Pronouns can be added here as well (just type them after the name). The username "author: " field should be set to the same name as the folder name (still lowercase and with hyphens).

  5. The superuser sets the main/primary user of the site. For now, all people are set to superuser: false.

  6. The role: field is the displayed role which will appear below the person's name in their profile. This can be set to anything, even multiple roles or positions separated by commas. (e.g. role: Principal Investigator, Supervisor, Co-lead)

  7. The organisations list the different organisations that a person is part of. This will be useful for visitors and collaborators. Note that a link to the organisation's website must be provided in the "url: " field, but currently this is set to an empty field for all users because we have not yet made sure that this website adheres to UCL branding policies.

  8. Next, the bio: field is a few sentences which should appear at the end of blog posts/project pages where the person is set as author. Write person's name in file name input

  9. The interests: field is a list of interests which shows up below the person's name, social icons, and role. Simply list a few of the person's research interests, there is no restriction for this field.

  10. The education: field optionally lists some of the person's courses. In the courses: - course: field, add the course title and optionally the title of the thesis/dissertation as applicable. In the courses: institution: field, add the name of the university that awarded the degree (or universities if the degree was jointly awarded). In the couses: year: field, add the year of graduation/completion of that degree.

To add another degree, copy and paste the - course/institution:/year: bulletpoint such that the alignment is the same in both, and replace with the other course's information. (Note that for all existing author profiles, I added the most recent degrees at the top of the list.)

  1. For social and academic networking, replace the link with the link to that person's corresponding social media or academic profile. If a type of profile (e.g. twitter) is not used, comment it out by adding hashtags (# ) at the start of each line, or alternatively delete that whole - icon:/ icon_pack:/ link: bulletpoint. Social/academic networking This contents will appear as clickable icons below that person's name and role, which will open the corresponding link in a new tab.

To see which social media/academic icons are already available within the Wowchemy icon packs, and for more information about this widget, visit this link: https://wowchemy.com/docs/getting-started/page-builder/#icons.

  1. Optionally, it is possible to add a CV to your profile. To do this, uncomment the three - icon:/ icon_pack:/ link: lines by removing the hashtags (# ). Later, upload a copy of the person's CV under static/files/cv.pdf. Note that this has not yet been tested for any existing people profiles. CV, Gravatar, highlight name, user groups

  2. Gravatar is not enabled in "config", so leave the Gravatar "email: " field blank, or delete those two lines (62 and 63 in the image).

  3. Set highlight_name: to true if you want this author to be highlighted in author lists in blog posts or project pages. Note that no other profile currently have this feature enabled.

  4. The user_groups: field determines which title (or titles) this person will appear under in the people widget. If a person belongs to multiple user gorups, they will appear twice - once under each title coresponding to their user groups. To see the existing user groups in the "People" page of the website, go to "../content/people/people.md".

  5. Finally, anything under the three dashes (---) will appear in that person's personal page. Add as little or as much information as you like: for example, a biography, fun facts about that person, or details about theur research. This section is written in markdown, so titles, bold text, and italic text can be added if desired. (see https://wowchemy.com/docs/content/writing-markdown-latex/) Write biography under the three dashes (---)

  6. To publish this author profile, scroll down to "Commit new file" and click the green "Commit new file" button. At this point, the person's profile is published and should appear on the website within a few minutes. 🎉 Click on Commit new file button

Adding a profile picture

  1. To add a profile picture, open the person's author folder, e.g. "../content/authors/Firstname Lastname/". Click "Add File" and then "Upload Files". You should be taken to a new page that says "Drag files here to add them to your repository". Go back to person's folder, click on Add file, then click on Upload files in the drop-down menu Screenshot of page that says Drag files here to add them to your repository

  2. Find the person's profile picture in your files, or download it to your computer if you haven't already. Rename the file to "avatar.jpg" or "avatar.png" depending on the file type. Find person's picture in computer files Rename picture file to avatar.png or avatar.jpg

  3. Either drag the avatar file to the github upload page or click on the words "choose your file" in blue and choose the avatar file from your computer's files. Click choose your files and choose picture from computer files

  4. Scroll down and click "Commit changes" (green button). The picture should be uploaded to that person's author folder under the name "avatar.png" or "avatar.jpg". It should appear on the person's profile in the website within a few minutes. Click Commit changes button

How to add a new project page

  1. Go to "rtic-ucl/wowchemy-rtic-website/content/projects/". Click "Add file" and then "Create new file". Click content folder Click projects folder Click Add file and then Create new file in the drop down menu

  2. Type a project name in the naming field in the format "yyyy-mm-dd-keywords" for easy sorting. For example, "2023-03-25-example-project". Then, type a slash (/) to automatically create a folder, and type "index.md". Type project name in aforementioned format, then a slash to automatically create a folder Type index.md

  3. In this new file, copy and paste the contents from a different project to use as a template.

  4. The first field title: is the project's display name. Type it as you want it to appear on the website.

  5. Add the date in the date: field in the format "yyyy-mm-dd" (year first, then month, then date) for sorting purposes.

  6. In the authors: field, type a list of people in this project, using their usernames (lowercase with hyphen, like firstname-lastname). Their names will show up in the project page with a clickable link to their profile. The "author_notes: " field can include extra information about each respective author when hovering on their name. For example, - Supervisor. Authors, author notes, and project tags

  7. The tags: field is a list of tags which will appear below the project description the website. Add any keywords, for example - Dosimetry.

  8. profile: true enables author bios underneath the project descriptions. Profile and Image display settings

  9. The lines under image: affect the appearance of the project's features image. placement: affects the image width in the project page. Placement options: 1 = Full column width, 2 = Out-set, 3 = Screen-width. Defaults to 1, full column width. focal_point: affects how the image is cropped in the preview for smaller screens. Focal point options: Smart, Center, TopLeft, Top, TopRight, Left, Right, BottomLeft, Bottom, BottomRight. Set preview_only to true to just use the image for the thumbnail in the preview and not the actual project page. alt_text: sets alternative text for screen readers or for errors/poor connection when the image cannot be displayed.

  10. Everything under the three dashes (---) will appear as an extended description in the project page. But any sentences above the <!-- more --> tag will also appear in the preview. The paragraph(s) underneath can be formatted in markdown, click here for more formatting options. Extended description under the three dashes ---

  11. Finally, click the green "Commit new file" button, and the project page should be published to the website within a few minutes. 🎉 Scroll down and click Commit new file button

Adding a featured picture

  1. The "featured" picture is the picture that appears in the project preview, and also at the top of the project page if preview_only: is set to false. Find the project image in you computer files, and rename it to "featured.png", or "featured.jpg" depending on the file type. Find desired picture file in computer files Rename to featured.png or featured.jpg

  2. Go the the project's folder, created in step 2., and click "Add file" then "Upload new file". Click Add file in the corresponding project folder, then click Upload file in the drop down menu

  3. You will be taken to a new page that says "Drag files here to add them to your repository" in the centre (the upload page). Either drag and drop the "featured.png"/"featured.jpg" file to this page or click on "choose your files" to upload the picture to the repository. Either drag picture file to centre of upload page, or click blue text that says choose your files Choosing picture file from computer files

  4. Click "Commit changes" (green button), and the picture should appear in the project's page on the website within a few minutes. Click green button at the bottom of page that says Commit changes

Hugo Research Group Theme

Screenshot

The Research Group Template empowers your research group to easily create a beautiful website with a stunning homepage, news, academic publications, events, team profiles, and a contact form.

️Trusted by 250,000+ researchers, educators, and students. Highly customizable via the integrated no-code, widget-based Wowchemy page builder, making every site truly personalized ⭐⭐⭐⭐⭐

Get Started Discord
Twitter Follow

Easily write technical content with plain text Markdown, LaTeX math, diagrams, RMarkdown, or Jupyter, and import publications from BibTeX.

Check out the latest demo of what you'll get in less than 60 seconds, or view the showcase.

The integrated Wowchemy website builder and CMS makes it easy to create a beautiful website for free. Edit your site in the CMS (or your favorite editor), generate it with Hugo, and deploy with GitHub or Netlify. Customize anything on your site with widgets, light/dark themes, and language packs.

We ask you, humbly, to support this open source movement

Today we ask you to defend the open source independence of the Wowchemy website builder and themes 🐧

We're an open source movement that depends on your support to stay online and thriving, but 99.9% of our creators don't give; they simply look the other way.

❤️ Click here to become a GitHub Sponsor, unlocking awesome perks such as exclusive academic templates and widgets

Demo credits

Please replace the demo images with your own.