Şu anda basit bir metin işaretlemesinde dokümantasyon oluşturmamızı sağlayan AsciiDoc adlı bir sistem kullanıyoruz . Bundan çoklu çıktı formatları üretebiliriz. Sadece pdf çıktı ve chm çıktı formatlarını kullanıyoruz.
Chm'e bir alternatif olup olmadığını merak ediyordum? Aradığım şey, yazılımımızla çevrimdışı kullanılabilen bir şeydir (bu çok önemlidir, çünkü kullanıcılarımızın çok azı çok uzak yerlerde bulunmaktadır). Bir dizine sahip olmalıdır (köprülü terimlere sahip bir html sayfası kadar basit olabilir), aranabilir olmalı ve koddan belirli girdilerin çağrılmasına izin veren bir mekanizmaya sahip olmalıdır (bağlama duyarlı yardıma benzer).
Bu durumda PDF'ye karşı olan iki şey:
- Bağlama duyarlı yardım bir seçenek değildir
- Genellikle belge oldukça büyük
- PDF, basılı belgelere bağlama duyarlı yardımdan daha uygundur
Ne istiyorum html kullanmaktır. Html ile tek sorun, nasıl otomatik olarak bir anahtar kelime arama sağlamak için anlamaya olamaz ki (tarayıcılar ctrl + f işlevselliği dışında - ben daha belirgin bir şey istiyorum). Ayrıca otomatik olarak anahtar sözcüklerin köprülü bir dizin oluşturmak için bir yöntem bulamıyorum. Bağlam duyarlı yardım bölüm etiketleri nedeniyle basit olurdu - Ben sadece varsayılan tarayıcı ilgilendi sayfanın ve bölümün url iletmek olabilir ve bu sayfa doğru bölüme kadar yüklemeniz gerekir.
Gereksinimlerim chm gibi berbat bir ses çıkarıyor. Gereksinimlerimi chm'den modelledim. Ben chm sevmiyorum tek nedeni kod onun mapids ve böyle kullanarak etkileşim yolu nedeniyle. Daha çok benim kod belgelerin içeriğe duyarlı bölümüne erişmek için kullanabileceğiniz düz metin listesi (benim için otomatik olarak oluşturulan) depo kullanmak.
Html çıkış dosyaları üzerinden gidip sadece bulduğu anahtar kelimelerin bir listesini içeren bir dizin sayfası oluşturmak bir komut dosyası hayal ediyorum. Açıkçası, şu gibi kelimeleri görmezden gelmek için sözcük dışlama mekanizması olmalıdır: bu bölümün yazılması nispeten kolay olacaktır. İkinci bölüm, bir anahtar kelime veritabanını ve html metni içindeki konumlarını bir araya getirmek için bir tür betiğe ihtiyaç duyar. Bu tarayıcı içinde arama mekanizması sağlamak ile birlikte zor bir parçası olacağını düşünüyorum.
Alternatiflerle ilgili her türlü fikir takdir edilecektir. Bir yerde bir web sunucusunda barındırılan bir wiki veya statik html sayfaları kümesi kullanmak isterim, ancak kritik bir çevrimdışı kullanım gereksinimimiz var. Html'yi yerel sürücüye yerleştirmek, bize ihtiyacımız olan arama gereksinimlerini sağlamaz.
DÜZENLE:
Madencilik endüstrisi tarafından kullanılan yazılımlar tasarlıyorum. Bir sürü maden çok uzak ve anlamlı bir şekilde internete erişimi yok. Pdf veya html veya chm ile ilgili yanlış bir şey yoktur (yaşlanması dışında). Eğer doğru yerde bir pdf dosyası görüntüleyebilseydim (örneğin, içeriğe duyarlı yardım) bunu kullanırdım. Neredeyse kendi yazmak için cazip - temelde taşınabilir bir wiki olurdu. Bundan bahsetmek gerekirse, taşınabilir wiki önerirseniz - bu araçları kullanma konusunda hiçbir deneyimi olmayan son kullanıcıyı düşünmeniz gerekir. Ölü basit olmalı. Bu chm güzelliği, çalışmak için bir acı ama son kullanıcılar gibi.