Skip to content

Commit f26053a

Browse files
committed
fix: preserve YAML front matter in Quarto GFM output and fail if quarto missing
Made-with: Cursor
1 parent 111745b commit f26053a

32 files changed

Lines changed: 265 additions & 177 deletions

File tree

.makim.yaml

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,12 @@ groups:
1919
2020
# 2) Convert .qmd blog posts to Markdown using Quarto
2121
# Run quarto render from inside each blog folder (Quarto rejects --output path).
22-
if command -v quarto >/dev/null 2>&1; then
23-
find "$SEARCH_DIR" -name "*.qmd" -exec sh -c \
24-
'dir=$(dirname "$0"); base=$(basename "$0" .qmd); (cd "$dir" && quarto render "$base.qmd" --to gfm)' {} \;
25-
else
26-
echo "[EE] Quarto is not available on PATH; .qmd files will not be rendered."
22+
if ! command -v quarto >/dev/null 2>&1; then
23+
echo "[EE] Quarto CLI is required but not found on PATH. Install it (e.g. conda install quarto) and retry."
2724
exit 1
2825
fi
26+
find "$SEARCH_DIR" -name "*.qmd" -exec sh -c \
27+
'dir=$(dirname "$0"); base=$(basename "$0" .qmd); (cd "$dir" && quarto render "$base.qmd" --to gfm)' {} \;
2928
3029
# 3) Remove console colors from generated md files
3130
find "$SEARCH_DIR" -name \

pages/blog/artbox-what-is-it-how-to-collaborete/index.qmd

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,9 @@ description: |
99
ArtBox is a tool set for handling multimedia files with a bunch of useful functions.
1010
thumbnail: "/header.jpg"
1111
template: "blog-post.html"
12+
format:
13+
gfm:
14+
variant: +yaml_metadata_block
1215
---
1316
# How to use it?
1417

pages/blog/avances-scicookie-grant-2024/index.qmd

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,9 @@ description: |
99
Descripción de las mejoras y tareas realizadas en SciCookie gracias a la subvención de la PSF.
1010
thumbnail: "/header.png"
1111
template: "blog-post.html"
12+
format:
13+
gfm:
14+
variant: +yaml_metadata_block
1215
---
1316

1417
Como mencionamos en el post anterior [SciCookie recibe nueva subvención de PSF para mejoras y crecimiento](https://opensciencelabs.org/blog/scicookie-recibe-nueva-subvencion-de-psf-para-mejoras-crecimiento/), en enero de 2024 la PSF aprobó nuestra solicitud de subvención. Esto nos ha permitido implementar una serie de mejoras significativas en SciCookie. A continuación, presentamos los avances y tareas realizadas.

pages/blog/console-based-representation-in-astx/index.qmd

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,9 @@ description: |
99
Recently, console-based AST representation was included in the ASTx framework. Such feature can enhance the debugging and analysis capabilities of ASTx, particularly in environments such as a pdb session. In this tutorial, we'll explore this new feature as well as the ASTx Graphviz visualization.
1010
thumbnail: "/header.png"
1111
template: "blog-post.html"
12+
format:
13+
gfm:
14+
variant: +yaml_metadata_block
1215
---
1316
# Introduction
1417

pages/blog/exploring-llama-2-a-paradigm-shift-in-large-language-models/index.qmd

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,9 @@ description: |
1919
performance and a commitment to ethical research practices.
2020
thumbnail: /header.png
2121
template: blog-post.html
22-
22+
format:
23+
gfm:
24+
variant: +yaml_metadata_block
2325
---
2426

2527

pages/blog/first-time-contributors/index.qmd

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,9 @@ description: |
99
First Time Contributors" refers to individuals making their initial foray into contributing to open-source projects within scientific laboratories. These newcomers bring diverse skills and fresh perspectives, enriching the collaborative environment. Embracing inclusivity and providing guidance fosters their engagement, leading to innovative solutions in open science.
1010
thumbnail: "/header.jpeg"
1111
template: "blog-post.html"
12+
format:
13+
gfm:
14+
variant: +yaml_metadata_block
1215
---
1316
Diving into project development can be overwhelming for beginners. A first-timers guide is key to navigate this unfamiliar terrain. From understanding basics to mastering tools, it'll help you contribute effectively. Join us as we explore how to get started in a development project!
1417

pages/blog/fqlearn-ternary-plot/index.qmd

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,9 @@ description: |
1313
1414
thumbnail: "/header.png"
1515
template: "blog-post.html"
16+
format:
17+
gfm:
18+
variant: +yaml_metadata_block
1619
---
1720

1821
<!-- # Plotting ternary phase diagrams for solving thermodynamics problems using fqlearn -->

pages/blog/fqlearn-visualizacion-datos/index.qmd

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,9 @@ description: |
1414
en las clases de McCabe-Thiele, y SteamTable.
1515
thumbnail: "/header.png"
1616
template: "blog-post.html"
17+
format:
18+
gfm:
19+
variant: +yaml_metadata_block
1720
---
1821

1922
<!-- # Explorando fqlearn: Potenciando el Análisis y Diseño de Procesos Termodinámicos -->

pages/blog/google-summer-of-code-week-4th-and-7th-midterm-evaluation/index.md

Lines changed: 54 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -1,84 +1,81 @@
1-
---
2-
title: "Google Summer of Code- Week 4th & 7th Midterm Evaluation"
3-
slug: google-summer-of-code-week-4th-and-7th-midterm-evaluation
4-
date: 2023-07-25
5-
authors: ["Ankit Kumar"]
6-
tags: [google summer of code, gsoc, open-source open-sciencelab]
7-
categories: [open-source, gsoc]
8-
description: |
9-
In this article, I will share the progress for Week 4th week to 7th week for my
10-
contribution to Open-science labs as a part of Google Summer of Code 2023.
11-
thumbnail: "/GSoC-Vertical.png"
12-
---
1+
# Google Summer of Code- Week 4th & 7th Midterm Evaluation
2+
Ankit Kumar
3+
2023-07-25
134

145
## Google Summer of Code- Week 4th & 7th Midterm Evaluation
156

16-
In this article, I will share the progress for Week 4th week to 7th week for my
17-
contribution to Open-science labs as a part of Google Summer of Code 2023.
7+
In this article, I will share the progress for Week 4th week to 7th week
8+
for my contribution to Open-science labs as a part of Google Summer of
9+
Code 2023.
1810

19-
<img src="GSoC-Vertical.png" width="400">
11+
<img src="GSoC-Vertical.png" width="400">
2012

21-
As my Google Summer of Code journey continued, I found myself faced with an
22-
exciting yet daunting task: implementing a whole new build-system as an option
23-
for templates in the esteemed Open-Science Lab. This endeavor demanded
24-
meticulous planning, unwavering dedication, and the exploration of various
25-
build-systems, including Maturin, Hatchling, Scikit-build, and `pybuild11`.
13+
As my Google Summer of Code journey continued, I found myself faced with
14+
an exciting yet daunting task: implementing a whole new build-system as
15+
an option for templates in the esteemed Open-Science Lab. This endeavor
16+
demanded meticulous planning, unwavering dedication, and the exploration
17+
of various build-systems, including Maturin, Hatchling, Scikit-build,
18+
and `pybuild11`.
2619

27-
In this period, I started working on to add support for `Maturin` build-system.
20+
In this period, I started working on to add support for `Maturin`
21+
build-system.
2822

2923
### Maturin
3024

31-
[**Maturin**]() was the first build-system I explored. Its unique approach of
32-
building Python bindings for Rust libraries intrigued me, and I wondered if it
33-
could provide a novel solution to the lab's needs. The seamless blending of
34-
Python and Rust offered the potential for unparalleled performance and memory
35-
efficiency in research projects. However, I faced a steep learning curve to
36-
master the intricacies of Rust and its integration with Python. Overcoming these
37-
challenges was a significant achievement, and I managed to create a functional
38-
prototype that demonstrated Maturin's potential to revolutionize the
39-
Open-Science Lab's workflow. My contribution to this issue is
25+
[**Maturin**]() was the first build-system I explored. Its unique
26+
approach of building Python bindings for Rust libraries intrigued me,
27+
and I wondered if it could provide a novel solution to the lab’s needs.
28+
The seamless blending of Python and Rust offered the potential for
29+
unparalleled performance and memory efficiency in research projects.
30+
However, I faced a steep learning curve to master the intricacies of
31+
Rust and its integration with Python. Overcoming these challenges was a
32+
significant achievement, and I managed to create a functional prototype
33+
that demonstrated Maturin’s potential to revolutionize the Open-Science
34+
Lab’s workflow. My contribution to this issue is
4035
[here](https://github.com/osl-incubator/scicookie/pull/152)
4136

42-
After merging this pull request, I started to add support for `Hatchling`
43-
build-system.
37+
After merging this pull request, I started to add support for
38+
`Hatchling` build-system.
4439

4540
### Hatchling
4641

47-
[**Hatchling**]() known for its user-friendly nature, was my next target. It
48-
promised to simplify the build and deployment processes, which could be
49-
particularly beneficial for newcomers to the lab and projects with
50-
straightforward requirements. Integrating Hatchling into the lab's ecosystem
51-
required thorough documentation and integration tests to ensure its smooth
52-
adoption. Overcoming initial hurdles, I was elated to see the positive response
53-
from the lab's community as they began adopting Hatchling for their projects. My
54-
contribution to this issue is
55-
[here](https://github.com/osl-incubator/scicookie/pull/144)
42+
[**Hatchling**]() known for its user-friendly nature, was my next
43+
target. It promised to simplify the build and deployment processes,
44+
which could be particularly beneficial for newcomers to the lab and
45+
projects with straightforward requirements. Integrating Hatchling into
46+
the lab’s ecosystem required thorough documentation and integration
47+
tests to ensure its smooth adoption. Overcoming initial hurdles, I was
48+
elated to see the positive response from the labs community as they
49+
began adopting Hatchling for their projects. My contribution to this
50+
issue is [here](https://github.com/osl-incubator/scicookie/pull/144)
5651

5752
After completetion of this issue, I jumped to a task to add support for
5853
`Scikit-Build-Core`.
5954

6055
### Scikit-build-core
6156

62-
[**Scikit-build-core**]() a cross-platform build-system, offered a robust option
63-
for integrating CPython extensions. While challenging to implement, I recognized
64-
its potential to support projects with complex native code dependencies. My
65-
experience with Scikit-build exposed me to advanced build and packaging
66-
concepts, and I was thrilled to see it complementing the existing build-systems
67-
in the lab, catering to a broader range of projects. My contribution to this
68-
issue is [here](https://github.com/osl-incubator/scicookie/pull/161)
57+
[**Scikit-build-core**]() a cross-platform build-system, offered a
58+
robust option for integrating CPython extensions. While challenging to
59+
implement, I recognized its potential to support projects with complex
60+
native code dependencies. My experience with Scikit-build exposed me to
61+
advanced build and packaging concepts, and I was thrilled to see it
62+
complementing the existing build-systems in the lab, catering to a
63+
broader range of projects. My contribution to this issue is
64+
[here](https://github.com/osl-incubator/scicookie/pull/161)
6965

7066
### Conclusions
7167

7268
In conclusion, my Google Summer of Code experience with implementing new
73-
build-systems for the Open-Science Lab was a transformative journey. Overcoming
74-
hurdles with Maturin, embracing user-friendliness with Hatchling, exploring the
75-
potential of Scikit-build.I realized the importance of innovation and
76-
adaptability in the world of open-source development. This experience has not
77-
only enriched my technical skills but also instilled in me a passion for
78-
contributing to projects that drive positive change in the world of scientific
79-
research. As I look to the future, I am excited to continue this journey,
80-
collaborating with the open-source community to create solutions that empower
81-
researchers and advance the boundaries of knowledge.
69+
build-systems for the Open-Science Lab was a transformative journey.
70+
Overcoming hurdles with Maturin, embracing user-friendliness with
71+
Hatchling, exploring the potential of Scikit-build.I realized the
72+
importance of innovation and adaptability in the world of open-source
73+
development. This experience has not only enriched my technical skills
74+
but also instilled in me a passion for contributing to projects that
75+
drive positive change in the world of scientific research. As I look to
76+
the future, I am excited to continue this journey, collaborating with
77+
the open-source community to create solutions that empower researchers
78+
and advance the boundaries of knowledge.
8279

8380
You can read my previous blog [here](https://medium.com/@ayeankit)
8481

pages/blog/google-summer-of-code-week-4th-and-7th-midterm-evaluation/index.qmd

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,9 @@ description: |
99
In this article, I will share the progress for Week 4th week to 7th week for my
1010
contribution to Open-science labs as a part of Google Summer of Code 2023.
1111
thumbnail: "/GSoC-Vertical.png"
12+
format:
13+
gfm:
14+
variant: +yaml_metadata_block
1215
---
1316

1417
## Google Summer of Code- Week 4th & 7th Midterm Evaluation

0 commit comments

Comments
 (0)