File Management

Publishing Tasks: Phase 1 Submission

File Management

---

Contents of this page:

• 1. Markdown files
• 2. Images
• 3. Assets

---

Lesson materials are saved in the following directories on ph-submissions:

1. Markdown files

EN:

/en
/en/drafts
/en/drafts/originals
/en/drafts/translations
/en/published
/en/published/originals
/en/published/translations

ES:

/es
/es/borradores
/es/borradores/originales
/es/borradores/traducciones
/es/publicadas
/es/publicadas/originales
/es/publicadas/traducciones

FR:

/fr
/fr/en-cours
/fr/en-cours/originales
/fr/en-cours/traductions
/fr/publiees
/fr/publiees/originales
/fr/publiees/traductions

PT:

/pt
/pt/esbocos
/pt/esbocos/originais
/pt/esbocos/traducoes
/pt/publicadas
/pt/publicadas/originais
/pt/publicadas/traducoes

2. Images

As part of our commitment to global accessibility, we keep content on our site 'light' to avoid slow-loading for readers with lower internet speeds or less computing power. We've agreed on a maximum image size of 840 pixels on the longest edge.

Originals

• Create an images directory named to match the lesson-slug exactly
• Note of the order of images in the lesson, rename each one in sequence following our Image Naming Conventions
• Check image sizes, resize if necessary (max. 840px on longest edge)
• Upload directory to /images
• Return to the Markdown file, update filenames in liquid syntax as necessary

Translations

• Navigate to the original lesson's /images directory (named to match the original-lesson-slug)
• Note any new images created for the translation, rename each one in sequence following our Image Naming Conventions
• Check any new image sizes, resize if necessary (max. 840px on longest edge)
• Upload new images to the original lesson's /images directory
• Return to the Markdown file, update filenames in liquid syntax as necessary

3. Assets

Sub-directories should be named to match the lesson-file-name (slug:) exactly.

/assets