diff --git a/i2p2www/pages/site/get-involved/guides/new-developers.html b/i2p2www/pages/site/get-involved/guides/new-developers.html index b4615daa..a2d0178a 100644 --- a/i2p2www/pages/site/get-involved/guides/new-developers.html +++ b/i2p2www/pages/site/get-involved/guides/new-developers.html @@ -1,186 +1,190 @@ {% extends "global/layout.html" %} -{% block title %}New Developer's Guide{% endblock %} +{% block title %}{% trans %}New Developer's Guide{% endtrans %}{% endblock %} {% block content %} -

- So you want to start work on I2P? Great! - Here's a quick guide to getting started - on contributing to the website or the software, doing development or creating translations. -

-

- Not quite ready for coding? - Try getting involved first. -

+

{% trans %} +So you want to start work on I2P? Great! +Here's a quick guide to getting started +on contributing to the website or the software, doing development or creating translations. +{%- endtrans %}

+

{% trans volunteer=site_url('get-involved') %} +Not quite ready for coding? +Try getting involved first. +{%- endtrans %}

    -
  1. Basic study
    2. -
  2. Getting the I2P code
    3. -
  3. Building I2P
    4. -
  4. Development ideas
    5. -
  5. Making the results available
    6. -
  6. Get to know us!
    7. -
  7. Translations
    8. -
  8. Tools
    9. +
  9. {% trans %}Basic study{% endtrans %}
    10. +
  10. {% trans %}Getting the I2P code{% endtrans %}
    11. +
  11. {% trans %}Building I2P{% endtrans %}
    12. +
  12. {% trans %}Development ideas{% endtrans %}
    13. +
  13. {% trans %}Making the results available{% endtrans %}
    14. +
  14. {% trans %}Get to know us!{% endtrans %}
    15. +
  15. {% trans %}Translations{% endtrans %}
    16. +
  16. {% trans %}Tools{% endtrans %}
-

Basic 'study'

+

{% trans %}Basic study{% endtrans %}

-

- Basic development on the I2P router or the embedded applications uses Java as the main development language. - If you don't have experience with Java, you can always have a look at Thinking in Java. -

-

- Study the how intro, - the other "how" documents, - the tech intro, - and associated documents. - These will give you a good overview of how I2P is structured and what different things it does. -

+

{% trans -%} +Basic development on the I2P router or the embedded applications uses Java as the main development language. +If you don't have experience with Java, you can always have a look at Thinking in Java. +{%- endtrans %}

+

{% trans intro=site_url('docs/how/intro'), docs=site_url('docs'), techintro=site_url('docs/how/tech-intro') -%} +Study the how intro, +the other "how" documents, +the tech intro, +and associated documents. +These will give you a good overview of how I2P is structured and what different things it does. +{%- endtrans %}

-

Getting the I2P code

+

{% trans %}Getting the I2P code{% endtrans %}

-

- For development on the i2p router or the embedded applications, - get the monotone source repository installed - short instructions: -

+

{% trans -%} +For development on the i2p router or the embedded applications, +get the monotone source repository installed - short instructions: +{%- endtrans %}

-

Remarks

-

- To download the website files instead of the I2P source files, use 'i2p.www' instead of 'i2p.i2p'. -

-

- The initial pull may take several hours using the tunnel. - If it fails after a partial pull, simply rerun it, it will start where it left off. - If you are in a hurry, use the non-anonymous access. -

-

- A full list of branches, including i2p.i2p and i2p.www can be found on viewmtn. -

-

- A long explanation about using monotone is available on the monotone page. -

+

{% trans %}Remarks{% endtrans %}

+

{% trans %} +To download the website files instead of the I2P source files, use 'i2p.www' instead of 'i2p.i2p'. +{%- endtrans %}

+

{% trans -%} +The initial pull may take several hours using the tunnel. +If it fails after a partial pull, simply rerun it, it will start where it left off. +If you are in a hurry, use the non-anonymous access. +{%- endtrans %}

+

{% trans viewmtn='http://stats.i2p/cgi-bin/viewmtn/' -%} +A full list of branches, including i2p.i2p and i2p.www can be found on viewmtn. +{%- endtrans %}

+

{% trans monotone=site_url('get-involved/guides/monotone') -%} +A long explanation about using monotone is available on the monotone page. +{%- endtrans %}

-

Building I2P

+

{% trans %}Building I2P{% endtrans %}

-

- To compile the code, you need the Sun Java Development Kit 6 or higher, or equivalent JDK - (Sun JDK 6 strongly recommended) and - Apache ant - version 1.7.0 or higher. - If you go are working on the main I2P code, you can go into the i2p.i2p directory and run 'ant' to see the build options. -

+

{% trans sunjdk6='http://java.sun.com/javase/downloads/index.jsp' -%} +To compile the code, you need the Sun Java Development Kit 6 or higher, or equivalent JDK +(Sun JDK 6 strongly recommended) and +Apache ant +version 1.7.0 or higher. +If you go are working on the main I2P code, you can go into the i2p.i2p directory and run 'ant' to see the build options. +{%- endtrans %}

-

- To build or work on console translations, you need - the xgettext, msgfmt, and msgmerge tools from the - GNU gettext package. -

+

{% trans -%} +To build or work on console translations, you need +the xgettext, msgfmt, and msgmerge tools from the +GNU gettext package. +{%- endtrans %}

-

- For development on new applications, - see the application development guide. -

+

{% trans apps=site_url('get-involved/develop/applications') -%} +For development on new applications, +see the application development guide. +{%- endtrans %}

-

Development ideas

-

- See zzz's TODO lists, - this website's TODO list or - Trac - for ideas. -

+

{% trans %}Development ideas{% endtrans %}

+

{% trans zzz=i2pconv('zzz.i2p'), todo=site_url('get-involved/todo'), trac=i2pconv('trac.i2p2.i2p') -%} +See zzz's TODO lists, +this website's TODO list or +Trac +for ideas. +{%- endtrans %}

-

Making the results available

+

{% trans %}Making the results available{% endtrans %}

-

- See the bottom of licenses.html for - commit privilege requirements. You need these to put code into i2p.i2p (not required for the website!). -

+

{% trans licenses=site_url('get-involved/develop/licenses') -%} +See the bottom of the licenses page for +commit privilege requirements. You need these to put code into i2p.i2p (not required for the website!). +{%- endtrans %}

-

- Short version of how to generate and use keys if you plan to commit: +

{% trans %}Short version of how to generate and use keys if you plan to commit:{% endtrans %}

- Long version: see the monotone page. +{% trans monotone=site_url('get-involved/guides/monotone') -%} +Long version: see the monotone page. +{%- endtrans %}

-

Get to know us!

-

- The developers hang around on IRC. They can be reached on the Freenode network, OFTC, and on the I2P internal networks. The usual place to look is #i2p-dev. Join the channel and say hi! - We also have additional guidelines for regular developers. -

+

{% trans %}Get to know us!{% endtrans %}

+

{% trans guidelines=site_url('get-involved/guides/dev-guidelines') -%} +The developers hang around on IRC. They can be reached on the Freenode network, OFTC, and on the I2P internal networks. The usual place to look is #i2p-dev. Join the channel and say hi! +We also have additional guidelines for regular developers. +{%- endtrans %}

-

Translations

-

- Website and router console translators: See the New Translators Page - for next steps. -

+

{% trans %}Translations{% endtrans %}

+

{% trans newtrans=site_url('get-involved/guides/new-translators') -%} +Website and router console translators: See the New Translator's Guide +for next steps. +{%- endtrans %}

-

Tools

-

+

{% trans %}Tools{% endtrans %}

+

{% trans -%} I2P is open source software that is mostly developed using open sourced toolkits. The I2P project recently acquired a license for the YourKit Java Profiler. Open source projects are eligible to receive a free license provided that YourKit is referenced on the project web site. Please get in touch if you are interested in profiling the I2P codebase. -

+{%- endtrans %}

-

+

{% trans java='http://www.yourkit.com/java/profiler/index.jsp', dotnet='http://www.yourkit.com/.net/profiler/index.jsp' -%} YourKit is kindly supporting open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products: -YourKit Java Profiler and -YourKit .NET Profiler. -

+YourKit Java Profiler and +YourKit .NET Profiler. +{%- endtrans %}

{% endblock %}