Skip to content

Commit

Permalink
fix(config): fixing retrieval of image assets in article
Browse files Browse the repository at this point in the history
  • Loading branch information
floragc-octo committed Apr 8, 2022
1 parent 87f58db commit 5a8777c
Show file tree
Hide file tree
Showing 7 changed files with 1,004 additions and 6 deletions.
8 changes: 8 additions & 0 deletions .eleventy.js
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
const syntaxHighlight = require("@11ty/eleventy-plugin-syntaxhighlight");
const {DateTime} = require("luxon");
const pageAssetsPlugin = require('eleventy-plugin-page-assets');

module.exports = function (eleventyConfig) {
// Copy the `css` directory to the output
Expand All @@ -12,6 +13,13 @@ module.exports = function (eleventyConfig) {
return DateTime.fromJSDate(value, {zone: 'utc'}).setLocale('fr').toLocaleString();
});

// Allow putting articles assets in article directories
eleventyConfig.addPlugin(pageAssetsPlugin, {
mode: "parse",
postsMatching: "cookbook/*/*.md",
});


// eleventy-plugin-syntaxhighlight
eleventyConfig.addPlugin(syntaxHighlight);
};
14 changes: 11 additions & 3 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,13 @@
# Quelques infos sur la contribution

## Initier votre article

1- Créer un dossier portant le nom de votre article dans `cookbook`
2- Créer dans ce dossier un fichier `index.md` en partant du template `template.md`
3- Editer votre fichier `index.md` :)
4- Lance l'app avec `npm run start` pour vérifier le rendu de ton article
## Le format du template d'article

### Le format du template d'article - le cartouche
Il est important de laisser les noms des attributs sur chaque ligne.
On ne modifie que ce qui vient après.
Expand Down Expand Up @@ -56,12 +64,12 @@ Le contenu doit respecter la syntaxe markdown
### Cas particulier des images
---

Les images sont stockées dans le dossier `assets/illustrations`.
Les images sont stockées dans le même dossier que le fichier md de l'article.

Pour y accéder après le build il faut placer l'image dans une balise ayant comme classe CSS `"illustration--centered"` et indiquer dans l'URL `/assets/illustrations` comme dans l'exemple ci-dessous:
Pour y accéder après le build il faut placer l'image dans une balise ayant comme classe CSS `"illustration--centered"` et indiquer dans l'URL `/` comme dans l'exemple ci-dessous:

```html
<p class="illustration--centered">
<img width="300px" src="/assets/illustrations/sticky-footer.png" alt="Ma description" >
<img width="300px" src="/sticky-footer.png" alt="Ma description" >
</p>
```
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ layout: layouts/cookbook.njk
Placer le footer en bas de l’écran lorsque le contenu du site n’est pas suffisant pour remplir tout le viewport, ou en dessous de la ligne de flottaison si le contenu du site est plus grand que le viewport.

<p class="illustration--centered">
<img width="300px" src="/assets/illustrations/sticky-footer.png" alt="Structure html header, content et footer">
<img width="300px" src="/sticky-footer.png" alt="Structure html header, content et footer">
</p>

## Recipe
Expand Down
File renamed without changes
File renamed without changes.
Loading

0 comments on commit 5a8777c

Please sign in to comment.