javascript-tutorial / javascript-tutorial/tr.javascript.info

Markdown Biçimleri (Bilgilendirme)

未關閉
#171 0 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視
主要語言
HTML
星號
367
分支
114
PR 合併指標
30 天內沒有已合併 PR

描述

Merhaba, depoda markdown (`.md`) dosyalarında yaptığım hızlı bir inceleme sonrasında bir çok dosyada biçimlendirme problemleri olduğunu gözlemledim. Markdown dosyası yazımında kullandığım [markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint) adında bir VS Code eklentisi var. Ayrıca bu [repoda](https://github.com/DavidAnson/markdownlint) kurallar da yer alıyor.

Markdown kaynak dosyalarının da okunabilirliği tıpkı diğer tüm bilgisayar dillerinin okunabilirliği kadar önemli.

Bunun yanında original dosya (İngilizce versiyon) ile bazı karşılaştırmalar yaptım. Burada emin olmak istediğim bu hataların İngilizce versiyonda olup olmadığıydı. İngilizce versiyonlar genellikle format olarak doğru. Aşağıdaki resimde solda İngilizce ve sağda ilk çevrilmiş Türkçe versiyon var. Dosya `1-js/01-getting-started/2-manuals-specifications/article.md`. MD022 kuralı ihlali İngilizce versiyonda yok.

![image](https://user-images.githubusercontent.com/1656836/105614275-76f53580-5dd9-11eb-99fa-cf00b6bc075b.png)

Bu noktada öncelikle format sorunlarının minimum'a indirilmesi gerektiğini düşündüğümden tipo ve anlam bozukluklarından önce format üzerinde çalışmalar yapacağım.

貢獻指南

這個儲存庫沒有索引到貢獻指南

研究方向

從 1-js/01-getting-started/2-manuals-specifications/article.md 開始,將其與英文版本進行比較,並使用連結的 markdownlint 規則來識別格式違規。以相同方式檢查其他土耳其文 Markdown 檔案;完成的標準是修正 MD022 等格式問題,而拼字和意義修正不在範圍內。

由索引模型根據 Issue 內容生成。

評估

技術堆疊
markdown, vscode
領域
documentation
Issue 類型
文件
難度
4/5
預估耗時
3-5 天
活躍度
停滯
描述清晰度
基本清楚
新手友好度
35/100

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。