Skip to content

Commit 317f7f1

Browse files
committed
added 2 blog entries for reproducibility and workflow
1 parent 3a2f609 commit 317f7f1

File tree

3 files changed

+61
-16
lines changed

3 files changed

+61
-16
lines changed
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
title: Computo's publication workflow
3+
date: '2025-07-31'
4+
description: Diagram summarizing the publication workflow
5+
categories:
6+
- authors
7+
- reproducibility
8+
format:
9+
html:
10+
toc: true
11+
page-layout: article
12+
---
13+
14+
The Computo workflows provide a streamlined publishing pipeline for authors to submit and render Quarto articles directly on GitHub Pages without requiring technical expertise.
15+
16+
### Workflow Summary
17+
18+
![Computo Workflow Structure](/assets/img/2025-03-20-revised-github-process/workflow.svg){#fig-workflow width="100%"}
19+
20+
As illustrated in @fig-workflow, the publication process consists of two main phases:
21+
22+
1. **Environment Setup and Caching** (`global-env.yml`)
23+
- Detects and installs required dependencies (Python, R)
24+
- Caches the environment for faster subsequent runs
25+
- Customizable via `setup-env-ci.sh`
26+
2. **Rendering and Deployment** (`publish-render.yml`)
27+
- Renders Quarto documents to HTML
28+
- Publish the output to GitHub Pages
29+
- Customizable via `setup-render-ci.sh`
30+
31+
Authors only need to reference the main workflow file (`build.yml`) in their repository, which orchestrates these processes.
32+
33+
### Key Benefits
34+
35+
- **Simplified Process**: Authors need minimal GitHub Actions knowledge
36+
- **Optimized Performance**: Environment caching for faster builds
37+
- **Customization Points**: Two script entry points for custom configurations
38+
- **Automated Deployment**: Direct publishing to GitHub Pages
39+
40+
Authors simply use the `build.yml` workflow in their repository to trigger the complete process from environment setup to final publication.
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
title: Reproducing an existing paper published in Computo
3+
date: '2025-07-31'
4+
description: How to reproduce a published paper?
5+
categories:
6+
- authors
7+
- reproducibility
8+
format:
9+
html:
10+
toc: true
11+
page-layout: article
12+
---
13+
14+
Our publication workflow makes it very easy for anyone to reproduce a given paper. Consider for instance the paper <https://doi.org/10.57750/sfxn-1t05> associated with the Github repository [published-202412-giorgi-efficient][https://github.com/computorg/published-202412-giorgi-efficient]. You first need to clone the repository. Then you need to install Quarto and the Computo Quarto extension in the `published-202412-giorgi-efficient` folder that the cloning step made. Finally, you can render the document. In summary, you do that with the following commands:
15+
16+
```bash
17+
git clone https://github.com/computorg/published-202412-giorgi-efficient.git
18+
cd published-202412-giorgi-efficient
19+
quarto add computorg/computo-quarto-extension
20+
quarto render
21+
```

blog/3021-04-23-submission-process/index.qmd

Lines changed: 0 additions & 16 deletions
This file was deleted.

0 commit comments

Comments
 (0)