Feat/reserve branche

README.md

@@ -1,91 +1,62 @@
-# [Minimal Mistakes Jekyll theme](https://mmistakes.github.io/minimal-mistakes/)
+# Personal Blog on Minimal Mistakes
 
-[![LICENSE](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/DiogoRibeiro7/DiogoRibeiro7.github.io/master/LICENSE)
+[![LICENSE](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![Hosted with GH Pages](https://img.shields.io/badge/Hosted_with-GitHub_Pages-blue?logo=github&logoColor=white)](https://pages.github.com/)
 [![Made with GH Actions](https://img.shields.io/badge/CI-GitHub_Actions-blue?logo=github-actions&logoColor=white)](https://github.com/features/actions)
 
-[![Jekyll](https://img.shields.io/badge/jekyll-%3E%3D%204.3-blue.svg)](https://jekyllrb.com/)
+This repository contains the source code for my website built with the
+[Minimal Mistakes](https://mmistakes.github.io/minimal-mistakes/) Jekyll theme.
+It also includes a few helper scripts to clean up Markdown front matter and
+run tests.
 
-[![Ruby Version](https://img.shields.io/badge/ruby-3.1-blue)](https://www.ruby-lang.org)
-[![Ruby gem](https://img.shields.io/gem/v/minimal-mistakes-jekyll.svg)](https://rubygems.org/gems/minimal-mistakes-jekyll)
+## Requirements
 
-
-Minimal Mistakes is a flexible two-column Jekyll theme, perfect for building personal sites, blogs, and portfolios. As the name implies, styling is purposely minimalistic to be enhanced and customized by you :smile:.
-
-## Setup
-
-This repository contains a few helper scripts for processing Markdown posts.
-Install the Python dependencies listed in `requirements.txt` with:
+The site relies on Ruby, Node and Python tooling.  Install dependencies with:
 
 ```bash
+# Python packages for helper scripts and tests
 pip install -r requirements.txt
-```
 
-To work with the JavaScript that powers the theme you'll also need Node
-dependencies. Install them with:
-
-```bash
+# JavaScript dependencies
 npm install
-```
-
-This project uses **npm** for managing JavaScript dependencies and tracks
-exact versions in `package-lock.json`.
-
-Bundled JavaScript is compiled from the source files in `assets/js/`. Run the
-following to create `main.min.js` (minified with a banner) or watch for changes:
-
-```bash
-npm run build:js   # minify and add banner
-npm run watch:js   # optional: automatically rebuild on changes
-```
-
-## CSS linting
-
-Lint all SCSS files with [Stylelint](https://stylelint.io/):
 
-```bash
-npm run lint:css
+# Ruby gems for Jekyll
+bundle install
 ```
 
-## Local development
+## Development
 
-Install Ruby gems specified in the `Gemfile` with:
+Use the following commands while working on the site:
 
 ```bash
-bundle install
-```
+# start a local server at http://localhost:4000/
+bundle exec jekyll serve
 
-Serve the site locally with:
+# rebuild JavaScript when files change
+npm run watch:js
 
-```bash
-bundle exec jekyll serve
+# lint stylesheets
+npm run lint:css
 ```
 
+## Tests
 
-## Running tests
-
-Install the Python dependencies and execute:
+Front matter utilities are covered by a small `pytest` suite.  Run the tests with:
 
 ```bash
 pytest
 ```
-GitHub Actions already runs these commands automatically during deployments.
-
-# ToDo
-
-~~Have a consistency in the font and font sizes (ideally you want to use 2 fonts. One for the header/subtitle and one for the text. You can use this kind of website https://fontjoy.com/ which allow you to pair fonts).~~
-
-Choose a few main colours for your site (I would suggest black/white/grey but not in solid. You can also use this kind of site: https://coolors.co/palettes/popular/2a4849).
 
-~~Reduce then size of the homepage top image (ideally you want your first articles to be visible on load and not hidden below the fold).~~
+GitHub Actions executes the same tests on every push.
 
-~~Restyle your links (ideally the link should be back with no underline and you add a css style on hover)~~
+## Roadmap
 
-~~Center pagination~~
+Planned improvements are organised as sprints in [ROADMAP.md](ROADMAP.md).
+Highlights include:
 
-~~Restyle your article detail page breadcrumbs. You want them to be less visible (I would suggest a light grey colour here)~~
+- refining typography and the colour palette
+- restructuring the homepage with card‑style articles
+- adding search and dark mode
+- optimising performance and accessibility
 
-Right now at the top of the detail page, you have your site breadcrumbs, a title then another title and the font sizes are a bit off and it is hard to understand the role of the second title. I would reorganise this to provide a better understanding to the reader
-On the detail page, I would suggest you put the `You may also enjoy` straight at the end of the article. Right now it is after comments and you can lose engagement on your site.
-I would suggest you remove your description from the detail page. I think having it on the home page is enough. You can have a smaller introduction if needed with a read more button or link that will take the reader to a full page description of yourself and your skillset. That will allow you to tell more about yourself and why you do what you do
-I will create card article with a hover animation (add some shape and background colour and ideally a header image for the card. The graphs you show me last week for example.)
+Contributions are welcome!

_config.yml

@@ -86,7 +86,7 @@ facebook:
   username               :
   app_id                 :
   publisher              :
-og_image                 : # Open Graph/Twitter default site image
+og_image                 : /assets/images/data-science.png
 # For specifying social profiles
 # - https://developers.google.com/structured-data/customize/social-profiles
 social:
@@ -196,7 +196,7 @@ exclude:
   - Rakefile
   - README
   - tmp
-  - /docs # ignore Minimal Mistakes /docs
+  # - /docs # ignore Minimal Mistakes /docs
   - /test # ignore Minimal Mistakes /test
 keep_files:
   - .git

_data/navigation.yml

@@ -19,4 +19,6 @@ main:
   # - title: "Sitemap"
   #   url: /sitemap/
   - title: "Code Download"
-    url: /code/
+    url: /code/
+  - title: "Package Docs"
+    url: /docs/

_includes/archive-single.html

@@ -11,12 +11,12 @@
 {% endif %}
 
 <div class="{{ include.type | default: 'list' }}__item">
-  <article class="archive__item" itemscope itemtype="https://schema.org/CreativeWork">
-    {% if include.type == "grid" and teaser %}
-      <div class="archive__item-teaser">
-        <a href="{{ post.url | relative_url }}"><img src="{{ teaser | relative_url }}" alt="{{ post.title }}"></a>
-      </div>
-    {% endif %}
+  <article class="archive__item card" itemscope itemtype="https://schema.org/CreativeWork">
+{% if teaser %}
+  <div class="archive__item-teaser">
+    <a href="{{ post.url | relative_url }}"><img src="{{ teaser | relative_url }}" alt="{{ post.title }}"></a>
+  </div>
+{% endif %}
     <h2 class="archive__item-title no_toc" itemprop="headline">
       {% if post.link %}
         <a href="{{ post.link }}">{{ title }}</a> <a href="{{ post.url | relative_url }}" rel="permalink"><i class="fas fa-link" aria-hidden="true" title="permalink"></i><span class="sr-only">Permalink</span></a>

_includes/head.html

@@ -20,7 +20,7 @@
 <!-- Google Fonts -->
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-<link href="https://fonts.googleapis.com/css2?family=Lora:wght@400;700&family=Roboto:wght@400;700&display=swap" rel="stylesheet">
+<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;700&family=Nunito+Sans:wght@400;700&display=swap" rel="stylesheet">
 
 {% if site.head_scripts %}
   {% for script in site.head_scripts %}

_includes/page__hero.html

@@ -23,16 +23,16 @@
 >
   {% if page.header.overlay_color or page.header.overlay_image %}
     <div class="wrapper">
-      <!-- <h1 id="page-title" class="page__title" itemprop="headline">
+      <h1 id="page-title" class="page__title" itemprop="headline">
         {% if paginator and site.paginate_show_page_num %}
           {{ site.title }}{% unless paginator.page == 1 %} {{ site.data.ui-text[site.locale].page | default: "Page" }} {{ paginator.page }}{% endunless %}
         {% else %}
           {{ page.title | default: site.title | markdownify | remove: "<p>" | remove: "</p>" }}
         {% endif %}
-      </h1> -->
+      </h1>
       {% if page.tagline %}
         <p class="page__lead">{{ page.tagline | markdownify | remove: "<p>" | remove: "</p>" }}</p>
-      {% elsif page.header.show_overlay_excerpt != false and page.excerpt %}
+      {% elsif page.header.show_overlay_excerpt != false and page.excerpt and page.collection != 'posts' %}
         <p class="page__lead">{{ page.excerpt | markdownify | remove: "<p>" | remove: "</p>" }}</p>
       {% endif %}
       {% include page__meta.html %}

_layouts/single.html

@@ -22,10 +22,12 @@
   {% include sidebar.html %}
 
   <article class="page h-entry" itemscope itemtype="https://schema.org/CreativeWork">
+    {% unless page.header.overlay_color or page.header.overlay_image %}
     {% if page.title %}<h1 id="page-title" class="page__title p-name" itemprop="headline">
       <a href="{{ page.url | absolute_url }}" class="u-url" itemprop="url">{{ page.title | markdownify | remove: "
         <p>" | remove: "</p>" }}</a>
     </h1>{% endif %}
+    {% endunless %}
     {% if page.subtitle %}<h2 class="page__subtitle">{{ page.subtitle }}</h2>{% endif %}
 
     {% if page.excerpt %}
@@ -108,4 +110,4 @@ <h2 class="page__related-title">{{ site.data.ui-text[site.locale].related_label
   {% if jekyll.environment == 'production' and site.comments.provider and page.comments %}
   {% include comments.html %}
   {% endif %}
-</div>
+</div>

_pages/code-download.md

@@ -0,0 +1,29 @@
+---
+layout: single
+title: "Code Download"
+permalink: /code/
+author_profile: true
+---
+
+This page provides convenient links to code examples referenced throughout the blog. The full source for this website, including these examples, is available on [GitHub](https://github.com/DiogoRibeiro7/DiogoRibeiro7.github.io).
+
+## Individual files
+
+You can download specific files directly from the repository:
+
+- [Michelson–Morley experiment visualization]({{ '/code/michelson_morley.py' | relative_url }})
+- [Example notebook]({{ '/code/Untitled.ipynb' | relative_url }})
+
+## Repository download
+
+If you would like to obtain the entire collection of examples, clone the repository using Git or grab the automatic ZIP archive:
+
+```bash
+git clone https://github.com/DiogoRibeiro7/DiogoRibeiro7.github.io.git
+```
+
+Or visit [the GitHub project page](https://github.com/DiogoRibeiro7/DiogoRibeiro7.github.io) and use **Download ZIP**.
+
+---
+
+Feel free to reach out at [[email protected]](mailto:[email protected]) for professional enquiries or [[email protected]](mailto:[email protected]) for personal matters. My ORCID is [0009-0001-2022-7072](https://orcid.org/0009-0001-2022-7072) and I’m affiliated with **ESMAD - Instituto Politécnico do Porto**.

_pages/package-docs.md

@@ -0,0 +1,16 @@
+---
+layout: single
+title: "Package Documentation"
+permalink: /docs/
+author_profile: true
+---
+
+This page collects links to documentation for the packages I maintain. When available, documentation is hosted online. Otherwise it will be stored directly in this repository.
+
+## Packages
+
+- [**frontmatter**]({{ '/docs/frontmatter/' | relative_url }})
+
+---
+
+Feel free to reach out at [[email protected]](mailto:[email protected]) for professional enquiries or [[email protected]](mailto:[email protected]) for personal matters. My ORCID is [0009-0001-2022-7072](https://orcid.org/0009-0001-2022-7072) and I’m affiliated with **ESMAD - Instituto Politécnico do Porto**.

_posts/2020-11-05-probability_theory_basics.md

@@ -4,7 +4,8 @@ categories:
 - Statistics
 classes: wide
 date: '2020-11-05'
-excerpt: An introduction to probability theory concepts every data scientist should know.
+excerpt: An introduction to probability theory concepts every data scientist should
+  know.
 header:
   image: /assets/images/data_science_10.jpg
   og_image: /assets/images/data_science_10.jpg
@@ -17,15 +18,17 @@ keywords:
 - Random variables
 - Distributions
 - Data science
-seo_description: Learn the core principles of probability theory, from random variables to common distributions, with practical examples for data science.
-seo_title: 'Probability Theory Basics for Data Science'
+seo_description: Learn the core principles of probability theory, from random variables
+  to common distributions, with practical examples for data science.
+seo_title: Probability Theory Basics for Data Science
 seo_type: article
-summary: This post reviews essential probability concepts like random variables, expectation, and common distributions, illustrating how they underpin data science workflows.
+summary: This post reviews essential probability concepts like random variables, expectation,
+  and common distributions, illustrating how they underpin data science workflows.
 tags:
 - Probability
 - Statistics
 - Data science
-title: 'Probability Theory Basics for Data Science'
+title: Probability Theory Basics for Data Science
 ---
 
 Probability theory provides the mathematical foundation for modeling uncertainty. By understanding random variables and probability distributions, data scientists can quantify risks and make informed decisions.

_posts/2020-11-10-simple_linear_regression_intro.md

@@ -4,7 +4,8 @@ categories:
 - Data Science
 classes: wide
 date: '2020-11-10'
-excerpt: Understand how simple linear regression models the relationship between two variables using a single predictor.
+excerpt: Understand how simple linear regression models the relationship between two
+  variables using a single predictor.
 header:
   image: /assets/images/data_science_11.jpg
   og_image: /assets/images/data_science_11.jpg
@@ -16,15 +17,17 @@ keywords:
 - Linear regression
 - Least squares
 - Data analysis
-seo_description: Discover the mechanics of simple linear regression and how to interpret slope and intercept when fitting a straight line to data.
-seo_title: 'A Primer on Simple Linear Regression'
+seo_description: Discover the mechanics of simple linear regression and how to interpret
+  slope and intercept when fitting a straight line to data.
+seo_title: A Primer on Simple Linear Regression
 seo_type: article
-summary: This article introduces simple linear regression and the least squares method, showing how a single predictor explains variation in a response variable.
+summary: This article introduces simple linear regression and the least squares method,
+  showing how a single predictor explains variation in a response variable.
 tags:
 - Regression
 - Statistics
 - Data science
-title: 'A Primer on Simple Linear Regression'
+title: A Primer on Simple Linear Regression
 ---
 
 Simple linear regression is a foundational technique for modeling the relationship between a predictor variable and a response variable. By fitting a straight line, we can quantify how changes in one variable are associated with changes in another.

_posts/2020-11-20-bayesian_inference_basics.md

@@ -4,7 +4,8 @@ categories:
 - Statistics
 classes: wide
 date: '2020-11-20'
-excerpt: Explore the fundamentals of Bayesian inference and how prior beliefs combine with data to form posterior conclusions.
+excerpt: Explore the fundamentals of Bayesian inference and how prior beliefs combine
+  with data to form posterior conclusions.
 header:
   image: /assets/images/data_science_12.jpg
   og_image: /assets/images/data_science_12.jpg
@@ -17,15 +18,17 @@ keywords:
 - Priors
 - Posterior distributions
 - Data science
-seo_description: An overview of Bayesian inference, demonstrating how to update prior beliefs with new evidence to make data-driven decisions.
-seo_title: 'Bayesian Inference Explained'
+seo_description: An overview of Bayesian inference, demonstrating how to update prior
+  beliefs with new evidence to make data-driven decisions.
+seo_title: Bayesian Inference Explained
 seo_type: article
-summary: Learn how Bayesian inference updates prior beliefs into posterior distributions, providing a flexible framework for reasoning under uncertainty.
+summary: Learn how Bayesian inference updates prior beliefs into posterior distributions,
+  providing a flexible framework for reasoning under uncertainty.
 tags:
 - Bayesian
 - Inference
 - Statistics
-title: 'Bayesian Inference Explained'
+title: Bayesian Inference Explained
 ---
 
 Bayesian inference offers a powerful perspective on probability, treating unknown quantities as distributions that update when new evidence appears.

_posts/2020-11-25-hypothesis_testing_real_world_applications.md

@@ -4,7 +4,8 @@ categories:
 - Statistics
 classes: wide
 date: '2020-11-25'
-excerpt: See how hypothesis testing helps draw meaningful conclusions from data in practical scenarios.
+excerpt: See how hypothesis testing helps draw meaningful conclusions from data in
+  practical scenarios.
 header:
   image: /assets/images/data_science_13.jpg
   og_image: /assets/images/data_science_13.jpg
@@ -17,15 +18,18 @@ keywords:
 - P-values
 - Significance
 - Data science
-seo_description: Learn how to apply hypothesis tests in real-world analyses and avoid common pitfalls when interpreting p-values and confidence levels.
-seo_title: 'Applying Hypothesis Testing in the Real World'
+seo_description: Learn how to apply hypothesis tests in real-world analyses and avoid
+  common pitfalls when interpreting p-values and confidence levels.
+seo_title: Applying Hypothesis Testing in the Real World
 seo_type: article
-summary: This post walks through frequentist hypothesis testing, showing how to formulate null and alternative hypotheses and interpret the results in practical data science tasks.
+summary: This post walks through frequentist hypothesis testing, showing how to formulate
+  null and alternative hypotheses and interpret the results in practical data science
+  tasks.
 tags:
 - Hypothesis testing
 - Statistics
 - Experiments
-title: 'Applying Hypothesis Testing in the Real World'
+title: Applying Hypothesis Testing in the Real World
 ---
 
 Hypothesis testing allows data scientists to objectively assess whether an observed pattern is likely due to chance or reflects a genuine effect.