From: JazzyNico Date: Sat, 20 Mar 2010 11:18:53 +0000 (+0100) Subject: Doc. HACKING files moved to doc/. X-Git-Url: https://git.tokkee.org/?a=commitdiff_plain;h=bbc1c8db3d31cab76ff4276bc0e0426808609983;p=inkscape.git Doc. HACKING files moved to doc/. --- diff --git a/HACKING.de.txt b/HACKING.de.txt deleted file mode 100644 index b7987b379..000000000 --- a/HACKING.de.txt +++ /dev/null @@ -1,88 +0,0 @@ -Abhängigkeiten -============== -grep Build-Depends debian/control, um eine Liste der (Debian)-Pakete zu -sehen, die zum Compilieren nötig sind. - -Die RPM-Unterstützung ist unvollständig. Die Datei inkscape.spec.in hat -eine partielle Liste der Abhängigkeiten: - - grep Requires inkscape.spec.in - -Momentan beschreibt die Datei nur ein Paket. Wenn Sie eine RPM-basierte -Linux-Distribution benutzen, würden Sie anderen helfen, wenn Sie die -Requires/BuildRequires Zeilen entsprechend updaten. - -Patches -======= - -Wenn Sie keinen BZR Zugang haben, benutzen Sie bitte den Patch Tracker -. - -Wiki -==== - -Lesen Sie bitte http://wiki.inkscape.org/wiki/index.php/CompilingInkscape -um mehr über Compilation zu erfahren, z.B. wo man benötigte Software -finden kann und andere Tips für Entwickler. - - -Zu Inkscape beitragen -===================== -Inkscape begrüßt jeden Ihrer Beiträge der hilft, es zu einem vollständig -SVG-unterstützenden Zeichenprogramm zu machen. - -Während viele der Entwickler am Programm selbst arbeiten, Fehler beheben -und neue Features implementieren, werden auch Ihre anderweitigen -Fähigkeiten gebraucht, um Inkscape noch mächtiger und erfolgreicher -zu machen. Sie haben wahrscheinlich schon längst eine Idee, woran Sie -gerne arbeiten würden. Wenn nicht, hier sind ein paar: - -* Picken Sie sich eine Fehlermeldung aus dem Sourceforge Bug Tracker -heraus und schicken Sie einen Patch ("diff -uNrp" or "cvs diff -up"). -* Wählen Sie eine Verbesserung und implementieren Sie sie. -* Arbeiten Sie an den Übersetzungen im po/ Verzeichnis. -* Versuchen Sie, einen neuen Fehler zu finden, und berichten Sie. -* Helfen Sie, Fragen von neuen Benutzern auf Jabber, IRC oder den -Mailinglisten zu beantworten. -* Entwerfen Sie Dokumente mit Tips oder Hilfen, nutzen Sie unseren Wiki. - - -BZR Zugang -========== -Lesen Sie bitte http://inkscape.org/bzr.php -wie man BZR nutzt oder den Quellenbaum mit einem Browser liest. - -Wir vergeben BZR Zugang an Leute, die ihr Interesse daran bewiesen -haben, den Code zu verbessern. Der Beweis ist einfach: Reichen Sie -zwei Verbesserungen ein und verlangen Sie Zugang. - - -Patch Akzeptanz -=============== -Unser Motto betreffend Veränderungen am Programm ist "Zuerst patchen, -später fragen". Anstatt eine Idee endlos zu debattieren, ermutigen wir -Leute, erst einmal den Code zu schreiben, auch als Prototyp. Das wird -dann in den Zweig der Programmänderungen eingebracht, wo es zunächst -getestet wird. Schwerwiegende und das gesamte Programm betreffende Designentscheidungen sollten natürlich vorher in der devel-Mailingliste -angesprochen werden. - - -Coding Style -============ -Bitte lesen Sie die Coding Style Guidelines -(http://www.inkscape.org/doc/coding_style.php) -Wenn Sie das Dokument nicht interessiert, halten Sie sich bitte -zumindest grob an den Stil des bereits vorhandenen Quelltexts. - - -Makefiles -========= -Das src/Makefile.am bezieht sich auf die Makefile_insert Dateien in -jedem einzelnen Directory. Im Endeffekt bleibt es dadurch eine Datei, -daher sind Definitionen von Variablen (auch INCLUDES etc.) überall -zugänglich. - -Wenn Sie daher ein eigenes Directory mit Makefile erstellen, benutzen -Sie bitte einen Prefix (zB blah_) für lokale Variable in blah/Makefile_insert -oder definieren Sie globale Variable in src/Makefile.am. Insbesondere -sind check_PROGRAMS, DISTCLEANFILES, etc. in src/Makefile.am zu finden. diff --git a/HACKING.fr.txt b/HACKING.fr.txt deleted file mode 100644 index d8540fb6b..000000000 --- a/HACKING.fr.txt +++ /dev/null @@ -1,91 +0,0 @@ -Compiler la version BZR -======================= -grep Build-Depends debian/control permet d'afficher une liste de paquets -(Debian) nécessaires à la compilation. - -inkscape.spec.in contient une liste partielle de spécifications : - - grep Requires inkscape.spec.in - -Au moment où ce texte est écrit, il n'y a qu'un paquet ; si vous utilisez une -distribution basée sur des RPM, pensez à mettre à jour les lignes -Requires/BuildRequires afin d'aider les autres utilisateurs de votre -distribution. Si vous n'avez pas d'accès en écriture au BZR, vous pouvez -soumettre un patch auprès de -. - - -Consulter http://wiki.inkscape.org/wiki/index.php/CompilingInkscape pour des -remarques plus complètes sur la compilation, comprenant des explications sur -comment trouver les paquets nécessaires pour votre distribution et des -suggestions pour les développeurs. - - -Contribuer à Inkscape -===================== -Inkscape accepte volontiers vos contributions pour aider à en faire un -programme de dessin totalement conforme à la norme SVG pour la communeauté du -logiciel libre. - -Alors que beaucoup de développeurs travaillent sur la correction de bugs et la -création de nouvelles fonctionnalités, il est important de noter que même les -non-programmeurs peuvent contribuer à la puissance et au succès d'Inkscape. -Vous avez probablement une idée d'une chose sur laquelle vous aimeriez -travailler. Sinon, voivi quelques façons d'apporter votre aide : - - * Sélectionner un bug, le corriger et envoyer un path ("diff -uNrp" ou - "cvs diff -up") - * Choisir une fonctionnalité que vous aimeriez développer et la coder - * Si vous maîtrisez une langue en plus de l'anglais, travailler sur le - fichier i18n de celle-ci dans le répertoire /po - * Trouver un nouveau bug et le rapporter - * Aider à répondre aux questions des nouveaux "Inkscapeurs" sur Jabber, IRC - ou les mailing lists - * Ecrire un article pour la promotion d'Inkscape - * Ecrire un HOWTO décrivant une astuce ou technique que vous avez trouvé - - -Accès BZR -========= -Consultez http://inkscape.org/bzr.php pour voir comment accéder au BZR, y -compris depuis un navigateur web. -Nous donnons un accès en écriture au BZR à toute personne ayant démontré une -motivation pour aider à développer le code. Prouver votre motivation est très -simple : fournir deux contributions et demander un accès. - - -Décisions de patch -================== -Notre ligne de conduite quant aux modifications du code est "coder d'abord, -poser les questions ensuite". Quand quelqu'un a une idée, plutôt que de la -débattre sans fin, nous encourageons les gens à aller de l'avant et coder -quelquechose (même un prototypage). Ce code est ensuite incorporé dans la -branche de développement afin de l'essayer, le tester, le pousser et -l'améliorer. Nous pensons que la meilleure façon de vérifier qu'une idée est -bonne est de la tester en conditions réelles. - - -Style de codage -=============== -Veuillez consulter les recommandations de style de codage -(http://www.inkscape.org/doc/coding_style.php) si vous avez des questions -spécifiques quant au style à utiliser dans le code. Si lire ces recommandations -ne vous intéresse pas, inspirez-vous du style du code environnant, de façon à -rester au moins cohérent. - - -Makefiles -========= -Les fichiers Makefiles du répertoire src sont plus ou moins fusionnés dans le -fichier src/Makefile.am qui fournit les informations nécessaires aux fichiers -Makefile_insert de chaque répertoire. - -Notez que cela ne reste logiquement qu'un fichier, donc les définitions de -variables (comme les INCLUDES etc.) sont partagées, et les variables définies -dans un Makefile_insert peuvent être utilisées dans un autre. - -En conséquence, envisagez soit d'ajouter un préfixe `blah_' au nom de toutes -les variables que vous définiriez dans blah/Makefile_insert (si cela doit -rester local pour ce Makefile_insert), ou en mettre la définition dans -src/Makefile.am. En particulier, les fichiers check_PROGRAMS, DISTCLEANFILES, -etc sont dans src/Makefile.am. diff --git a/HACKING.it.txt b/HACKING.it.txt deleted file mode 100644 index eb9d4c978..000000000 --- a/HACKING.it.txt +++ /dev/null @@ -1,83 +0,0 @@ -Compilare la versione BZR -========================= -Esegui `grep Build-Depends debian/control` per avere una lista dei pacchetti (Debian) -necessari per la compilazione. - -inkscape.spec.in contiene una lista parziale dei requisiti: - - grep Requires inkscape.spec.in - -Al momento, questa lista contiene un solo pacchetto; se usi usa distribuzione -basata su RPM, sei pregato di aggiornare le linee Requires/BuildRequires in modo -da aiutare gli altri utenti della tua stessa distribuzione. Se non hai accesso in -scrittura al BZR, puoi inviare una patch al sistema di gestione delle patch -. - -Consulta http://wiki.inkscape.org/wiki/index.php/CompilingInkscape per informazioni -più generali sulla compilazione, incluso come trovare i pacchetti necessari per la -propria distribuzione e alcuni suggerimenti per gli sviluppatori. - - -Contribuire a Inkscape -======================== -Inkscape accetta volentieri i tuoi contributi per lo sviluppo -di un programma di disegno completamente compatibile con SVG -per la comunità Open Source. - -Mentre diversi sviluppatori lavorano per correggere i bug o implementare -nuove funzioni, è comunque necessario che anche i non programmatori contribuiscano -a rendere Inkscape uno strumento utile e potente. -Probabilmente tu hai già un'idea a proposito di cosa potresti occuparti. -In caso contrario, questi sono solo alcuni suggerimenti: - - * Controlla un bug, correggilo e manda una patch ("diff -uNrp" o "cvs diff -up") - * Scegli una funzione che ti piacerebbe fosse implementata e sviluppala - * Se parli un'altra lingua che non sia l'inglese, lavora sul file per l'i18n della tua - lingua disponibile nella cartella po/ - * Scopri nuovi bug e segnalali - * Rispondi a domande dei nuovi utenti su Jabber, IRC o mailing list - * Scrivi un articolo per pubblicizzare Inkscape - * Scrivi un HOWTO su qualche trucco o tecnica che trovi utile - - -Accesso BZR -=========== -Consulta http://inkscape.org/bzr.php per i modi di accesso al BZR, -tra la consultazione del BZR client web. - -L'acceso in scrittura al BZR viene dato a tutti quelli che dimostrino interesse -nello sviluppo del codice. La prova è semplice: fornisci un paio di contributi e richiedi -l'accesso. - - -Implementazione delle patch -=============== -Il nostro motto per i cambiamenti del codice è "Prima sviluppa, poi parla". -Quando qualcuno ha un'idea, invece di parlarne a lungo e senza risultati, è -meglio che prosegua e sviluppi qualcosa (anche solo un prototipo). -Questo verrà incorporato nel ramo di sviluppo per essere testato, migliorato -e commentato. Lo schema è semplice: il migliore modo per giudicare un'idea è -vederla in azione. - - -Stile del codice -============ -Consulta le Linee Guida per lo Stile del codice -(http://www.inkscape.org/doc/coding_style.php) se hai delle domande specifiche -sullo stile. Se non fosse sufficiente, adeguati allo stile del codice già presente, -in modo da avere un minimo di coerenza. - -Makefile -========= -Tutti i Makefile sotto alla directory src sono grosso modo fusi in un unico src/Makefile.am -che attinge dai vari Makefile_insert delle directory. - -Esso è comunque un'unico file, per cui le definizioni delle variabili (anche di -INCLUDES ecc.) sono condivise, e le variabili definite in un -Makefile_insert possono essere usate in un altro. - -Quindi, prendi in considerazione il consiglio di aggiungere un prefisso (tipo `blah_') -al nome delle variabili definite in blah/Makefile_insert (se il loro ambito è locale), o -inserisci le definizioni in src/Makefile.am. In particolare, -controlla che check_PROGRAMS, DISTCLEANFILES, etc. siano in src/Makefile.am. - diff --git a/HACKING.pt_BR.txt b/HACKING.pt_BR.txt deleted file mode 100644 index 6aee17e96..000000000 --- a/HACKING.pt_BR.txt +++ /dev/null @@ -1,86 +0,0 @@ -Compilando a versão BZR -======================= -grep Build-Depends debian/control para ver a lista de pacotes (Debian) -necessários para compilação. - -inkscape.spec.in tem uma lista parcial dos requerimentos: - - grep Requires inkscape.spec.in - -No momento da escrita, esse contém apenas um pacote; se você usa uma distribuição -baseada em RPM, então por favor considere atualizar as linhas de Requires/BuildRequires -(Requerimentos) para ajudar outros usuários de sua distribuição. Se você não -tem acesso de escrita ao BZR, então você pode submeter uma correção pra o -patch tracker -. - - -Visite http://wiki.inkscape.org/wiki/index.php/CompilingInkscape para observações -mais gerais sobre a compilação, incluindo como encontrar algum dos pacotes -necessários para sua distribuição, e sugestões para os desenvolvedores. - - -Contribuindo com Inkscape -========================= -Inkscape agradece as suas contribuições para ajudar a torná-lo um -programa de desenho inteiramente "SVG-Compliant" para a comunidade Open Source - -Enquanto muitos desenvolvedores trabalham consertando bugs e criando novas -funções, vale fortmente enfatizar que até não programadores podem ajudar a fazer -do Inkscape mais poderoso e bem sucedido. Você provavelmente já tem alguma idéia -sobre algo no qual gostaria de trabalhar. Se não, aqui estão algumas formas de -ajudar: - - * Escolha um bug, corrija-o, e envie um patch ("diff -uNrp" ou "cvs diff -up") - * Escolha uma função que gostaria de ver desenvolvida, e faça-a - * Se você fala alguma língua além do Inglês, trabalhe no arquivo i18n da - sua lingua na pasta "po/" - * Ache um novo bug e reporte-o - * Ajude a responder perguntas de novos Inkscapers no Jabber, IRC, ou na - Lista de Discussão - * Escreva um artigo defendendo o Inkscape - * Escreva um HOWTO descrevendo um truque ou uma técnica que tenha descoberto - - -Acesso BZR -========== -Visite http://inkscape.org/bzr.php, para saber como acessar o BZR, -incluindo navegar no BZR de um navegador Web. - -Nós damos permissão de escrita no BZR para pessoas com provado interesse em -ajudar a desenvolder a base de código. Provar seu interesse é direto: Faça duas -contribuições e peça acesso. - - -Decisões de Correção -=================== -Nosso principio para mudar a base de codigo é "Corrija primeiro, faça perguntas -depois". Quando alguem tem uma idéia, melhor que debater-la infinitament, nos -os encorajamos a ir em frente e codificar algo(ou mesmo prototipar). -Isto é então incorporado ao codigo de desenvolvimento para ser testado, -"poke and prod", e tentado o reparo. Nós concluimos que, a melhor maneira -de ver se uma ideia funciona é testando-a. - - -Padrão de Codificação -==================== -Por favor consulte o Guia de Padrão de Codificação -(http://www.inkscape.org/doc/coding_style.php) se você tem questões especificas -no padrão a se usar para codificar. Se ler o guia de padrão para codificação não é do -seu interesse, apenas siga o estilo geral do código vizinho, de modo que o código seja -pelo menos consistente. - - -Makefiles -========= -Os Makefiles no diretório src são mais ou menos fundidos em um -src/Makefile.am que é fonte para o arquivo Makefile_insert de cada diretório. - -Note que logicamente são apenas um arquivo, entao definições de variáveis -(incluindo INCLUDES etc.) sao compartilhados, e variáveis definidaas em um -Makefile_insert podem ser usadas em outro. - -Assim, considere adicionar qualquer "bla_" prefixo ao nome de qualquer variável que -voce defina em bla/Makefile_insert (se pretender-se que seja local a este -Makefile_insert), ou colque a definição em. Particularment, note que -check_PROGRAMS, DISTCLEANFILES, etc, estão no src/Makefile.am. diff --git a/HACKING.txt b/HACKING.txt deleted file mode 100644 index 7fec67de1..000000000 --- a/HACKING.txt +++ /dev/null @@ -1,86 +0,0 @@ -Compiling the BZR version -========================= -grep Build-Depends debian/control to see a list of (Debian) packages needed for -compilation. - -inkscape.spec.in has a partial list of requirements: - - grep Requires inkscape.spec.in - -At the time of writing, it contains only one package; if you use an RPM-based -distribution, then please consider updating the Requires/BuildRequires lines to -help other users of your distribution. If you don't have BZR write access, -then you can submit a patch to the bug tracker -. - - -See http://wiki.inkscape.org/wiki/index.php/CompilingInkscape for more general -remarks about compiling, including how to find some of the needed packages for -your distribution, and suggestions for developers. - - -Contributing to Inkscape -======================== -Inkscape welcomes your contributions to help turn it into a fully -SVG-compliant drawing program for the Open Source community. - -While many developers work on fixing bugs and creating new features, it -is worth strong emphasis that even non-programmers can help make -Inkscape more powerful and successful. You probably already have an idea -of something you'd like to work on. If not, here are just a few ways you -can help: - - * Pick a bug, fix it, and send in a patch ("diff -uNrp" or "cvs diff -up") - * Choose a feature you want to see developed, and make it - * If you speak a language in addition to English, work on your - language's i18n file in the po/ directory - * Find a new bug and report it - * Help answer questions for new Inkscapers on Jabber, IRC or the - mailing lists - * Write an article advocating Inkscape - * Author a HOWTO describing a trick or technique you've figured out - - -BZR Access -========== -See http://inkscape.org/bzr.php for how to access BZR, -including browsing BZR from a web client. - -We give BZR write access out to people with proven interest in helping develop -the codebase. Proving your interest is straightforward: Make two -contributions and request access. - - -Patch Decisions -=============== -Our motto for changes to the codebase is "Patch first, ask questions -later". When someone has an idea, rather than endlessly debating it, we -encourage folks to go ahead and code something up (even prototypish). -This is then incorporated into the development branch of the code for -folks to try out, poke and prod, and tinker with. We figure, the best -way to see if an idea fits is to try it on for size. - - -Coding Style -============ -Please refer to the Coding Style Guidelines -(http://www.inkscape.org/doc/coding_style.php) if you have specific questions -on the style to use for code. If reading style guidelines doesn't interest -you, just follow the general style of the surrounding code, so that it is at -least consistent. - - -Makefiles -========= -Makefiles under the src directory are all more or less merged into one -src/Makefile.am that sources the Makefile_insert files from each directory. - -Note that it's still logically just one file, so variable definitions -(including INCLUDES etc.) are shared, and variables defined in one -Makefile_insert can be used in another. - -Thus, consider either adding a `blah_' prefix to the name of any variables you -define in blah/Makefile_insert (if it's intended to be local to that -Makefile_insert), or putting the definition in src/Makefile.am. In particular, -note that check_PROGRAMS, DISTCLEANFILES, etc. are in src/Makefile.am. - diff --git a/Makefile.am b/Makefile.am index f07cf6979..4ec12fa34 100644 --- a/Makefile.am +++ b/Makefile.am @@ -39,8 +39,7 @@ EXTRA_DIST = \ Info.plist.in \ Info.plist \ buildtool.cpp build.xml \ - README README.ca.txt README.de.txt README.es.txt README.fr.txt README.it.txt \ - HACKING.txt HACKING.de.txt HACKING.fr.txt HACKING.it.txt \ + README README.ca.txt README.de.txt README.es.txt README.fr.txt README.it.txt README.osx.txt README.pt_BR.txt README.sk.txt README.sr.txt \ TRANSLATORS \ inkscape.png \ inkscape.ico \ diff --git a/doc/HACKING.de.txt b/doc/HACKING.de.txt new file mode 100644 index 000000000..b7987b379 --- /dev/null +++ b/doc/HACKING.de.txt @@ -0,0 +1,88 @@ +Abhängigkeiten +============== +grep Build-Depends debian/control, um eine Liste der (Debian)-Pakete zu +sehen, die zum Compilieren nötig sind. + +Die RPM-Unterstützung ist unvollständig. Die Datei inkscape.spec.in hat +eine partielle Liste der Abhängigkeiten: + + grep Requires inkscape.spec.in + +Momentan beschreibt die Datei nur ein Paket. Wenn Sie eine RPM-basierte +Linux-Distribution benutzen, würden Sie anderen helfen, wenn Sie die +Requires/BuildRequires Zeilen entsprechend updaten. + +Patches +======= + +Wenn Sie keinen BZR Zugang haben, benutzen Sie bitte den Patch Tracker +. + +Wiki +==== + +Lesen Sie bitte http://wiki.inkscape.org/wiki/index.php/CompilingInkscape +um mehr über Compilation zu erfahren, z.B. wo man benötigte Software +finden kann und andere Tips für Entwickler. + + +Zu Inkscape beitragen +===================== +Inkscape begrüßt jeden Ihrer Beiträge der hilft, es zu einem vollständig +SVG-unterstützenden Zeichenprogramm zu machen. + +Während viele der Entwickler am Programm selbst arbeiten, Fehler beheben +und neue Features implementieren, werden auch Ihre anderweitigen +Fähigkeiten gebraucht, um Inkscape noch mächtiger und erfolgreicher +zu machen. Sie haben wahrscheinlich schon längst eine Idee, woran Sie +gerne arbeiten würden. Wenn nicht, hier sind ein paar: + +* Picken Sie sich eine Fehlermeldung aus dem Sourceforge Bug Tracker +heraus und schicken Sie einen Patch ("diff -uNrp" or "cvs diff -up"). +* Wählen Sie eine Verbesserung und implementieren Sie sie. +* Arbeiten Sie an den Übersetzungen im po/ Verzeichnis. +* Versuchen Sie, einen neuen Fehler zu finden, und berichten Sie. +* Helfen Sie, Fragen von neuen Benutzern auf Jabber, IRC oder den +Mailinglisten zu beantworten. +* Entwerfen Sie Dokumente mit Tips oder Hilfen, nutzen Sie unseren Wiki. + + +BZR Zugang +========== +Lesen Sie bitte http://inkscape.org/bzr.php +wie man BZR nutzt oder den Quellenbaum mit einem Browser liest. + +Wir vergeben BZR Zugang an Leute, die ihr Interesse daran bewiesen +haben, den Code zu verbessern. Der Beweis ist einfach: Reichen Sie +zwei Verbesserungen ein und verlangen Sie Zugang. + + +Patch Akzeptanz +=============== +Unser Motto betreffend Veränderungen am Programm ist "Zuerst patchen, +später fragen". Anstatt eine Idee endlos zu debattieren, ermutigen wir +Leute, erst einmal den Code zu schreiben, auch als Prototyp. Das wird +dann in den Zweig der Programmänderungen eingebracht, wo es zunächst +getestet wird. Schwerwiegende und das gesamte Programm betreffende Designentscheidungen sollten natürlich vorher in der devel-Mailingliste +angesprochen werden. + + +Coding Style +============ +Bitte lesen Sie die Coding Style Guidelines +(http://www.inkscape.org/doc/coding_style.php) +Wenn Sie das Dokument nicht interessiert, halten Sie sich bitte +zumindest grob an den Stil des bereits vorhandenen Quelltexts. + + +Makefiles +========= +Das src/Makefile.am bezieht sich auf die Makefile_insert Dateien in +jedem einzelnen Directory. Im Endeffekt bleibt es dadurch eine Datei, +daher sind Definitionen von Variablen (auch INCLUDES etc.) überall +zugänglich. + +Wenn Sie daher ein eigenes Directory mit Makefile erstellen, benutzen +Sie bitte einen Prefix (zB blah_) für lokale Variable in blah/Makefile_insert +oder definieren Sie globale Variable in src/Makefile.am. Insbesondere +sind check_PROGRAMS, DISTCLEANFILES, etc. in src/Makefile.am zu finden. diff --git a/doc/HACKING.fr.txt b/doc/HACKING.fr.txt new file mode 100644 index 000000000..d8540fb6b --- /dev/null +++ b/doc/HACKING.fr.txt @@ -0,0 +1,91 @@ +Compiler la version BZR +======================= +grep Build-Depends debian/control permet d'afficher une liste de paquets +(Debian) nécessaires à la compilation. + +inkscape.spec.in contient une liste partielle de spécifications : + + grep Requires inkscape.spec.in + +Au moment où ce texte est écrit, il n'y a qu'un paquet ; si vous utilisez une +distribution basée sur des RPM, pensez à mettre à jour les lignes +Requires/BuildRequires afin d'aider les autres utilisateurs de votre +distribution. Si vous n'avez pas d'accès en écriture au BZR, vous pouvez +soumettre un patch auprès de +. + + +Consulter http://wiki.inkscape.org/wiki/index.php/CompilingInkscape pour des +remarques plus complètes sur la compilation, comprenant des explications sur +comment trouver les paquets nécessaires pour votre distribution et des +suggestions pour les développeurs. + + +Contribuer à Inkscape +===================== +Inkscape accepte volontiers vos contributions pour aider à en faire un +programme de dessin totalement conforme à la norme SVG pour la communeauté du +logiciel libre. + +Alors que beaucoup de développeurs travaillent sur la correction de bugs et la +création de nouvelles fonctionnalités, il est important de noter que même les +non-programmeurs peuvent contribuer à la puissance et au succès d'Inkscape. +Vous avez probablement une idée d'une chose sur laquelle vous aimeriez +travailler. Sinon, voivi quelques façons d'apporter votre aide : + + * Sélectionner un bug, le corriger et envoyer un path ("diff -uNrp" ou + "cvs diff -up") + * Choisir une fonctionnalité que vous aimeriez développer et la coder + * Si vous maîtrisez une langue en plus de l'anglais, travailler sur le + fichier i18n de celle-ci dans le répertoire /po + * Trouver un nouveau bug et le rapporter + * Aider à répondre aux questions des nouveaux "Inkscapeurs" sur Jabber, IRC + ou les mailing lists + * Ecrire un article pour la promotion d'Inkscape + * Ecrire un HOWTO décrivant une astuce ou technique que vous avez trouvé + + +Accès BZR +========= +Consultez http://inkscape.org/bzr.php pour voir comment accéder au BZR, y +compris depuis un navigateur web. +Nous donnons un accès en écriture au BZR à toute personne ayant démontré une +motivation pour aider à développer le code. Prouver votre motivation est très +simple : fournir deux contributions et demander un accès. + + +Décisions de patch +================== +Notre ligne de conduite quant aux modifications du code est "coder d'abord, +poser les questions ensuite". Quand quelqu'un a une idée, plutôt que de la +débattre sans fin, nous encourageons les gens à aller de l'avant et coder +quelquechose (même un prototypage). Ce code est ensuite incorporé dans la +branche de développement afin de l'essayer, le tester, le pousser et +l'améliorer. Nous pensons que la meilleure façon de vérifier qu'une idée est +bonne est de la tester en conditions réelles. + + +Style de codage +=============== +Veuillez consulter les recommandations de style de codage +(http://www.inkscape.org/doc/coding_style.php) si vous avez des questions +spécifiques quant au style à utiliser dans le code. Si lire ces recommandations +ne vous intéresse pas, inspirez-vous du style du code environnant, de façon à +rester au moins cohérent. + + +Makefiles +========= +Les fichiers Makefiles du répertoire src sont plus ou moins fusionnés dans le +fichier src/Makefile.am qui fournit les informations nécessaires aux fichiers +Makefile_insert de chaque répertoire. + +Notez que cela ne reste logiquement qu'un fichier, donc les définitions de +variables (comme les INCLUDES etc.) sont partagées, et les variables définies +dans un Makefile_insert peuvent être utilisées dans un autre. + +En conséquence, envisagez soit d'ajouter un préfixe `blah_' au nom de toutes +les variables que vous définiriez dans blah/Makefile_insert (si cela doit +rester local pour ce Makefile_insert), ou en mettre la définition dans +src/Makefile.am. En particulier, les fichiers check_PROGRAMS, DISTCLEANFILES, +etc sont dans src/Makefile.am. diff --git a/doc/HACKING.it.txt b/doc/HACKING.it.txt new file mode 100644 index 000000000..eb9d4c978 --- /dev/null +++ b/doc/HACKING.it.txt @@ -0,0 +1,83 @@ +Compilare la versione BZR +========================= +Esegui `grep Build-Depends debian/control` per avere una lista dei pacchetti (Debian) +necessari per la compilazione. + +inkscape.spec.in contiene una lista parziale dei requisiti: + + grep Requires inkscape.spec.in + +Al momento, questa lista contiene un solo pacchetto; se usi usa distribuzione +basata su RPM, sei pregato di aggiornare le linee Requires/BuildRequires in modo +da aiutare gli altri utenti della tua stessa distribuzione. Se non hai accesso in +scrittura al BZR, puoi inviare una patch al sistema di gestione delle patch +. + +Consulta http://wiki.inkscape.org/wiki/index.php/CompilingInkscape per informazioni +più generali sulla compilazione, incluso come trovare i pacchetti necessari per la +propria distribuzione e alcuni suggerimenti per gli sviluppatori. + + +Contribuire a Inkscape +======================== +Inkscape accetta volentieri i tuoi contributi per lo sviluppo +di un programma di disegno completamente compatibile con SVG +per la comunità Open Source. + +Mentre diversi sviluppatori lavorano per correggere i bug o implementare +nuove funzioni, è comunque necessario che anche i non programmatori contribuiscano +a rendere Inkscape uno strumento utile e potente. +Probabilmente tu hai già un'idea a proposito di cosa potresti occuparti. +In caso contrario, questi sono solo alcuni suggerimenti: + + * Controlla un bug, correggilo e manda una patch ("diff -uNrp" o "cvs diff -up") + * Scegli una funzione che ti piacerebbe fosse implementata e sviluppala + * Se parli un'altra lingua che non sia l'inglese, lavora sul file per l'i18n della tua + lingua disponibile nella cartella po/ + * Scopri nuovi bug e segnalali + * Rispondi a domande dei nuovi utenti su Jabber, IRC o mailing list + * Scrivi un articolo per pubblicizzare Inkscape + * Scrivi un HOWTO su qualche trucco o tecnica che trovi utile + + +Accesso BZR +=========== +Consulta http://inkscape.org/bzr.php per i modi di accesso al BZR, +tra la consultazione del BZR client web. + +L'acceso in scrittura al BZR viene dato a tutti quelli che dimostrino interesse +nello sviluppo del codice. La prova è semplice: fornisci un paio di contributi e richiedi +l'accesso. + + +Implementazione delle patch +=============== +Il nostro motto per i cambiamenti del codice è "Prima sviluppa, poi parla". +Quando qualcuno ha un'idea, invece di parlarne a lungo e senza risultati, è +meglio che prosegua e sviluppi qualcosa (anche solo un prototipo). +Questo verrà incorporato nel ramo di sviluppo per essere testato, migliorato +e commentato. Lo schema è semplice: il migliore modo per giudicare un'idea è +vederla in azione. + + +Stile del codice +============ +Consulta le Linee Guida per lo Stile del codice +(http://www.inkscape.org/doc/coding_style.php) se hai delle domande specifiche +sullo stile. Se non fosse sufficiente, adeguati allo stile del codice già presente, +in modo da avere un minimo di coerenza. + +Makefile +========= +Tutti i Makefile sotto alla directory src sono grosso modo fusi in un unico src/Makefile.am +che attinge dai vari Makefile_insert delle directory. + +Esso è comunque un'unico file, per cui le definizioni delle variabili (anche di +INCLUDES ecc.) sono condivise, e le variabili definite in un +Makefile_insert possono essere usate in un altro. + +Quindi, prendi in considerazione il consiglio di aggiungere un prefisso (tipo `blah_') +al nome delle variabili definite in blah/Makefile_insert (se il loro ambito è locale), o +inserisci le definizioni in src/Makefile.am. In particolare, +controlla che check_PROGRAMS, DISTCLEANFILES, etc. siano in src/Makefile.am. + diff --git a/doc/HACKING.pt_BR.txt b/doc/HACKING.pt_BR.txt new file mode 100644 index 000000000..6aee17e96 --- /dev/null +++ b/doc/HACKING.pt_BR.txt @@ -0,0 +1,86 @@ +Compilando a versão BZR +======================= +grep Build-Depends debian/control para ver a lista de pacotes (Debian) +necessários para compilação. + +inkscape.spec.in tem uma lista parcial dos requerimentos: + + grep Requires inkscape.spec.in + +No momento da escrita, esse contém apenas um pacote; se você usa uma distribuição +baseada em RPM, então por favor considere atualizar as linhas de Requires/BuildRequires +(Requerimentos) para ajudar outros usuários de sua distribuição. Se você não +tem acesso de escrita ao BZR, então você pode submeter uma correção pra o +patch tracker +. + + +Visite http://wiki.inkscape.org/wiki/index.php/CompilingInkscape para observações +mais gerais sobre a compilação, incluindo como encontrar algum dos pacotes +necessários para sua distribuição, e sugestões para os desenvolvedores. + + +Contribuindo com Inkscape +========================= +Inkscape agradece as suas contribuições para ajudar a torná-lo um +programa de desenho inteiramente "SVG-Compliant" para a comunidade Open Source + +Enquanto muitos desenvolvedores trabalham consertando bugs e criando novas +funções, vale fortmente enfatizar que até não programadores podem ajudar a fazer +do Inkscape mais poderoso e bem sucedido. Você provavelmente já tem alguma idéia +sobre algo no qual gostaria de trabalhar. Se não, aqui estão algumas formas de +ajudar: + + * Escolha um bug, corrija-o, e envie um patch ("diff -uNrp" ou "cvs diff -up") + * Escolha uma função que gostaria de ver desenvolvida, e faça-a + * Se você fala alguma língua além do Inglês, trabalhe no arquivo i18n da + sua lingua na pasta "po/" + * Ache um novo bug e reporte-o + * Ajude a responder perguntas de novos Inkscapers no Jabber, IRC, ou na + Lista de Discussão + * Escreva um artigo defendendo o Inkscape + * Escreva um HOWTO descrevendo um truque ou uma técnica que tenha descoberto + + +Acesso BZR +========== +Visite http://inkscape.org/bzr.php, para saber como acessar o BZR, +incluindo navegar no BZR de um navegador Web. + +Nós damos permissão de escrita no BZR para pessoas com provado interesse em +ajudar a desenvolder a base de código. Provar seu interesse é direto: Faça duas +contribuições e peça acesso. + + +Decisões de Correção +=================== +Nosso principio para mudar a base de codigo é "Corrija primeiro, faça perguntas +depois". Quando alguem tem uma idéia, melhor que debater-la infinitament, nos +os encorajamos a ir em frente e codificar algo(ou mesmo prototipar). +Isto é então incorporado ao codigo de desenvolvimento para ser testado, +"poke and prod", e tentado o reparo. Nós concluimos que, a melhor maneira +de ver se uma ideia funciona é testando-a. + + +Padrão de Codificação +==================== +Por favor consulte o Guia de Padrão de Codificação +(http://www.inkscape.org/doc/coding_style.php) se você tem questões especificas +no padrão a se usar para codificar. Se ler o guia de padrão para codificação não é do +seu interesse, apenas siga o estilo geral do código vizinho, de modo que o código seja +pelo menos consistente. + + +Makefiles +========= +Os Makefiles no diretório src são mais ou menos fundidos em um +src/Makefile.am que é fonte para o arquivo Makefile_insert de cada diretório. + +Note que logicamente são apenas um arquivo, entao definições de variáveis +(incluindo INCLUDES etc.) sao compartilhados, e variáveis definidaas em um +Makefile_insert podem ser usadas em outro. + +Assim, considere adicionar qualquer "bla_" prefixo ao nome de qualquer variável que +voce defina em bla/Makefile_insert (se pretender-se que seja local a este +Makefile_insert), ou colque a definição em. Particularment, note que +check_PROGRAMS, DISTCLEANFILES, etc, estão no src/Makefile.am. diff --git a/doc/HACKING.txt b/doc/HACKING.txt new file mode 100644 index 000000000..7fec67de1 --- /dev/null +++ b/doc/HACKING.txt @@ -0,0 +1,86 @@ +Compiling the BZR version +========================= +grep Build-Depends debian/control to see a list of (Debian) packages needed for +compilation. + +inkscape.spec.in has a partial list of requirements: + + grep Requires inkscape.spec.in + +At the time of writing, it contains only one package; if you use an RPM-based +distribution, then please consider updating the Requires/BuildRequires lines to +help other users of your distribution. If you don't have BZR write access, +then you can submit a patch to the bug tracker +. + + +See http://wiki.inkscape.org/wiki/index.php/CompilingInkscape for more general +remarks about compiling, including how to find some of the needed packages for +your distribution, and suggestions for developers. + + +Contributing to Inkscape +======================== +Inkscape welcomes your contributions to help turn it into a fully +SVG-compliant drawing program for the Open Source community. + +While many developers work on fixing bugs and creating new features, it +is worth strong emphasis that even non-programmers can help make +Inkscape more powerful and successful. You probably already have an idea +of something you'd like to work on. If not, here are just a few ways you +can help: + + * Pick a bug, fix it, and send in a patch ("diff -uNrp" or "cvs diff -up") + * Choose a feature you want to see developed, and make it + * If you speak a language in addition to English, work on your + language's i18n file in the po/ directory + * Find a new bug and report it + * Help answer questions for new Inkscapers on Jabber, IRC or the + mailing lists + * Write an article advocating Inkscape + * Author a HOWTO describing a trick or technique you've figured out + + +BZR Access +========== +See http://inkscape.org/bzr.php for how to access BZR, +including browsing BZR from a web client. + +We give BZR write access out to people with proven interest in helping develop +the codebase. Proving your interest is straightforward: Make two +contributions and request access. + + +Patch Decisions +=============== +Our motto for changes to the codebase is "Patch first, ask questions +later". When someone has an idea, rather than endlessly debating it, we +encourage folks to go ahead and code something up (even prototypish). +This is then incorporated into the development branch of the code for +folks to try out, poke and prod, and tinker with. We figure, the best +way to see if an idea fits is to try it on for size. + + +Coding Style +============ +Please refer to the Coding Style Guidelines +(http://www.inkscape.org/doc/coding_style.php) if you have specific questions +on the style to use for code. If reading style guidelines doesn't interest +you, just follow the general style of the surrounding code, so that it is at +least consistent. + + +Makefiles +========= +Makefiles under the src directory are all more or less merged into one +src/Makefile.am that sources the Makefile_insert files from each directory. + +Note that it's still logically just one file, so variable definitions +(including INCLUDES etc.) are shared, and variables defined in one +Makefile_insert can be used in another. + +Thus, consider either adding a `blah_' prefix to the name of any variables you +define in blah/Makefile_insert (if it's intended to be local to that +Makefile_insert), or putting the definition in src/Makefile.am. In particular, +note that check_PROGRAMS, DISTCLEANFILES, etc. are in src/Makefile.am. + diff --git a/doc/Makefile.am b/doc/Makefile.am index fec2189b3..a40af1eb8 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -3,6 +3,11 @@ EXTRA_DIST = README.document \ architecture.txt \ class-hierarchy.dia \ coordinates.txt \ + HACKING.de.txt \ + HACKING.fr.txt \ + HACKING.it.txt \ + HACKING.pt_BR.txt \ + HACKING.txt \ keys.README \ keys.xml \ keys.de.xml \