Kimin için

Dokümantasyonu temizlik yapmadan taşıyın

Dokümantasyon taşımak genellikle HTML’i dönüştürüp sonra dönüştürücünün sakladıklarını temizlemekle geçen daha uzun bir süre demektir. Clean Clipper tam o temizleme kısmı için kuruldu ve ölçülen kısım da bu: 512 sayfada sıfır artık HTML etiketi.

İş, dönüştürmeden sonra başlıyor

Bir dokümantasyon setini taşımaya karar verirsiniz; dönüştürme birkaç dakika sürer, temizlik günler sürer. Her dosyanın başında gezinme kenar çubuğu, sonunda “bu sayfa yardımcı oldu mu” bloğu, ortasında sürüm seçiciden kalmış boş başlıklar durur. Bunları silmek elle yapılan, dikkat isteyen ve sıkıcı bir iştir.

Artık işaretleme ikinci katmanı ekler. Dönüştürücünün ayıklayamadığı div ve span parçaları metnin içinde kalır; derleyici uyarı verir, önizleme bozulur ve hangi dosyanın kirli olduğunu bulmak için hepsini açmanız gerekir. Ölçtüğümüz metrik tam olarak budur, çünkü asıl maliyet buradadır.

Taşınan sette ne değişir

Başlıklar, listeler, tablolar, kod blokları ve dipnotlar standart Markdown karşılıklarına eşlenir
Kod bloklarında dil etiketleri korunur – 156 bloğun 73’ünde, karşılaştırılan motorlarda 20 ve 0
Ölçülen 512 sayfada sıfır artık HTML etiketi
Gezinme kenar çubukları, sürüm seçiciler ve geri bildirim blokları dönüştürülmez, kesilir
Boş başlıklar – gezinme bloklarının sık artığı – düşürülür, başlık düzeyleri gövdedeki gibi kalır
Dosya adı şablonu ve alt klasör, taşınan seti daha ilk günden düzenli tutar

Başlık, uyarı kutusu ve tablo tek geçiştelearn.microsoft.com/tr-tr

## Kurulum

Aracı yüklemek için paket yöneticisini kullanın.

> **Not**
> Uyarı ve bilgi kutuları alıntı bloğuna dönüşür: Markdown’da standart
> bir karşılıkları yok, bu yüzden içerik korunur, biçem korunmaz.

| Parametre | Açıklama |
| --- | --- |
| `--path` | Çıktı klasörü |

Yapmadıkları

Tarama yapmaz: bir seferde tek sayfa, üzerinde olduğunuz sayfa – dokümantasyon sitesini kendiliğinden dolaşmaz. Uyarı ve bilgi kutuları alıntı bloğuna dönüşür, çünkü Markdown’da standart bir karşılıkları yok; biçem korunmaz, içerik korunur. Sekmeli içerik ve açılır bölümlerden yalnızca o anda çizili olan gelir. Görselleri indirmez, bağlantı olarak bırakır; iç bağlantılar da özgün siteyi göstermeye devam eder.

Chrome’a ekle – ücretsizTamamen ücretsiz. Hesap yok, ödeme yok, sayfa sınırı yok.

Sorular

Başlık yapısı ne kadar sadık kalıyor?

Başlık düzeyleri makale gövdesinde göründükleri gibi korunur. Boş başlıklar – gezinme bloklarının sık görülen artığı – düşürülür.

Uyarı ve bilgi kutuları ne oluyor?

Alıntı bloğuna dönüşüyorlar. Markdown’da standart bir uyarı kutusu söz dizimi yok; bu yüzden içerik korunuyor, biçem korunmuyor.

Bütün bir dokümantasyon sitesini alabilir mi?

Tarama yok: bir seferde tek sayfa, açık olan sayfa. Toplu işleme açık sekmeler için çalışır, ama siteyi kendi başına dolaşmaz – kaydedilen sayfalara siz karar verirsiniz.

Sekmeli içerik ve açılır bölümler geliyor mu?

Yalnızca o anda çizili olan. Başka sekmeyi açıp yeniden kaydedebilirsiniz; eklenti gizli içeriği kendiliğinden açmaz.

Görselleri de indiriyor mu?

Hayır. Görseller bağlantı olarak kalır ve özgün siteyi gösterir. Piksellerin kendisi gerekiyorsa ayrıca indirmeniz gerekir.