Fosil yerleşik belgeleri kullanma

Question

Bazı ev projelerini yönetmek ve wiki'de not tutmak için fossil kullanıyorum. Birkaç aydır böyle çalıştıktan sonra, en azından gömülü belgeleri kullanmayı denemek isterim; esas olarak önceki sürümlere geri dönmek mümkün olacak şekilde.

Bu web sitesi sayfasını, managing project documentation hakkında inceledim; bu, bunun takip etmek istediğim bir teknik olduğunu onaylıyor, ancak nasıl yapılacağını bilemiyorum.

Wiki sayfalarından birini kopyalayıp yapıştırdım ve onu fosil repoma ekledim, ancak yukarıdaki sayfada açıklandığı gibi erişilebilir olması için dizin yapısında nereye gitmesi gerektiği konusunda çalışamam.

Hiç çalışmayan birkaç yerde denedim. Belge şu anda% fosil-kök% \ doc \ foo.wiki, (Windowsdayım),% fosil-kök% _ _FOSSIL__ (işaretleme nedeniyle kaybolan bir dosya adı) tutan bir sunucu, ancak bir sunucu başlatmış olan dizin fossil ui ile tarayıcımı http://localhost:8080/doc/foo.wiki işaret ettiğimde, fosil bana index.html bulamadığını söyleyerek güzel biçimlendirilmiş bir sayfa sunuyor. Ne olacağını görmek için /doc/index.html dosyasını oluşturdum, ancak hiçbir fark yaratmadı.

Lütfen birisi bana yardımcı olabilir ve/veya gömülü belgeleri veya başka bir "nasıl yapılır" belgesini içeren örnek bir depoya yönlendirebilirim.

Answer 1

Sadece kendisine bağlamak için depoda %fossil-root%\www\ dizin altında belgelerine (veya sürüm kontrolü altında başka bir dizin) koymak ve sonra, örneğin, Üstbilginizin mainmenu bölümüne aşağıdaki satırı ekleyebilirsiniz ihtiyaç

:

html "<a href='$home/doc/trunk/www/foo.wiki'>Documentation</a>\n" 

Söylediğim gibi, sürüm denetimi altındaki herhangi bir dizin olabilir. Bunu test etmek için, depodaki herhangi bir dosyayı seçin, en üst düzeyde bir README dosyası diyelim ve http://localhost:8080/doc/trunk/README'a gidin. README dosyasını tarayıcınızda ham metin biçiminde yüklediğini görmelisiniz. Wiki veya html dosyalarını www gibi belirli bir dizinin altına koyarak, özellikle belgeleriniz olarak oluşturulmasını istediğiniz dosyaları organize etmeyi kolaylaştırabilirsiniz. Belgeniz %fossil-root%\doc\foo.wiki bulunuyorsa

Answer 2

, aşağıdaki URL adresinden erişebilirsiniz:

http://localhost:8080/doc/trunk/doc/foo.wiki

şöyle Bu URL yıkar:

• http://localhost:8080 erişime kök URL fossil ui
/doc çalıştırdığınızda fosil, gömülü belgelere erişmek istediğinizi belirtir
• trunk ait

yerine depo içinde belgenin yolunu sen

/doc/foo.wiki erişmek isteyen belgeleri olduğunu içeren checkin gösterir, ayrıca bir etiketi veya şube adı belirtmek, veya hatta onaltılık bir kontrol tanımlayıcısı.

Kullandığınız URL'de, http://localhost:8080/doc/foo.wiki, foo. wiki checkin adı olarak yorumlanır ve hiçbir belge yolu belirtilmez, mantıksal olarak Fossil hiçbir şey bulamayacağınız anlamına gelir. Gömülü belgeleri içeren bir örnek depo gelince

, Fosil web sitesinin kendisinin ana sayfası bir örnektir:

https://www.fossil-scm.org/index.html/doc/trunk/www/index.wiki

• https://www.fossil-scm.org/index.html Fossil'in kök URL
• /doc gömülü belgeler için bir isteği belirtir
• /trunk depo
• index.wiki içindeki path to the requested file olan depo içinde dosyanın adıdır biz gövde
• /www/ dosyaları getirmesini istediğiniz belirtir.

Yani, depo 'trunk' branch yılında, dosya www/index.wiki Fosil web sitesinin ana sayfasını içermektedir. Fosil 1.33 sonra

Answer 3

http://www.fossil-scm.org/index.html/doc/trunk/www/embeddeddoc.wiki

, sadece depoda belgenizi hazırlayın. > Yönetici - -> Yapılandırma wiki dosya kurulum için

/doc/index.wiki 

Ve kullanım web tarayıcısında konur edin. Bir "Dizin Sayfası" alanı var, ana index.html'nizi doldurun. Örneğin :

/doc/trunk/doc/index.wiki 

Ya da sadece serbest sürümünü isterseniz:

/doc/<version>/doc/index.wiki