Preporuka za doc/manual rešenje?

Preporuka za doc/manual rešenje?

offline
  • Lead Developer ⠀ ⠀⠀⠀⠀⠀⠀ Go 5 Creative
  • Pridružio: 14 Feb 2008
  • Poruke: 12256

Potrebno mi je moderno i besplatno rešenje za prikaz uputstva i dokumentaciju koda, koje bih ja hostovao na mom sajtu.

Evo primera koji mi se dopadaju :
https://developer.paypal.com/docs/integration/web/
https://docs.unity3d.com/Manual/PhysicsSection.html
https://docs.unity3d.com/ScriptReference/Events.Un.....tener.html

Tražio sam svašta nešto i uglavnom se svodi na skupa rešenja, open source ili neku wiki stranicu.
Wiki bi svakako poslužila ali mislim da nije to baš ono što meni treba.

Kapiram da bih to mogao i sam da uradim nekako verovatno ali ne bih da trošim vreme na to ako postoji neko rešenje.

Mislim da mi neće trebati ništa kompleksno ili previše ozbiljno.

Ziveli



Registruj se da bi učestvovao u diskusiji. Registrovanim korisnicima se NE prikazuju reklame unutar poruka.
offline
  • Programer
  • Pridružio: 23 Maj 2012
  • Poruke: 4463

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 Smile



offline
  • Lead Developer ⠀ ⠀⠀⠀⠀⠀⠀ Go 5 Creative
  • Pridružio: 14 Feb 2008
  • Poruke: 12256

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.

offline
  • Més que un club
  • Glavni vokal @ Harpun
  • Pridružio: 27 Feb 2009
  • Poruke: 3895
  • 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. Smile

offline
  • Lead Developer ⠀ ⠀⠀⠀⠀⠀⠀ Go 5 Creative
  • Pridružio: 14 Feb 2008
  • Poruke: 12256

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 Ziveli

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.

Ko je trenutno na forumu
 

Ukupno su 738 korisnika na forumu :: 36 registrovanih, 5 sakrivenih i 697 gosta   ::   [ Administrator ] [ Supermoderator ] [ Moderator ] :: Detaljnije

Najviše korisnika na forumu ikad bilo je 3028 - dana 22 Nov 2019 07:47

Korisnici koji su trenutno na forumu:
Korisnici trenutno na forumu: A.R.Chafee.Jr., aleksmajstor, Apok, awathorn, Bane san, bankulen, darkangel, doktor1964, Dorcolac, Drug pukovnik, goxin, hyla, ivance95, Kaplar2, krunc, Kubovac, lakiluciano, ljuba sd, Lox2, MB120mm, mercedesamg, Metanoja, Miroslav Griffin, nebojsagogic, nenad81, NenadG, Novi2, nuke92, Revolucion, Sibin2, Srky Boy, Srna, Stanlio, tokivoki01, vlad the impaler, zixo