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

Markdown Biçimleri (Bilgilendirme)

Aperta
#171 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
Lingua principale
HTML
Stelle
367
Fork
114
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

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.

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Direzione di ricerca

Inizia con 1-js/01-getting-started/2-manuals-specifications/article.md e confrontalo con la versione inglese, utilizzando le regole markdownlint collegate per identificare le violazioni di formattazione. Esamina analogamente gli altri file Markdown in turco; il lavoro è considerato completato quando vengono corretti i problemi di formattazione come MD022, mentre le correzioni di refusi e di significato non rientrano nell'ambito.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
markdown, vscode
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
4/5
Tempo stimato
3-5 giorni
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
35/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.