EasyDoc

EasyDoc postato il 15/02/2010 14:32:09 nel forum programmazione, gdrcd, open source, hosting

Hello gente!
Tempo fa ho iniziato a scrivere la documentazione per un mio giochino e nel tentativo di fare qualcosa di furbo ho finito per sintetizzare il mio sistema di documentazione in un pacchetto usabile e scaricabile.
Ovviamente può essere comodo per mille tipi di documentazione e non solo per giochi e pbc.

Nel link a cui vi rimando al fondo del thread troverete qualche dettaglio in più sui perchè o i percome, qua sintetizzo solo i punti salienti.

1. non usa il db, ma una struttura xml leggera, veloce da spostare da uno spazio web all'altro e che non vi sovraccarica quindi il db del vostro gioco.

2. richiede php5 con installate le librerie DOM e xsl (altervista le supporta, ho già provato. il mio spazio linux aruba le supporta, quello win no, ma potrebbe dipendere dall'antichità del mio dominio :P). Se una volta caricato il tutto sul vostro server ricevete un parse error significa che la vostra versione di php non ha queste librerie.

3. non richiede particolari conoscenze di programmazione per installarlo e gestirlo.

Clickando qua potete vedere la demo che ne mostra le funzionalità e peculiarità e il link al download.

Se pensate possa esservi utile accomodatevi :)

http://www.rpgame.org/demo/easydoc/ ↗

---

quota

15/02/2010 14:46:35

davvero utile come idea clem, proverò ad utilizzare il tuo pacchetto quanto prima :-)

quota

15/02/2010 14:53:29

Eccolo finalmente 😇

---

quota

15/02/2010 15:04:18

Il pacchetto sembra interessante, ma se io dovessi usarlo per fare la documentazione del mio gdr come dovrei procedere? dovrei imparare xml o simili?

quota

15/02/2010 15:07:29

Non c'è nulla da imparare di xml.
Devi solo seguire le istruzioni del pacchetto.

Dovessero essere poco chiare chiedi pure, cerco di migliorare le istruzioni man mano che mi si pongono domande sulle procedure.

---

quota

15/02/2010 15:11:26 e modificato da greatwolf il 15/02/2010 15:15:11

Quindi devo scrivere N file per ogni argomento della mia documentazionee il tutto a mano?

quota

15/02/2010 15:18:36

Attualmente si, tutto a manina.
Di fatto devi vederli come files testuali che poi lui aggrega.

---

quota

16/02/2010 08:14:51

Complimenti un bellissimo lavoro!

---

quota

16/02/2010 10:55:16

Come ti ho già detto è una wiki in miniatura in pratica, un bel sistema davvero pratico e leggero, poi si può banalmente modificare la formattazione negli xsl e personalizzarsi il layout.

Counque una cosa non è mai `easy` se.. u.u

*parte il coro in sottofondo*

Vo-glia-mo la GUI !
Vo-glia-mo la GUI !
Vo-glia-mo la GUI !

⚔️

---

quota

16/02/2010 12:41:37

la sto facendo blanketto, ma tieni conto che per fare una guy in un simile approccio si devono avere sul server i permessi di scrittura aperti sui files e cartelle.

E non penso sia una cosa necessariamente così scontata ;)

---

quota

16/02/2010 12:53:53 e modificato da blancks il 16/02/2010 12:56:10

Non dicevo fosse scontata, ma comunque altervista ha abilitati simili permessi (quindi la stragrande maggioranza dei gdr potrebbe usare tutto senza problemi) e al momento non mi viene in mente alcun provider che ho utilizzato che non mi consentisse di impostare questi permessi, per questo reputo non sia una cattiva idea.

Poi vabe, in casi particolari si possono sempre editare a mano gli xml ma se si può facilitare la vita all'user sapendo che nella maggioranza dei casi la gui funzioni, why not ?

---

quota

La Via del Ninja

Intervista alla gestione del play by forum Naruto GDR La via del Ninja! Diventa un ninja!

Epic Quests

Epic quests: la popolarità dei temi fantasy nei giochi online

Alabarda e Lancia

Alabarda e Lancia: Le armi da asta che hanno fatto la storia!

Autodomande per Gestori

Lista di domande che ogni aspirante Gestore dovrebbe porsi quando inizia a progettare un nuovo gdr