Gambas-it
Programmazione => Progetti degli utenti => Topic aperto da: fsurfing - 09 Aprile 2008, 16:11:04
-
Sicuramente quello che manca a Gambas come più volte detto da moltissime persone è un bel manuale ricco di esempi di codice, in modo da permettere a molte più persone che si vogliono avvicinare alla programmazione con gambas di avere uno strumento per imparare questo valido linguaggio.
Dato che il team di Gambas preferisce andare avanti con nuove versioni tralasciando la parte manualistica propongo di realizzare un manuale per così dire "made in GAMBAS-IT.org "!!!! :good:
ognuno di noi con la propria esperienza acquisita con prove, tentativi ,ricerche ecc ecc potrà scrivere una parte del manuale relativa ad un componente, in modo da arrivare ad avere un qualcosa utile a tutti!!!
chi si vuol proporre si faccia sotto!
:ble:
-
su su non siate timidi! :punzecchio:
-
Come ho espresso in un precedente post, da parte mia ho trovato utile redigere una specie di collezione di soluzioni tratte da codesto forum.
Non ha la pretesa di essere nulla di speciale ed è in continua evoluzione ed aggiornamento, ma lo trovo molto utile quando non ricordo qualche cosa.
Presenta però una grossa limitazione a mio avviso.
Ogni volta che mi serve devo usare la funzione di ricerca per puntare alle parole chiave nel documento.
Come sarebbe bello ottenere l'aiuto diretto all'interno di Gambas tramite F2 puntando direttamente al punto della propria guida personalizzata.
Se c'è una cosa che mi da personalmente fastidio è che si debba aprire ogni volta il browser e su pagine diverse per giunta.
Sarebbe molto più "leggero" un semplice documento di testo indicizzato sulla richiesta di aiuto specifica.
Ovviamente non so se una cosa del genere sarebbe di possibile implementazione in Gambas, ma un vantaggio sarebbe comunque assicurato: avere la guida come si vuole ed aggiornabile secondo il proprio gusto, arricchendola magari con qualche esempio di codice.
-
la guida di gambas è in locale quindi si possono modificare i vari file in base alla necessità.
questa soluzione l' ho anche considerata èd e sicuramente comoda si potrebbe anche inpostare il progetto su questa linea
-
Lascio dire a chi ne sa piu di me se è possibile. Certo che si dovrebbero conoscere tutti i parametri che consentono di rendere la cosa indicizzata nel modo corretto.
In questo purtroppo mi reputo un perfetto ignorante, ma sempre pronto ad imparare.
-
il modo più semplice è quello di modificare pagina per pagina la guida di gambas
per cui il tutto rimane già indicizzato e funzionante , ho fatto delle prove ed è tutto ok
-
Ho fatto una prova e sono andato a cercare le pagine che dici in:
/usr/share/gambas2/help
E' questa la posizione corretta?
Se è così, mi ritrovo con decine di pagine html che posso modificare solo con molta attenzione.
Ma se per caso cancello qualche codice di controllo, son dolori, anche perchè a me questo genere di codice non è mai andato a genio.
Che la cosa si possa fare dunque sembra possibile, ma sinceramente non è molto comoda la modifica.
Io l'avrei intesa in questo modo:
Quando premi F2 e ti compare la pagina guida (possibilmente non html ma solo txt quindi senza formattazione) sei gia in condizioni di poterla modificare ed arricchire con le info che hai a disposizione.
Allo stato attuale questo non mi sembra possibile, ma posso sbagliare!
Quandi apro il file /usr/share/gambas2/help/tree, mi trovo con il browser aperto, e qui non posso editare direttamente le pagine.
-
per l' editazione si può utilizzare il bellissimomo programma nvu che ti permette di editare il file html senza inserire codice , come se fosse una pagina di testo o quasi.
si comunque è abbastanza semplice andare a cancellare qualche collegamento ipertestuale per errore.
Quando premi F2 e ti compare la pagina guida (possibilmente non html ma solo txt quindi senza formattazione
questo penso sia impossibile da realizzare senza una modifica nel codice sorgente di gambas.
sicuramente quando noi premiamo f2 gambas analizza il testo evidenziato creando un nome di pagina che invia al browser il quale c'è la visualizza.
Probabilmente l'unica soluzione se si vuole tradurre e completare la guida è farlo tramite wiki come indicato nella prima pagina della guida
Welcome to the Gambas documentation! This documentation is based on a Wiki written in Gambas. If you want to modify some pages, you must register to the Wiki administrator. Once done, you can learn the Wiki Manual and start modifying some pages!
-
Immaginavo! Non è che sia una soluzione pratica però. La cosa che veramente sarebbe innovativa è che se lo staff di gambas non vuole perdere tempo con la guida, implementi in esso la possibilità di crearsela da soli, come note indicizzate collegate alle parole chiave del codice.
Questo si sarebbe per me un vero salto di qualità che farebbe invidia anche al software più blasonato di Microsoft!
-
Pensandoci bene, non penso sarebbe una cosa molto laboriosa da implementare. Il motore di ricerca indicizzato già esiste, quindi basterebbe che il puntamento ad ogni oggetto o parola del codice rimandasse ad una pagina testuale vuota nella quale ognuno scrive cio che gli pare, anzichè ad una pagina html non direttamente modificabile.
Se ogni file testuale viene riferito ad un oggetto, permette facilmente lo scambio di informazioni tramite il forum, ed in tal modo la documentazione crescerebbe nel tempo in modo esponenziale, completata da ciascuno con i punti importanti dell'esperienza fatta.
-
Scusate l'intromissione...
Sono tutte buone idee, ma non contano il problema della condivisione, ovvero la possibilità di concentrare in un'unico punto tutte le nostre esperienze. Per far questo esistono appunto i wiki, o similari.
La creazione di un file, che sia di testo o html, non penso sia applicabile appunto il problema della condivisione, a meno che si crei questa cosa ad uso personale... :-(
Un'altra alternativa, sarebbe quella di usare questo stesso sito (cosa che ne abbiamo iniziato a parlare in altra discussione...), su cui mettere i nostri esempi. Però per costruire una cosa utilizzabile in termini di ricerca, occorrerebbe implementare un'apposito modulo web.
Anche l'idea di mettere i nostri contributi in un'apposita FAQ potrebbe essere buona, credo... Ma sarebbe comunque un problema la ricerca...
Riguardo poi ad un possibile futuro manuale d'uso, la cosa sarà fattibile solo dopo l'acquisizione di una certa mole di esempi, altrimenti è inutile.
I miei pareri...
-
Io avevo in mente una cosa molto personalizzabile, ma forse non mi sono spiegato.
Se io con le mie note modifico i miei files guida (mentre alcuni rimangono vuoti perchè mai usati) e li ho sempre a disposizione in linea, li posso modificare quando e come desidero. Se qualcuno mette a disposizione i propri, non faccio altro che aprirne uno ad uno ed andare a vedere se contiene info da aggiungere a quelle che ho gia, altrimenti lascio perdere.
Praticamente crei una specie di wiki personalizzato sempre in linea con il tuo codice e non devi romperti le *CENSURA* a modificare un wiki tradizionale che magari non presenta alcun collegamento con l'ambiente di sviluppo.
In pratica è quello che faccio con il mio sistema, quando trovo info interessanti e le applico a delle note appicicose sempre disponibili sul desktop, con la differenza però che nel caso di gambas sarebbero indicizzate sulle parole chiave del codice.
Spero di essere stato cristallino!
-
Salve, vediamo se posso darvi una mano.
Il sito dispone di diverse funzioni online messe apposta per aiutare chi cerca aiuto.
Questi strumenti sono:
1) la sezione FAQ
2) la sezione Glossario
3) la sezione Articoli
4) il Wiki
Nella sezione Faq si possono inserire semplici Domande-e-Risposte utili a chi cerca soluzioni a problemi di semplice natura. Es.: "Come si cancella un file?" - "Usa KILL".
Nella sezione Glossario si possono inserire termini utili per tutti, dai neofiti ai guru informatici.
La sezione Articoli può contenere piccole guide del tipo: "Come ho compilato Gambas su StarTrekLinux".
Infine abbiamo la sezione Wiki, che tutti penso sappiano come funziona.
Questo è lo strumento più interessante e potente: si possono creare pagine di documentazione correlate tra di loro con semplicità. Se date un'occhiata a quello che ho inserito in riferimento a Gambas ed alle librerie grafiche ve ne potete rendere conto.
Insomma, gli strumenti ci sono. Basta usarli ;-)
-
Si Leo ci sono senza dubbio, ma non in linea!
Se uno non dispone del collegamento alla rete cosa fa? Si deve arrangiare con i mezzi che ha, e credimi c'è ancora tanta gente che ne è sprovvista e non per causa propria, ma a causa di una rete che non è ancora stata sviluppata, come in molte zone qui in Trentino.
La guida locale è per me di assoluta importanza, e come vedi è implementata in tutti i software commerciali che si rispettino.
Il problema dunque rimane, perchè con tutti i bei strumenti che hai messo in rilievo, non c'è n'è uno che si integri fondendosi nell'ambiente di Gambas.
-
Ti capisco benissimo darth, eri stato abbastanza chiaro già nel primo post.
L'unica cosa che puoi fare è quella che suggerisci anche, però in ogni caso hai la necessità di collegarti per scaricarti le ultime modifiche.
Un'idea potrebbe essere quella di una sorta di RSS, che ti scarichi in locale e poi te la leggi, o integri con la tua doc presonale. Certo non è una cosa simpatica, perchè ti tocca analizzare passo passo tutto il testo per evidenziare le novità...
Riguardo ad un collegamento a Gambas, magari da ide, credo sia una cosa un pò arzigogolata, a meno di non fare come suggerito da fsurfing, riguardo la modifica diretta dei file html il che, giustamente hai tu stesso scritto, non è sempre alla portata di tutti.
Darth, a dire la verità, con questa discussione hai alzato un bel polverone, e devo dire la verità, non credo sia una cosa che si possa mettere in piedi in quattro e quattr'otto.
Al momento tocca arrangiarsi un pò sfruttando, per quanto ci è possibile, gli strumenti che abbiamo, ad esempio anche il presente sito.
Non me la sento neppure di colpevolizzare il team di gambas, dato che ha pur messo una sorta di doc in linea (e nel package), anche se non completa di esempi. Questa cosa non è che la fanno poi tutti, neppure le software house commerciali, e comunque ci girano fior di soldi...
-
@md9327
E' proprio questa la cosa interessante, almeno per me, perchè così rispolveri continuamente i concetti.
Daltronde è un po lo stesso che leggersi i post in questo forum, e quando le cose si ripetono, non è che mi tolgono la voglia di leggerle!
Siamo qui per questo penso, o sbaglio? Il team di Gambas dovrebbe essere contento che il loro lavoro viene apprezzato e ritornano loro le impressioni di chi lo usa in modo del tutto positivo per l'edificazione collettiva!
E non è poco. Gli ideatori di questo forum hanno tutta la mia più grande stima e considerazione. Se non fosse per questo ambiente, io non mi sarei mai cimentato in quest'opera.
-
Non avevo capito che vi riferivate _solo_ alla documentazione offline.
-
No, in effetti darth aveva dato uno spunto in più, o perlomento parallelo...
Non sò, io le mie le ho dette, ma sono aperto ovviamente a qualsiasi possibilità e ipotesi, tenendo anche presenti le difficoltà per realizzarle.
L'unica cosa che non credo sia possibile al momento, è proporre un'idea simile al team ufficiale, per cui l'unica sarebbe costruirla noi, ma qui viene il bello... chi e quando lo fà ?
Implementare un pulsante, a livello teorico è semplice, ma immergerlo in pacchetto come gambas è un'altro paio di maniche...
(sempre se non abbia compreso il fine ultimo del discorso...)
:-P
-
Ho sempre ammesso la mia ignoranza ma ribadisco che a livello pratico e non teorico non mi sembra una cosa tanto difficile da implementare, perchè il motore di ricerca sulle parole chiave esiste gia. Si tratta quindi di farlo puntare ad un vettore indice di file vuoti (pagine bianche) nelle quali ognuno scrive cio che vuole.
Il problema più grande a parer mio è quello di ottenere ascolto da parte del team.
Comunque posso sbagliare, ho ammesso la mia ignoranza!
-
L'idea di aere una guida in linea (locale) testuale e valida e soprattutto semplifica la realizzazione dei vari testi, comporta però l' intervento del team di gambas per renderla funzionale, cosa difficile da ottenere (almeno in questo momento in cui la tendenza è all'evoluzione del software, anche se in realtà quasi ogni giorno vengono aggiunte pagine alla guida).
Quindi la soluzione più semplice è la modifica dei file esistenti.
questa si può realizzare in questo modo:
- Chi se la sente può modificare direttamente i file in html e inviarmeli
- chi volesse partecipare al progetto senza complicarsi la vita con html può semplicemente fare un copia incolla della pagina in un file di testo , modificare, tradurre, aggiungere esempi e poi inviarmela, io la convertirò nel file html
- a questo punto periodicamente posso inserire in area download un programma che effettua la copia dei file modificati nelle cartella della guida sul proprio pc.
che ve ne pare?
-
Messa in questo modo sembrerebbe una buona soluzione.
Che ne dici di sentire che ne pensano gli altri?
-
certo vediamo che ne pensa il forum :-D
-
Scusate se mi intrometto nel discorso,ma da principiante sto scrivendo un file di testo con i comandi presi dalla guida in pdf di gambas (visto che purtroppo non riesco a modificare il file originale e ho già tentato di tradurlo "a mano" ma alla fin fine risultava una cozzaglia incollando le immagini.
Visto che (come già detto) sono un perfetto principiante e alcune volte non mi ricordo a che serviva il comando e a spulciarmi il pdf è una perdita non indifferente di tempo e sul wiki di gambas non ci capisco granchè, il file in questione mi aiuta sia nella ricerca che nell'avere a portata di mano un "manuale" di riferimento.
Allego qui il file e vi chiedo: in questa documentazione non si può far qualcosa come questo documento di testo, una breve descrizione sintassi, ecc anche per i più inesperti? Io inoltre lascio qui il file così se qualcuno vuole lavorarci o effettuare correzioni tanto vale condividere così da migliorare il prodotto finale :)
Edit: qui non me lo upload, pertanto ho uploadto il file nella sezione download con il nome "Guida per Principianti a Gambas" visto che non sapevo che nome dare.
-
@killerinside
Non so proprio dove sia andato a finire il tuo allegato, ma nemmeno nella sezione download riesco a trovarlo!
-
L'ho uplodato qui (http://www.mediafire.com/?hty1g3jmxmd) visto che il sito lo rifiuta :D evidentemente non apprezza l'idea.
-
l' idea è proprio di riscrivere le pagine della guida di gambas in modo simile
a quello del tuo file, ovvero fare una traduzione , inserire esempi pratici e descrivere le varie funzioni in modo chiaro anche per i più inesperti
-
@killerinside:
lo rifiutava perché, come puoi leggere appena sotto la casella per allegare i file, accetta poche estensioni:
Estensioni consentite: zip gif jpg gz tar 7z deb rpm png
:duro:
-
@fsurfing: ah ok! perfetto, volevo solo dare il minimo contributo per portare gambas anche tra gli utenti inesperti italiani, ma se ci pensate voi verrà sicuramente un capolavoro ;)
@leo72: perdonoooooo! non avevo letto.. :D
-
tutti quanti i volenterosi sono invitati a dare una mano! :2birre:
-
Io opto per l'aggiornamento del Wiki....in questo modo ogni comando avrà la propria pagina nella quale sarà possibile aggiungere spezzoni di codice d'esempio....secondo me è molto più facile....avere un file di testo che gira tra tutti per essere aggiornato è un casino specie se si hanno sviluppi e correzioni in parallelo, cioè di più persone nelo stesso momento..in tal modo si creano più copie 8leggermente diverse) dello stesso documento.
-
a questo punto gioco anche io....anche io sono un principiante sia di gambas che della programmazione in generale..ho trovato utile fare delle tabelle riassuntive che descrivessero comando con relativa funzione e sintassi, uno per memorizzare e due per rendere più veloce la scrittura....poi avevo iniziato a descrivere le prorietà di oggetti e simili....ma poi mi sono arenato....ma in gruppo si può trovare la voglia:))
bella l'idea di aggiorare wiki...mi piacerebbe dare il propro contributo...si può?come si fa?
-
Il wiki è aperto a tutti. Basta creare un account.
Il motore è lo stesso della Wikipedia per cui i comandi per la formattazione del testo sono gli stessi (chi ha già scritto sulla Wikipedia, non avrà problemi ad usare il Wiki del nostro sito).
-
il wiki risulta abbandonato....
non è che ora obbiamo prendere in considerazione la possibilità di una documentazione diversa dal wiki?
Penso che se la gente non si avvicina a Gambas è anche la mancanza di documentazione (e per dipiù tutta in inglese o spagnolo)...
-
Il wiki risulta abbandonato perché nessuno ci scrive.
Tempo fa ci ho inserito un sacco di cose, dentro, ma il tempo libero non è molto e gli interessi da seguire tanti.
Invito perciò tutti coloro che vogliono dare una mano a registrarsi e ad iniziare a pubblicare qualcosa.
Ciò che sarebbe da terminare sarebbe la sezione dei tutorial per insegnare l'uso di Gambas dal lato pratico.
E poi la documentazione dei principali comandi e funzioni.
Forza, gente! :-D
-
In questi giorni, ho trovato un pochino di tempo (ore notturne...), e ho scritto anche io qualcosina nel wiki.
Oltre a questo, ho dato una risistematina anche alle voci di menu, che a mio avviso erano impostate male (ovviamente a mio avviso).
Se avete dubbi, o non vi piace, possiamo ricambiarlo.
Tanto per la cronaca, ho modificato i titoli, in modo che per le parole chiave (es. FOR...NEXT) fossero scritte come vengono impostate in Gambas (maiuscolo), mentre per le funzioni le ho lasciate così come sono (primo carattere maiuscolo, il resto minuscolo).
Poi ho inserito altri titoli, un pò a carattere generale, di argomenti che nella documentazione ufficiale Gambas, hanno poco di chiaro. Questo anche in risposta a molte richieste fatte nel forum.
Spero di avere, ogni tanto, tempo per aggiungere cose; la parte relativa agli oggetti grafici è un pò pesantina a causa delle immaggini che necessariamente tocca inserire, ma vedrò di fare qualcosa anche per questo.
Bye
-
A mio avviso la cosa più facile da fare sarebbe aggiornare il forum man mano che vengono riscontrati problemi e risolti problemi nel forum...in questo modo si aggiungono sempre cose nuove da cui tutti possiamo attingere...
-
@md9327:
mi sembra che tu abbia fatto un bel lavoro. Bravo! :ok:
@Ceskho:
effettivamente si potrebbe anche creare una sezione nel Wiki di soluzioni rapide a semplici problemi.
-
@leo72:
Grazie!
@Ceskho:
Diciamo che il forum è più per le richieste di aiuto immediato, e come ultima risorsa se non si è riusciti a risolvere il problema da soli e con la documentazione a disposizione; il wiki fà parte di quest'ultima, e in quanto tale ha lo scopo di fornire una più ampia descrizione del linguaggio. Se poi vi vengono aggiunti esempi, NON interi programmi :-? , il discorso si completa.
Il forum, oltretutto, offre la possibilità di incontrare opinioni diverse, che aiutano molto, e non possono essere la bibbia di Gambas; oltrettutto la cosa è molto dispersiva, solo per il fatto che le discussioni, seppur ben catalogate, spaziano per i più disparati motivi. A volte già il solo ricercare una cosa diventa particolarmente pesante, cosa ben diversa da un vero proprio punto di riferimento, come potrebbe essere il wiki. Se poi diventerà il manuale di Gambas più completo che esista, oppure un best-sellers... bè, la cosa dipende da noi e dal nostro contributo.
-
Si potrebbe creare nel forum una sezione per il wiki dove si potrebbe richiedere a chi è più competente di creare una voce nel forum che parli di un determinato comando o roba simile...
cioè in tale sezione potrei richiedere di spiegarmi il comando "SHELL" ad esempio e chi ne sa qualcosa ba nel wiki e scrivi informazioni sul comando....
questa è la mia idea..
-
Bè, l'idea mi sembra carina...
Appoggio!
:good:
-
Come richiesto, ho creato il forum "Wiki" dove è possibile inserire suggerimenti, richieste o quant'altro riguarda il wiki di Gambas-it.
-
Ti ringrazio per avermi ascoltato Leo...sei e rimarrai il migliore (dopo di me ovvio :D!!!)
-
Segnalo anche i seguenti siti.
Sito ufficiale di Gambas:
- http://gambas.sourceforge.net/en/main.html
Wiki ufficiale di Gambas:
- https://gambaswiki.org/wiki?l=it
Mailing List ufficiale di Gambas:
- https://lists.gambas-basic.org/pipermail/user/
Forum, Wiki ed altri siti esistenti su Gambas:
- https://gambas-es.org/
- https://foro.gambas-es.org/forum.php
- http://www.gambas-club.de/index.php
- https://forum.gambas.one/
- https://www.gambas.one/classes/
- https://gambaslinux.fr/v2/
- http://89.234.156.109/
- http://www.gambas-it.org/wiki/index.php?title=Pagina_principale
- https://gambas-buch.de/dwen/doku.php
- https://de.wikibooks.org/wiki/Gambas
- http://sologambas.blogspot.com/p/indice.html
- https://jsbsan.blogspot.com/
- http://captainbodgit.blogspot.com/search/label/Gambas
- https://pigalore.miraheze.org/wiki/Main_Page
- http://icculus.org/piga/
- http://novatocodegambas.blogspot.com/
Testi, manuali e corsi esistenti:
- https://gambaswiki.org/wiki/doc/book?nh&l=en
- https://cursogambas.blogspot.com/p/indice.html
- https://github.com/jsbsan/Ejemplos-del-Curso-De-Gambas3
- https://en.wikibooks.org/wiki/Programming_Gambas_from_Zip
- https://wordpress.gambas.one/a-book-by-gerry-buzolic/
- https://wordpress.gambas.one/2020/04/10/the-gap-bg-project/
- https://github.com/demosthenesk/the_gambas3_book