ciao, ho finito il tutorial su argparse, ecco il link:

https://leucalipto.blogspot.com/2020/09/argparse-tutorial.html

se vedete degli errori fatemi un fischio.

Dunque credo di aver risolto, ora sto scegliendo che tema usare ed ho anche aggiunto l'estensione per aggiungere il bottone per copiare il codice.

Il tuo file di configurarezione conf.py mi è stato di grande aiuto.. e non hai citato che bisogna anche aggiungere la direttiva

intersphinx_mapping = {'py': ('https://docs.python.org/3', None)}

che infatti ho trovato nel tuo file.

Ora mi devo occupare dei pdf che anche qui mi da problemi.

Il mio script awk non azzererebbe la portabilità del lavoro in quanto si occuperebbe di convertire i vari :func:`blahblah` in link tipo **`curses https://docs.python.org/3.8/library/curses.html#module-curses`_ ** che sia sphynx che rst2html e rst2pdf digeriscono senza problemi.

Non so se conosci awk, è un comando linux, oppure un vero proprio linguaggio per processare testo che è stato scritto da Brian Kernighan. Quest'ultimo insieme a Dennis Richie (l'inventore del C) hanno scritto un famosissimo volume sul funzionamento e l'apprendimento del c. Ritchie è anche noto per aver scritto il primo UNIX.

Per "fuori dal sistema ufficiale di pacchettizzazione" intendo che non rientra in apt il sistema di pacchettizzazione di ubuntu e debian. E' importante evitare di installare cose fuori da apt per evitare di avere un sistema ibrido. Avere un sistema ibrido puo' portare ad avere un sistema incasinato cioè instabile, in quanto apt non sa che librerie/app varie sono installate, questo ovviamente se usi pip da root. Se usi virtualenv le cose stanno un po' meglio in quanto venv crea un ambiente virtuale parallelo al tuo sistema installato quindi eviti di avere configlitti di versioni o librerie di versioni differenti sparse in giro. Altra cosa da evitare è quello di installare roba da sorgenti, per le stesse identiche ragioni. Se hai un server puoi anche usare i sorgenti ma solo nel caso in cui sai che su quel sistema c'è solo quel software installato, un sistema desktop non è adatto a questo tipo di mix.

Un altra ragione per evitare di uscire dal sistema ufficiale di pacchettizzazione è il fatto che apt conosce non solo tutto quello che è installato ma anche tutti gli hash di ogni singolo file. In questo modo puoi fare un test di sicurezza molto veloce e affidabile per capire se qualche libreria/file/eseguibile/driver/backdoor/ecc è stato illecitamente sostituito/aggiunto/rimosso dal sistema.

Quindi usare pip o i sorgenti, specialmente da root, è veramente una cosa pessima, che chiunque dovrebbe evitare.

Usare venv è un po meglio perché se hai sospetti di intrusioni varie cancelli la cartella e reinstalli... ma comunque è una cosa veramente poco elegante perché è come avere un software portable in ambiente windows.. si c'è ma è una cosa che si porta dietro un po' di svantaggi perché ovviamente ha le sue librerie, quindi ti occupa una barca di spazio e in più è ovviamente più lento. Ci sono moti dev che lo usano come sistema ma viene usato come ambiente temporaneo e per debug... tutti i software che raggiungono una certa stabilità e importanza vengono pacchettizzati. Per tutte le ragioni che ho spiegato.

Le mie idee non sono le mie idee sono le idee che la comunità linux si porta dietro da 30 anni che evidentemente sono idee che funzionano visto che google con android si è "inventato" il play store e lo stesso hanno fatto apple e microsoft.

non ho capito quindi usi visualstudio ?

Sono indeciso tra vim e emacs. Vim lo conosco mentre emacs lo sto imparando.

Voi cosa usate ?

Dunque ho dovuto per forza usare sphinx perché il tool che avevo intenzione di usare cioè rst2pdf e rst2html5 hanno qualche problema soprattutto a covertire i tag per python come :func:`curses.window` in quanto non li riconosce. Quindi ho installato sphinx e dopo aver risolto una sfilza di errori ho comunque lo stesso problema che non mi riconosce i tag python... ne come func:`mia.funzione` ne senza . Con rst2html5 mi rende poi proprio il documento non fruibile in quanto piazza dei rettangoli di errore in mezzo al documento. Mentre almeno sphinx non mi da l'errore nel documento ...

Sai come risolvere ?

Se proprio ci devo perdere del tempo mi faccio uno script awk per convertire tutti gli indirizzi. La cosa buffa è che ovviamente non digerisce nemmeno il documento originale di python.org. Sphinx però non l'ho installato con pip in quanto per me tutto quello che è fuori dal sistema ufficiale di pacchettizzazione è il diavolo.

ok, mi hai convinto, ma non ora, più avanti darò un occhio a sphinx, ma prima voglio tradurre almeno 4 o 5 cose. Dopo di che guarderà sia github che sphinx.

Vorrei fare da solo tuttalpiù ti chiederò un parere sulla traduzione a lavoro finito.

Ciao, grazie della risposta.

Sono in tutto d'accordo con te ma per ora non ho intenzione di usare github perché non ho la più pallida idea se e per quanto continuerò questo progetto. Per quanto riguarda reStructutredText invece sicuramente continuerò la traduzione partendo da questo formato perché mi sembra più comodo anche per generare la pagine html e pdf. Ho letto il tuo file CONTRIBUTING.rst e mi è sembrato utile sulla parte della traduzione. Entro qualche giorno dovrei terminare la traduzione dell'howto sulle curses quindi magari farò un post.

Inoltre una delle cose che mi fa rabbia è la gente che dice che una cosa è semplice se invece non lo è. Github non è semplice, non è facile. Bisogna mettersi li e impararlo. Per cui l'uso di github a mio modesto parere complica le cose moltissimo.


Per esempio mi sono letto il tuo CONTRIBUTING e la parte su github non c'ho capito nulla. Prendi per esempio sphinx, che non so neanchè cos'è, vado su wikipedia e mi dice


Sphinx è un software per le ricerche fulltext, progettato per l'integrazione con database basati sul SQL.


Cioè, io per fare due traduzioni mi devo installare un DB SQL impararmi un nuovo software, studiarmi git, dare un occhio a reStruturedText e quindi iniziare... E questo per te sarebbe semplice ?

Purtroppo molti programmatori sono negati per progettare software (stavo per dire sono negati per programmare) perché confondono quello che per loro è facile con quello che per l'utente finale è facile.

ok allora scelgo quello che magari interessa più a me, l'importante è che mi confermiate che non sia già stati tradotti.

Ottimo, oltre questo c'è dell'altro che potrei tradurre ?

Faccio una lista di quello che trovo su python.org e ditemi quello che potrebbe essere interessante..

HOW TO - Programmare con le curses

HOW TO - Logging

HOW TO - Socket

HOW TO - Espressioni Regolari


TUTORIAL - Argparse

FAQ - Programmazione

FAQ - Librerie


La Standard Library Non so se ne vale la pena perché è immensa

Il manuale di riferimento

Il glossario

Le novità di Python 3.8





--- Ultima modifica di Lewis in data 2020-07-23 12:10:50 ---

Ciao,

mi piacerebbe tradurre un po' documentazione ufficiale presa da python.org.

Per esempio mi piacerebbe tradurre il tutorial ufficiale che qui su python.it mi pare sia linkato quello in Inglese ergo ne deduco che non ci sia la versione in italiano.

Che ne pensate ?

Oppure c'è qualcos'altro che vi piacerebbe vedere tradotto ?

Devo chiedere qualche permesso a qualcuno eventualmente ?



--- Ultima modifica di Lewis in data 2020-07-23 11:08:41 ---