|
Poslao: 03 Apr 2017 20:24
|
offline
- E.L.I.T.E.
- Legendarni građanin
- Pridružio: 23 Maj 2012
- Poruke: 4575
|
Tražio sam i ja skoro slično rešenje, nešto nalik ovom. I oni su implementirali custom rešenje. Mislim da su ti u ovom trenutku najbolje neke od ove dve solucije:
- Ako ti se sviđa ovo možeš da probaš da iskoristiš to i da ga izmeniš po svojoj potrebi (i naravno, da podesiš sa serverske strane da ti se vuče sadržaj odnekud preko zahteva), ali to bi ti oduzelo vremena
- Da koristiš neke već postojeće generatore dokumentacije dostupne za okruženje (pretpostavljam da je VS u pitanju)
Nažalost, na neka bolja rešenja nisam uspeo da naiđem. U svakom slučaju pohvala za temu jer i mene zanima ista stvar
|
|
|
|
Poslao: 04 Apr 2017 22:41
|
offline
- Srki94
- Mod u pemziji
- Pridružio: 14 Feb 2008
- Poruke: 12400
|
Kako god da okrenem, za dokumentaciju sa uputstvima, bez samog koda, ću morati sam da pišem sve od nule. Meni je to trenutno bitnije. Nadao sam se da postoji gotovo rešenje a ne da ja sada pravim 20 pojedinačnih stranica i linkujem ih, pa proveravam itd.
Što se koda tiče, to bih verovatno pokušao da rešim custom aplikacijom koja bi generisala html stranice za svaku funkciju iz XML-a koji se automatski generiše iz koda. Nalazio sam i ja na svašta nešto ali ...
Videću da li Džumla ima neku ekstenziju koja bi mi rešila deo sa uputstvima, dok ću za kod videti kasnije pa verovatno programom posebno praviti.
Jeste VS, C#, Unity.
|
|
|
|
Poslao: 04 Apr 2017 22:58
|
offline
- NIx Car
- Legendarni građanin
- Més que un club
- Glavni vokal @ Harpun
- Pridružio: 27 Feb 2009
- Poruke: 3898
- Gde živiš: Novi Sad,Klisa
|
ja sam koristio sphinx za generisanje python dokumentacije, prilicno sam bio zadovoljan kako mi je odradio posao. Valjda ima za C# nesto slicno.
|
|
|
|
Poslao: 12 Apr 2017 02:37
|
offline
- Srki94
- Mod u pemziji
- Pridružio: 14 Feb 2008
- Poruke: 12400
|
Napisano: 11 Apr 2017 22:42
Trenutno razmatram sledeće opcije :
https://github.com/justinwalsh/daux.io
https://readthedocs.org/dashboard/
Dopuna: 12 Apr 2017 0:33
Done.
Nije ni ovo rešenje koje mi omogućava da preko nekog editora radim to što želim ali je bolje nego da sam pravim sve od nule.
Ako instalirate daux, pratite ovo uputstvo :
http://daux.io/Getting_Started
Potrebno je da instalirate Php i Composer. Morate da promenite php.ini i da omogućite par ekstenzija.
Nakon toga jednom linijom gradite dokumentaciju.
Kreiranje fajlova podrazumeva da kreirate fajlove i foldere strukturno.
Za dokumentaciju koda ću videti da li mogu da iskoristim Daux.
Hvala
Dopuna: 12 Apr 2017 3:37
Okej, nakon što sam odradio mini tutorijal da se upoznam sa MD sintaksom, mogu vam reći da je ovo skroz gotivno rešenje.
Moram da preporučim i aplikaciju MarkdownPad 2, koja odmah prikazuje generisan HTML iz MD-a uporedo sa plain tekstom.
Znači sedneš i pišeš, vrlo jednostavna struktura itd.
Prezadovoljan sam.
|
|
|
|
|