Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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: 6 additions & 0 deletions .agents/docs/playbooks/add-blog-post.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,12 @@ that directory as a post.
3. **To add a new `type` value**, extend the enum in `config.ts` _and_ add the matching key to
`apps/outreach/src/i18n/translations/blog.json`. The badge renders `t('blog.<type>')`, so
without the key it shows the raw key.
4. **To translate a post, give the translation its own filename in its language and set
`translationOf` to the original's filename without `.md`.** Set it on the translation only:
`getPublishedAltPost()` in `apps/outreach/src/lib/blog.ts` pairs the two from that one field and
fails the build if it names no post, if a post would pair with more than one other, or if both
are in the same language. Without it, the language toggle on either post goes to the other
language's blog index instead of the translation.

## Traps

Expand Down
4 changes: 2 additions & 2 deletions apps/outreach/src/components/blog/PostInfoCard.astro
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ type Props = {
};

const { author, datePublished, readingTime, className } = Astro.props;
const { resolvedLanguage } = useTranslations(Astro.url);
const { resolvedLanguage, t } = useTranslations(Astro.url);
---

<div class:list={['flex items-center', className]}>
Expand All @@ -33,7 +33,7 @@ const { resolvedLanguage } = useTranslations(Astro.url);
}
</time>
<span aria-hidden="true">&middot;</span>
<span>{Math.round(readingTime)} min read</span>
<span>{`${Math.round(readingTime)} ${t('blog.minRead')}`}</span>
</div>
</div>
</div>
8 changes: 7 additions & 1 deletion apps/outreach/src/components/layout/Footer.astro
Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@
---
import { useTranslations } from '@/i18n';

const { t } = useTranslations(Astro.url);
---

<footer class="bg-white py-4 text-sm shadow-sm dark:bg-slate-800">
<div class="text-muted-foreground container hidden items-center justify-center gap-2 sm:flex">
<a class="hover:text-foreground" href="https://douglasneuroinformatics.ca/" target="_blank" rel="noreferrer">
Expand All @@ -14,7 +20,7 @@
</a>
<span>&#183;</span>
<a class="hover:text-foreground" href="https://playground.opendatacapture.org" target="_blank" rel="noreferrer">
Instrument Playground
{t('common.instrumentPlayground')}
</a>
</div>
<p class="text-muted-foreground mt-1.5 text-center">
Expand Down
7 changes: 6 additions & 1 deletion apps/outreach/src/components/layout/Header.astro
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,11 @@ import SiteTitle from '../common/SiteTitle.astro';
import MenuIcon from '../icons/MenuIcon.astro';
import XMarkIcon from '../icons/XMarkIcon.astro';

type Props = {
altURL?: URL;
};

const { altURL } = Astro.props;
const { t, translatePath } = useTranslations(Astro.url);

const navLinks = [
Expand Down Expand Up @@ -47,7 +52,7 @@ const navLinks = [
<div class="mx-5 h-8 w-px rounded-md bg-slate-300 dark:bg-slate-700"></div>
<div class="flex grow justify-end gap-3">
<ThemeToggle />
<LanguageToggle />
<LanguageToggle altURL={altURL} />
</div>
</div>
<button class="flex h-10 items-center md:hidden [&>svg]:h-full [&>svg]:w-auto" id="nav-toggle" type="button">
Expand Down
12 changes: 9 additions & 3 deletions apps/outreach/src/components/layout/LanguageToggle.astro
Original file line number Diff line number Diff line change
@@ -1,7 +1,13 @@
---
import { useTranslations } from '../../i18n';

const { t, resolvedLanguage } = useTranslations(Astro.url);
type Props = {
altURL?: URL;
};

const translations = useTranslations(Astro.url);
const { altURL = translations.altURL } = Astro.props;
const { t, resolvedLanguage } = translations;

const is404 = /^\/404\/?$/.test(Astro.url.pathname);
---
Expand Down Expand Up @@ -32,13 +38,13 @@ const is404 = /^\/404\/?$/.test(Astro.url.pathname);
>
<a
class="block cursor-pointer p-2 text-center uppercase first:rounded-t-md last:rounded-b-md hover:backdrop-brightness-95 dark:hover:backdrop-brightness-150"
href={new URL(Astro.url.href.replace(`/${resolvedLanguage}`, `/en`))}
href={resolvedLanguage === 'en' ? Astro.url : altURL}
>
en
</a>
<a
class="block cursor-pointer p-2 text-center uppercase first:rounded-t-md last:rounded-b-md hover:backdrop-brightness-95 dark:hover:backdrop-brightness-150"
href={new URL(Astro.url.href.replace(`/${resolvedLanguage}`, `/fr`))}
href={resolvedLanguage === 'fr' ? Astro.url : altURL}
>
fr
</a>
Expand Down
1 change: 1 addition & 0 deletions apps/outreach/src/content/config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ export const collections = {
isDraft: z.boolean().optional(),
language: z.enum(['en', 'fr']),
title: z.string().min(1),
translationOf: reference('blog').optional(),
type: z.enum(['article', 'caseStudy', 'video'])
})
}),
Expand Down
4 changes: 4 additions & 0 deletions apps/outreach/src/i18n/translations/blog.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,10 @@
"en": "Our Blog",
"fr": "Notre blogue"
},
"minRead": {
"en": "min read",
"fr": "min de lecture"
},
"title": {
"en": "Blog",
"fr": "Blogue"
Expand Down
25 changes: 20 additions & 5 deletions apps/outreach/src/i18n/translations/common.json
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,18 @@
"en": "Change Theme",
"fr": "Changer le thème"
},
"docs": "Docs",
"docs": {
"en": "Docs",
"fr": "Documentation"
},
"faq": {
"en": "FAQ",
"fr": "FAQ"
},
"instrumentPlayground": {
"en": "Instrument Playground",
"fr": "Bac à sable d'instruments"
},
"noContent": {
"en": "There is no content here at the moment",
"fr": "Il n'y a pas de contenu ici pour le moment"
Expand All @@ -20,14 +31,18 @@
"en": "Overview",
"fr": "Accueil"
},
"pageNotFound": {
"en": "Not Found",
"fr": "Page introuvable"
},
"pageNotFoundHint": {
"en": "Please verify the URL or use the navigation menu above to find what you're looking for.",
"fr": "Veuillez vérifier l'URL ou utiliser le menu de navigation ci-dessus pour trouver ce que vous cherchez."
},
"team": {
"en": "Team",
"fr": "L'équipe"
},
"faq": {
"en": "FAQ",
"fr": "FAQ"
},
"viewAltLangPrefix": {
"en": "You can also view our",
"fr": "Vous pouvez également consulter notre"
Expand Down
5 changes: 3 additions & 2 deletions apps/outreach/src/layouts/Page.astro
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ import { cn } from '@/utils';
import '@/styles/main.css';

type Props = {
altURL?: URL;
bilingual?: boolean;
hasDefaultLocaleRedirect?: boolean;
className?: string;
Expand All @@ -18,14 +19,14 @@ type Props = {
};

const { resolvedLanguage } = useTranslations(Astro.url);
const { className, ...props } = Astro.props;
const { altURL, className, ...props } = Astro.props;
---

<!doctype html>
<html lang={resolvedLanguage}>
<Head {...props} />
<body class="flex min-h-screen flex-col">
<Header />
<Header altURL={altURL} />
<main class={cn('container grow py-16', className)}>
<slot />
</main>
Expand Down
32 changes: 31 additions & 1 deletion apps/outreach/src/lib/blog.ts
Original file line number Diff line number Diff line change
@@ -1,12 +1,42 @@
import { getCollection } from 'astro:content';
import { getCollection, getEntry } from 'astro:content';
import type { CollectionEntry } from 'astro:content';

type BlogLanguage = CollectionEntry<'blog'>['data']['language'];

async function getOriginal(post: CollectionEntry<'blog'>): Promise<CollectionEntry<'blog'> | undefined> {
const { translationOf } = post.data;
if (!translationOf) {
return undefined;
}
const original = await getEntry(translationOf);
if (!original) {
throw new Error(`Blog post '${post.slug}' is a translation of '${translationOf.id}', which does not exist`);
}
return original;
}

/**
* The blog posts that are not drafts, optionally in one language. Every page that reads the blog
* collection goes through this, so a draft is neither built at its URL nor listed in the sitemap.
*/
export async function getPublishedPosts(language?: BlogLanguage): Promise<CollectionEntry<'blog'>[]> {
return getCollection('blog', ({ data }) => !data.isDraft && (language === undefined || data.language === language));
}

export async function getPublishedAltPost(post: CollectionEntry<'blog'>): Promise<CollectionEntry<'blog'> | undefined> {
const posts = await getPublishedPosts();
const [original, originals] = await Promise.all([getOriginal(post), Promise.all(posts.map(getOriginal))]);
const altPosts = posts.filter((candidate, index) => {
return candidate.id === original?.id || originals[index]?.id === post.id;
});
if (altPosts.length > 1) {
throw new Error(
`Blog post '${post.slug}' is paired with more than one post: ${altPosts.map(({ slug }) => slug).join(', ')}`
);
}
const altPost = altPosts.at(0);
if (altPost?.data.language === post.data.language) {
throw new Error(`Blog post '${post.slug}' and its pair '${altPost.slug}' are both in '${post.data.language}'`);
}
return altPost;
}
21 changes: 17 additions & 4 deletions apps/outreach/src/pages/404.astro
Original file line number Diff line number Diff line change
@@ -1,10 +1,23 @@
---
import Page from '@/layouts/Page.astro';
import { type Language, useTranslations } from '@/i18n';

const languages: Language[] = ['en', 'fr'];
---

<Page className="flex flex-col items-center justify-center">
<h1 class="text-3xl font-extrabold tracking-tight sm:text-4xl md:text-5xl">404 - Not Found</h1>
<p class="text-muted-foreground mt-2 max-w-prose text-center text-sm sm:text-base">
Please verify the URL or use the navigation menu above to find what you're looking for.
</p>
<h1 class="text-3xl font-extrabold tracking-tight sm:text-4xl md:text-5xl">404</h1>
{
languages.map((language) => {
const { t } = useTranslations(new URL(`/${language}/`, Astro.url));
return (
<div class="mt-6 flex flex-col items-center" lang={language}>
<h2 class="text-xl font-bold tracking-tight sm:text-2xl">{t('common.pageNotFound')}</h2>
<p class="text-muted-foreground mt-2 max-w-prose text-center text-sm sm:text-base">
{t('common.pageNotFoundHint')}
</p>
</div>
);
})
}
</Page>
16 changes: 10 additions & 6 deletions apps/outreach/src/pages/[locale]/blog/[slug].astro
Original file line number Diff line number Diff line change
Expand Up @@ -3,34 +3,38 @@ import Page from '@/layouts/Page.astro';
import { type CollectionEntry, getEntry } from 'astro:content';
import PostInfoCard from '@/components/blog/PostInfoCard.astro';
import PageHeading from '@/components/common/PageHeading.astro';
import { getPublishedPosts } from '@/lib/blog';
import { useTranslations } from '@/i18n';
import { getPublishedAltPost, getPublishedPosts } from '@/lib/blog';

type Props = {
post: CollectionEntry<'blog'>;
altPost: CollectionEntry<'blog'> | undefined;
};

export const getStaticPaths = async () => {
const posts = await getPublishedPosts();

const paths = posts.map((post) => ({
const paths = posts.map(async (post) => ({
params: {
locale: post.data.language,
slug: post.slug
},
props: { post }
props: { altPost: await getPublishedAltPost(post), post }
}));

return paths;
return Promise.all(paths);
};

const { post } = Astro.props;
const { altPost, post } = Astro.props;
const { altLanguage } = useTranslations(Astro.url);
const altURL = new URL(`/${altLanguage}/blog/${altPost?.slug ?? ''}`, Astro.url);

const { Content, remarkPluginFrontmatter } = await post.render();

const author = await getEntry(post.data.author);
---

<Page meta={{ title: post.data.title, description: post.data.description }}>
<Page altURL={altURL} meta={{ title: post.data.title, description: post.data.description }}>
<article class="prose prose-slate dark:prose-invert relative mx-auto max-w-3xl pt-8">
<PageHeading className="pb-0 text-left" title={post.data.title} />
<PostInfoCard
Expand Down
35 changes: 35 additions & 0 deletions blog/adopter-de-bonnes-conventions-de-nommage.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
type: article
title: 'Adopter de bonnes conventions de nommage pour les données médicales'
description: 'Découvrez le rôle essentiel des conventions de nommage normalisées dans la gestion des données de santé, et comment les plateformes numériques modernes facilitent leur respect pour assurer la clarté, l’exactitude et la conformité tout en favorisant l’efficacité et l’interopérabilité.'
author: weijie-tan
language: fr
translationOf: follow-good-naming-conventions
datePublished: 2024-02-19
---

Une gestion efficace des données médicales est essentielle pour offrir des soins de qualité et mener des recherches pertinentes. Le respect de conventions de nommage normalisées est au cœur de cette démarche. Dans cet article, nous examinons l'importance des conventions de nommage normalisées dans la gestion des données médicales, et la façon dont les plateformes numériques modernes soutiennent cet aspect crucial des activités en santé.

## Clarté et compréhension

Des conventions de nommage claires et cohérentes jouent un rôle déterminant pour faciliter la compréhension entre professionnels de la santé. Dans les environnements médicaux complexes, une communication précise est primordiale pour assurer l'exactitude des diagnostics, des traitements et des soins aux patients. Des ambiguïtés ou des incohérences dans l'étiquetage des données peuvent entraîner des malentendus et des erreurs dans la prise de décision clinique, d'où la nécessité de conventions de nommage claires et normalisées pour garantir une interprétation juste des données médicales.

## Exactitude et fiabilité

Des données bien nommées sont indispensables pour maintenir l'exactitude et la fiabilité des dossiers médicaux et des résultats de recherche. Des étiquettes inexactes ou trompeuses peuvent compromettre la sécurité des patients, entraver la recherche clinique et miner l'intégrité des systèmes de santé. Les conventions de nommage normalisées réduisent le risque de mauvaise interprétation ou de désinformation, ce qui appuie la prise de décision fondée sur des données probantes et améliore les résultats pour les patients.

## Interopérabilité et intégration

Les conventions de nommage normalisées favorisent l'interopérabilité entre des systèmes de santé disparates et facilitent l'intégration harmonieuse de sources de données diverses. Dans le paysage interconnecté actuel de la santé, la capacité d'échanger et d'intégrer des données provenant de sources variées est essentielle aux soins globaux des patients, à la recherche clinique et aux initiatives de gestion de la santé des populations. En respectant des conventions de nommage normalisées, les organisations de santé peuvent surmonter les défis d'interopérabilité et exploiter pleinement le potentiel des technologies de l'information en santé pour offrir des soins coordonnés et centrés sur le patient.

## Conformité réglementaire et sécurité des données

Le respect de conventions de nommage normalisées est impératif pour la conformité réglementaire, en particulier au regard de règlements stricts sur la protection et la sécurité des données comme la HIPAA. Le respect des exigences réglementaires assure la protection de la vie privée des patients, la confidentialité et la sécurité des données, en préservant les renseignements médicaux sensibles contre l'accès, la divulgation ou l'utilisation non autorisés. Les conventions de nommage normalisées contribuent à des cadres de gouvernance des données qui favorisent la responsabilisation, la transparence et une gestion éthique des données de santé, ce qui préserve la confiance des patients et des parties prenantes envers les organisations de santé.

## Efficacité et cohérence

Les plateformes modernes de saisie numérique de données simplifient les processus de gestion des données grâce à l'automatisation, en offrant des gabarits, des contrôles de validation et des interfaces utilisateur intuitives. En intégrant des conventions de nommage normalisées à ces plateformes, les organisations de santé peuvent améliorer l'efficacité et la cohérence de la saisie des données, tout en réduisant les erreurs, les redondances et les écarts. De plus, les conventions de nommage normalisées facilitent la récupération, l'analyse et la communication des données, ce qui permet aux professionnels de la santé d'en tirer des constats concrets et de mener des initiatives d'amélioration continue de la qualité tout au long du continuum de soins.

## Conclusion

Les conventions de nommage normalisées sont indispensables pour assurer la clarté, l'exactitude, l'interopérabilité, la conformité réglementaire et l'efficacité dans la gestion des données médicales. En respectant ces conventions et en tirant parti des plateformes numériques modernes pour les faire appliquer, les organisations de santé peuvent optimiser la qualité des données, appuyer la prise de décision fondée sur des données probantes et, ultimement, améliorer la qualité des soins aux patients et des résultats de recherche. Faire des conventions de nommage normalisées un pilier de la gouvernance des données favorise une culture d'excellence, d'intégrité et d'innovation dans la prestation des soins et dans les pratiques de recherche. Les organismes sans but lucratif, comme la [Douglas Neuroinformatics Platform](https://douglasneuroinformatics.ca/), peuvent jouer un rôle important dans ce processus.
Loading
Loading