Extended markdown syntax is not recognized correctly

General Questions
1

I am using MDC (Nuxt Content), which is a superset of markdown, and the parts of it that are embedded in components are not recognized correctly and are sometimes included in the source string. Its syntax is like this:

Plain paragraph

:::tip

Paragraphs inside the "tip" component

:::

I have made the proper line breaks and made adjustments so that the identifier of the component is recognized by Crowdin as a “paragraph”, but it is still included in the source string.

image
image940×335 23.2 KB

Is there a way to safely exclude certain strings from the translation while maintaining line breaks? I am hoping to gain some insights. Thank you in advance!

Crowdin project url: Misskey Hub dashboard in Crowdin

1 Like
2

Hi @kakkokari-gtyih,

Thank you for the detailed explanation! I already passed it on to our developers for deeper investigation.

We will get back to you once we will have any updates on the matter,

2 Likes
3

I just checked Crowdin’s project again, and to make matters worse, I found that the text in the translations in the markdown file was all out of alignment :frowning:

1 Like
4

Hi there!

Have you tried to upload file in the mdx format?
Also, our developers asked, could you please share the example of file you try to upload?

Looking forward to your reply!

1 Like
5

Hi, sorry for late reply.

This is the previous version of the source file:

---
ignoreDirBasedNav: true
description: 'Misskeyに぀いおのドキュメントです。'
---

# Misskeyに぀いお
Misskeyはオヌプン゜ヌスの分散型マむクロブログプラットフォヌムプロゞェクトです。
開発は日本でsyuiloによっお2014幎から開始されたした。
ドラむブ、リアクションなどの豊富な機胜や、高いカスタマむズ性を備えたUIを持぀こずが特城です。

## 歎史
開発圓初は掲瀺板がメむンのサヌビスでしたが、ナヌザヌが短文を投皿し、それを時系列で流れるタむムラむン機胜を远加したずころ人気が高たり、埐々にそれがメむンずしお開発が進むようになりたした。
圓初は分散型ではありたせんでしたが、2018幎にActivityPubを実装し分散型になったこずで、より倚くの方に認知され利甚されるサヌビスになり、珟圚に至りたす。

:::tip
Misskeyずいう名前は、syuiloが圓時聎いおいたMay'nずいうアヌティストの楜曲、Brain Diverの歌詞に由来したす。
:::

誰でも開発に参加するこずができ、珟圚でも掻発に開発が続いおいたす。

## 分散型ずは䜕か
<b>分散(distributed)型</b>ずは、<b>非䞭倮集暩(decentralized)</b>ずも呌ばれ、コミュニティが倚数のサヌバヌに分散しお存圚し、それらが盞互に<b>通信(連合、federation)</b>するこずでコンテンツ共有<b>ネットワヌク(Fediverse)</b>を圢成しおいるこずが特城のサヌビスです。
単䞀のサヌバヌしか存圚しない、もしくは耇数存圚しおも互いに独立しおいる堎合は䞭倮集暩なサヌビスず蚀われ、䟋えばTwitterやFacebookなどほずんどのサヌビスがそれに該圓したす。
分散型のメリットは、自分に合った運営者やテヌマのサヌバヌを遞択できるこずです。自分でサヌバヌを䜜成するこずもできたす。連合するおかげで、どのサヌバヌを遞んでも、同じコミュニティにアクセスできたす。

## 垞にオヌプン゜ヌス
Misskeyはこれたでもこれからも、オヌプン゜ヌスであり続けたす。オヌプン゜ヌスずは、簡単に蚀うず<b>゜フトりェアの゜ヌスコヌド(プログラム)が公開されおいる</b>こずです。゜ヌスコヌドの修正や再配垃が可胜であるこずを定矩に含めるこずもありたす。
Misskeyのすべおの゜ヌスコヌドは[AGPL](https://github.com/misskey-dev/misskey/blob/develop/LICENSE)ずいうオヌプン゜ヌスラむセンスの䞋に[公開](https://github.com/misskey-dev)されおいお、誰でも自由に閲芧、䜿甚、修正、改倉、再配垃をするこずができたす。
オヌプン゜ヌスは、自分で奜きなように倉えたり、有害な凊理が含たれおいないこずを確認するこずができたり、誰でも開発に参加できるなどの、様々なメリットがありたす。
䞊述の分散型を実珟するためにも、オヌプン゜ヌスであるずいうこずは必芁䞍可欠な芁玠です。
再び匕き合いに出したすが、TwitterやFacebookなどの利益を埗おいるほずんどのサヌビスはオヌプン゜ヌスではありたせん。

:::tip
技術的に蚀うず、Misskeyの゜ヌスコヌドはGitで管理されおいお、リポゞトリは[GitHub䞊でホスティングされおいたす。](https://github.com/misskey-dev)
:::

## 開発に参加する、プロゞェクトを支揎する
Misskeyを気に入っおいただけたら、ぜひプロゞェクトを支揎しおください。プロゞェクトに貢献するには、以䞋で玹介するようにいろいろな方法がありたす。方法によっおは開発のスキルは䞍芁なので、誰でも気軜に参加し貢献するこずができたす。い぀でもお埅ちしおいたす。

### 機胜を远加したり、バグを修正する
゜フトりェア゚ンゞニアのスキルをお持ちの方であれば、゜ヌスコヌドを線集する圢でプロゞェクトに貢献するこずができたす。
貢献に぀いおのガむドは[こちら](https://github.com/misskey-dev/misskey/blob/develop/CONTRIBUTING.md)です。

### 議論に参加する
新しい機胜、たたは既存の機胜に぀いお意芋を述べたり、䞍具合を報告したりするこずでも貢献できたす。
そのようなディスカッションは[GitHub](https://github.com/misskey-dev)䞊か、[フォヌラム](https://forum.misskey.io/)等で行われたす。

### テキストを翻蚳する
Misskeyは様々な蚀語に察応しおいたす(i18n -internationalizationの略- ず呌ばれたす)。元の蚀語は基本的に日本語ですが、有志によっお他の蚀語ぞず翻蚳されおいたす。
その翻蚳䜜業に加わっおいただくこずでもMisskeyに貢献できたす。
Misskeyは[Crowdinずいうサヌビスを䜿甚しお翻蚳の管理を行っおいたす。](https://crowdin.com/project/misskey)

### 感想を投皿する
䞍具合報告等だけではなく、Misskeyの良い点、楜しい点ずいったポゞティブな意芋もぜひ共有しおください。開発の励みになり、それは間接的ですがプロゞェクトぞの貢献です。

### ミスキストを増やす
ミスキストずは、Misskeyを䜿甚する人のこずです。
知り合いに玹介するなどしおMisskeyを広めおいただければ、ミスキストが増え開発のモチベヌションが䞊がりたす。

### 寄付をする
[こちらをご芧ください](/docs/for-users/resources/donate/)

## よくある質問

### プロゞェクトは䜕を目指しおいたすか

匷いお蚀うず、挠然的になりたすが広く䜿われる汎甚的なプラットフォヌムになるこずを目指しおいたす。
Misskeyは他のプロゞェクトずは違い、䜕らかの思想(䟋えば、反䞭倮集暩)やビゞョンに基づいお開発が行われおいるわけではなく、その点ではフラットです。
それが逆に、特定の方向性に瞛られないフレキシブルさを生み出すこずに繋がっおいるず感じおいたす。
<!-- TODO: ここにロヌドマップぞのリンク -->

### 䌁業によっお開発されおいたすか
いいえ。Misskeyの開発は個人で行われおおり、商業的でもないため、特定の䌁業の関りはありたせん。
開発メンバヌも基本的にはボランティアです。
たた、開発に察し䌁業のスポンサヌが぀くこずもありたすが、その堎合でもやはり開発は個人のコミュニティが䞻䜓です。

### 誰が運営しおいたすか
Misskeyは分散型なため、各サヌバヌにそれぞれ異なった運営者がいたす。埓っお、特定の個人や䌁業によっお、Misskeyの党おが運営されおいるわけではありたせん。
たた、開発チヌムが運営を行うわけでもないため、運営に関する連絡は、お䜿いのサヌバヌの運営者に行っおください。
サヌバヌの運営者は、サヌバヌの情報ペヌゞで確認するこずができたす。
あなたがサヌバヌを䜜成すれば、あなたが運営者になりたす。

### どのサヌバヌを遞べばいいですか
[サヌバヌ䞀芧が公開されおいたす。](/servers/)
サヌバヌによっおコミュニティのテヌマ(特定のこず、ものが奜き 等)が決められおいる堎合があるので、自分に合ったテヌマのサヌバヌがあれば、そこを遞ぶず良いかもしれたせん。
他にも、サヌバヌの芏暡、ナヌザヌ局、囜および蚀語、運営者が信頌できるかどうか、などの芳点がありたす。
なお、Misskey公匏のサヌバヌずいうものはありたせん。自身で新しくサヌバヌを䜜成するずいう遞択肢もありたす。
基本的にどのサヌバヌを遞んだずしおも、他の党おのサヌバヌのナヌザヌず繋がるこずができたす。

### サヌバヌを建おるにはどうしたらいいですか
Misskeyサヌバヌの䜜成に興味を持っおいただきありがずうございたす。
2022幎珟圚、Misskeyのホスティングサヌビスは存圚しないため、サヌバヌの䜜成にはある皋床の知識が必芁です。
サヌバヌの䜜成方法に぀いおは[こちら](/docs/for-admin/install/)をご芧ください。

### どのような技術を䜿甚しおいたすか
Misskeyは開発が進むに぀れ䜿甚する技術も倧きく倉わっおきたした。開発圓初はMySQL + PHP + jQueryずいった構成でしたが、珟圚は以䞋のようになっおいたす。

- サヌバヌサむド: Node.js
- デヌタベヌス: PostgreSQL、Redis
- UIフレヌムワヌク: Vue.js
- プログラミング蚀語: TypeScript

たた、MFMやAiScriptなどの、Misskeyから掟生しお独自の技術も開発しおいたす。

### Mastodonのフォヌクですか

いいえ。MisskeyはMastodonやその他のプロゞェクトずは党く別のプロゞェクトです。
開発に関しおも、Misskeyの方が昔から開発されおいたす。ただし、分散型になったのはMastodonの登堎より埌です。
同じActivityPubずいう分散のためのプロトコルを実装しおいるずいう点以倖、䞡者に特に関りがあるわけでもありたせん。

### iOS/Androidのアプリはありたすか

公匏にはそういったOSのネむティブアプリを開発しおいたせんが、サヌドパヌティ補のアプリがいく぀かありたす。
詳しくは[こちら](/docs/for-users/resources/apps/)をご芧ください。
ただ、サヌドパヌティ補アプリはどうしおも機胜ぞの察応が遅れおしたうため、ずくに拘りがなければ公匏のWebクラむアントの利甚をおすすめしたす。
なお、MisskeyのWebクラむアントはPWAに察応しおいるので、ネむティブアプリのように動䜜させるこずも可胜です。

### Misskeyのロゎ、アむコンはどこで入手できたすか

[こちら](/brand-assets/)

### 時折目にする猫耳の可愛い女の子は

:::fukidashi{chara="doya_ai" charaName="藍"}
私のこずですねMisskeyのマスコットキャラクタヌずしお、粟䞀杯あなたをサポヌトさせおいただきたす♪
わたしに぀いおは[このホヌムペヌゞ](https://xn--931a.moe/)をご芧ください
:::
:::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"}
Misskeyの守り神、藍ちゃんです。!
:::

And I changed ::: block part to avoid including as translation string:

---
ignoreDirBasedNav: true
description: 'Misskeyに぀いおのドキュメントです。'
---

# Misskeyに぀いお

Misskeyはオヌプン゜ヌスの分散型マむクロブログプラットフォヌムプロゞェクトです。
開発は日本でsyuiloによっお2014幎から開始されたした。
ドラむブ、リアクションなどの豊富な機胜や、高いカスタマむズ性を備えたUIを持぀こずが特城です。

## 歎史

開発圓初は掲瀺板がメむンのサヌビスでしたが、ナヌザヌが短文を投皿し、それを時系列で流れるタむムラむン機胜を远加したずころ人気が高たり、埐々にそれがメむンずしお開発が進むようになりたした。
圓初は分散型ではありたせんでしたが、2018幎にActivityPubを実装し分散型になったこずで、より倚くの方に認知され利甚されるサヌビスになり、珟圚に至りたす。

:::tip

Misskeyずいう名前は、syuiloが圓時聎いおいたMay'nずいうアヌティストの楜曲、Brain Diverの歌詞に由来したす。

:::

誰でも開発に参加するこずができ、珟圚でも掻発に開発が続いおいたす。

## 分散型ずは䜕か

<b>分散(distributed)型</b>ずは、<b>非䞭倮集暩(decentralized)</b>ずも呌ばれ、コミュニティが倚数のサヌバヌに分散しお存圚し、それらが盞互に<b>通信(連合、federation)</b>するこずでコンテンツ共有<b>ネットワヌク(Fediverse)</b>を圢成しおいるこずが特城のサヌビスです。
単䞀のサヌバヌしか存圚しない、もしくは耇数存圚しおも互いに独立しおいる堎合は䞭倮集暩なサヌビスず蚀われ、䟋えばTwitterやFacebookなどほずんどのサヌビスがそれに該圓したす。
分散型のメリットは、自分に合った運営者やテヌマのサヌバヌを遞択できるこずです。自分でサヌバヌを䜜成するこずもできたす。連合するおかげで、どのサヌバヌを遞んでも、同じコミュニティにアクセスできたす。

## 垞にオヌプン゜ヌス

Misskeyはこれたでもこれからも、オヌプン゜ヌスであり続けたす。オヌプン゜ヌスずは、簡単に蚀うず<b>゜フトりェアの゜ヌスコヌド(プログラム)が公開されおいる</b>こずです。゜ヌスコヌドの修正や再配垃が可胜であるこずを定矩に含めるこずもありたす。
Misskeyのすべおの゜ヌスコヌドは[AGPL](https://github.com/misskey-dev/misskey/blob/develop/LICENSE)ずいうオヌプン゜ヌスラむセンスの䞋に[公開](https://github.com/misskey-dev)されおいお、誰でも自由に閲芧、䜿甚、修正、改倉、再配垃をするこずができたす。
オヌプン゜ヌスは、自分で奜きなように倉えたり、有害な凊理が含たれおいないこずを確認するこずができたり、誰でも開発に参加できるなどの、様々なメリットがありたす。
䞊述の分散型を実珟するためにも、オヌプン゜ヌスであるずいうこずは必芁䞍可欠な芁玠です。
再び匕き合いに出したすが、TwitterやFacebookなどの利益を埗おいるほずんどのサヌビスはオヌプン゜ヌスではありたせん。

:::tip

技術的に蚀うず、Misskeyの゜ヌスコヌドはGitで管理されおいお、リポゞトリは[GitHub䞊でホスティングされおいたす。](https://github.com/misskey-dev)

:::

## 開発に参加する、プロゞェクトを支揎する

Misskeyを気に入っおいただけたら、ぜひプロゞェクトを支揎しおください。プロゞェクトに貢献するには、以䞋で玹介するようにいろいろな方法がありたす。方法によっおは開発のスキルは䞍芁なので、誰でも気軜に参加し貢献するこずができたす。い぀でもお埅ちしおいたす。

### 機胜を远加したり、バグを修正する

゜フトりェア゚ンゞニアのスキルをお持ちの方であれば、゜ヌスコヌドを線集する圢でプロゞェクトに貢献するこずができたす。
貢献に぀いおのガむドは[こちら](https://github.com/misskey-dev/misskey/blob/develop/CONTRIBUTING.md)です。

### 議論に参加する

新しい機胜、たたは既存の機胜に぀いお意芋を述べたり、䞍具合を報告したりするこずでも貢献できたす。
そのようなディスカッションは[GitHub](https://github.com/misskey-dev)䞊か、[フォヌラム](https://forum.misskey.io/)等で行われたす。

### テキストを翻蚳する

Misskeyは様々な蚀語に察応しおいたす(i18n -internationalizationの略- ず呌ばれたす)。元の蚀語は基本的に日本語ですが、有志によっお他の蚀語ぞず翻蚳されおいたす。
その翻蚳䜜業に加わっおいただくこずでもMisskeyに貢献できたす。
Misskeyは[Crowdinずいうサヌビスを䜿甚しお翻蚳の管理を行っおいたす。](https://crowdin.com/project/misskey)

### 感想を投皿する

䞍具合報告等だけではなく、Misskeyの良い点、楜しい点ずいったポゞティブな意芋もぜひ共有しおください。開発の励みになり、それは間接的ですがプロゞェクトぞの貢献です。

### ミスキストを増やす

ミスキストずは、Misskeyを䜿甚する人のこずです。
知り合いに玹介するなどしおMisskeyを広めおいただければ、ミスキストが増え開発のモチベヌションが䞊がりたす。

### 寄付をする

[こちらをご芧ください](/docs/for-users/resources/donate/)

## よくある質問

### プロゞェクトは䜕を目指しおいたすか

匷いお蚀うず、挠然的になりたすが広く䜿われる汎甚的なプラットフォヌムになるこずを目指しおいたす。
Misskeyは他のプロゞェクトずは違い、䜕らかの思想(䟋えば、反䞭倮集暩)やビゞョンに基づいお開発が行われおいるわけではなく、その点ではフラットです。
それが逆に、特定の方向性に瞛られないフレキシブルさを生み出すこずに繋がっおいるず感じおいたす。
<!-- TODO: ここにロヌドマップぞのリンク -->

### 䌁業によっお開発されおいたすか

いいえ。Misskeyの開発は個人で行われおおり、商業的でもないため、特定の䌁業の関りはありたせん。
開発メンバヌも基本的にはボランティアです。
たた、開発に察し䌁業のスポンサヌが぀くこずもありたすが、その堎合でもやはり開発は個人のコミュニティが䞻䜓です。

### 誰が運営しおいたすか

Misskeyは分散型なため、各サヌバヌにそれぞれ異なった運営者がいたす。埓っお、特定の個人や䌁業によっお、Misskeyの党おが運営されおいるわけではありたせん。
たた、開発チヌムが運営を行うわけでもないため、運営に関する連絡は、お䜿いのサヌバヌの運営者に行っおください。
サヌバヌの運営者は、サヌバヌの情報ペヌゞで確認するこずができたす。
あなたがサヌバヌを䜜成すれば、あなたが運営者になりたす。

### どのサヌバヌを遞べばいいですか

[サヌバヌ䞀芧が公開されおいたす。](/servers/)
サヌバヌによっおコミュニティのテヌマ(特定のこず、ものが奜き 等)が決められおいる堎合があるので、自分に合ったテヌマのサヌバヌがあれば、そこを遞ぶず良いかもしれたせん。
他にも、サヌバヌの芏暡、ナヌザヌ局、囜および蚀語、運営者が信頌できるかどうか、などの芳点がありたす。
なお、Misskey公匏のサヌバヌずいうものはありたせん。自身で新しくサヌバヌを䜜成するずいう遞択肢もありたす。
基本的にどのサヌバヌを遞んだずしおも、他の党おのサヌバヌのナヌザヌず繋がるこずができたす。

### サヌバヌを建おるにはどうしたらいいですか

Misskeyサヌバヌの䜜成に興味を持っおいただきありがずうございたす。
2022幎珟圚、Misskeyのホスティングサヌビスは存圚しないため、サヌバヌの䜜成にはある皋床の知識が必芁です。
サヌバヌの䜜成方法に぀いおは[こちら](/docs/for-admin/install/)をご芧ください。

### どのような技術を䜿甚しおいたすか

Misskeyは開発が進むに぀れ䜿甚する技術も倧きく倉わっおきたした。開発圓初はMySQL + PHP + jQueryずいった構成でしたが、珟圚は以䞋のようになっおいたす。
- サヌバヌサむド: Node.js
- デヌタベヌス: PostgreSQL、Redis
- UIフレヌムワヌク: Vue.js
- プログラミング蚀語: TypeScript
たた、MFMやAiScriptなどの、Misskeyから掟生しお独自の技術も開発しおいたす。

### Mastodonのフォヌクですか

いいえ。MisskeyはMastodonやその他のプロゞェクトずは党く別のプロゞェクトです。
開発に関しおも、Misskeyの方が昔から開発されおいたす。ただし、分散型になったのはMastodonの登堎より埌です。
同じActivityPubずいう分散のためのプロトコルを実装しおいるずいう点以倖、䞡者に特に関りがあるわけでもありたせん。

### iOS/Androidのアプリはありたすか

公匏にはそういったOSのネむティブアプリを開発しおいたせんが、サヌドパヌティ補のアプリがいく぀かありたす。
詳しくは[こちら](/docs/for-users/resources/apps/)をご芧ください。
ただ、サヌドパヌティ補アプリはどうしおも機胜ぞの察応が遅れおしたうため、ずくに拘りがなければ公匏のWebクラむアントの利甚をおすすめしたす。
なお、MisskeyのWebクラむアントはPWAに察応しおいるので、ネむティブアプリのように動䜜させるこずも可胜です。

### Misskeyのロゎ、アむコンはどこで入手できたすか

[こちら](/brand-assets/)

### 時折目にする猫耳の可愛い女の子は

:::fukidashi{chara="doya_ai" charaName="藍"}

私のこずですねMisskeyのマスコットキャラクタヌずしお、粟䞀杯あなたをサポヌトさせおいただきたす♪
わたしに぀いおは[このホヌムペヌゞ](https://xn--931a.moe/)をご芧ください

:::

:::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"}

Misskeyの守り神、藍ちゃんです。!

:::

After this change, there is indeed no more ::: in the translation string, but all the translation strings are shifted one by one. After manually modifying every files in all languages, pushing it to Github repo, and importing the translations from Github using the Github integration into Crowdin, the translations were still recognized as they were before and the modifications could not be applied correctly.

(I am assuming that this happened because the previous translations were recorded and bound by position and those have shifted. Is there a way to import translations from Github with the markdown strings unbound to the existing translations on Crowdin?)

It’s getting a little complicated, is there any way to resolve this? Thank you!

1 Like
6

Hi @kakkokari-gtyih,

Thank you a lot for providing the details,

Our team is investigating the issue with the markdown syntax,

As for your question, do you mean that you have the correct version of translations in Crowdin and translations that are on your repo are shifted? Sorry, I might misunderstood you a bit here.

You remove the translations on your repo and then with the next sync the corrected translations will be pushed to your repo.

1 Like
7

Hi @kakkokari-gtyih , our devs informed that now MDC components should be recognized correctly, you’re welcome to check on your side

8

I followed your instructions and was able to resolve the translation shift! Thank you very much :pray:

9

Okay, I’ll check that out later.

Thank you for implementing MDC format! It should be very helpful for Nuxt developers :heart: