Skip to content

Some minor changes #61

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jchiquet merged 1 commit into from
Dec 19, 2025
Merged

Some minor changes #61

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions site/guidelines-authors.qmd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ This document provides a comprehensive documentation to accompany the authors du
- **Writing Your Contribution**:
- Main content goes in `template-computo-LANG.qmd`.
- Metadata (title, authors, abstract, etc.) is set in `_quarto.yml`.
- Edit using any text editor or IDE (VS Code/RStudio recommended).
- Edit using any text editor or IDE (VS Code/RStudio/Positron recommended).

- **Dependencies**:
- Freeze package versions for reproducibility.
Expand Down Expand Up @@ -153,7 +153,7 @@ quarto add computorg/computo-quarto-extension
If you are collaborating with others when writing your contributions, **each collaborator** needs to perform these same three steps (clone the repository, install Quarto and install the Computo Quarto extension).
:::

::: {.callout-tip title="Multiple languages"}
::: {.callout-tip title="Multiple programming languages"}
Quarto relies on a specific engine to compile your document. By default, that engine detects code blocks, executes them and paste the result below the code block in the rendered document.

It is possible to use multiple languages within the same document (e.g. R and Python or Python and Julia, etc.) provided that you use the **knitr** engine. Indeed, [**knitr**](https://yihui.org/knitr/) is an R package that is able to parse code blocks from many languages. This can be achieved by specifying `engine: knitr` in your document metadata. The default engine binding that Quarto uses is detailed here: <https://quarto.org/docs/computations/execution-options.html#engine-binding>.
Expand All @@ -174,7 +174,7 @@ There are mainly two files you are expected to modify in your repository for wri

::: {.callout-tip}
## Editing your project
You can edit your project using any text editor, but we recommend using an IDE such as [vsCode](https://code.visualstudio.com/) or [RStudio](https://posit.co/download/rstudio-desktop/). These IDEs provide syntax highlighting, code completion, and other features that make editing Quarto files easier.
You can edit your project using any text editor, but we recommend using an IDE such as [VS Code](https://code.visualstudio.com/), [RStudio](https://posit.co/download/rstudio-desktop/) or, even better, [Positron](https://positron.posit.co/download.html). These IDEs provide syntax highlighting, code completion, and other features that make editing Quarto files easier.
:::

#### Metadata of your contribution
Expand Down