Kimin için · Evgeny K.

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 Web Clipper tam o temizleme kısmı için kuruldu ve test edilen kısım da bu: 512 test sayfasında çıkarılan hiçbir makalede artık HTML etiketi kalmadı.

İş, 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
• Test edilen 512 sayfada çıkarılan hiçbir makalede artık HTML etiketi yok
• 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

## 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.

Sorular