Inkscape Wiki - User contributions [en]

Editing Inkscape's website

2006-08-12T18:38:18Z

Brent: /* There are no UTF-8 entities !!! */ Cleaned up grammar.

Once you have developer-level access to the project, you can also help with maintenance of the Inkscape website.

== SVN Checkout of the Website Module ==

To checkout the website cvs module:

:Type <pre>svn co https://svn.sourceforge.net/svnroot/inkscape/inkscape_web/trunk inkscape_web</pre> after you have logged in with your username/password

For more info, see See [[WorkingWithSVN]].

== Testing your website changes locally ==

Once you have checked out (see previous heading) the website module, then make a symbolic link to your web root directory. To do this for apache on redhat9 the best way is to navigate to <pre>/var/www/html</pre> and then type:

:<pre>ln -s /usr/src/inkscape-project/inkscape_web</pre> (NOTE: that the path you pass should be relative/absolute to the inkscape_web module you just checked out)

Thus, once you have done this, then you will be able to view the Inkscape website at <pre>http://localhost/inkscape_web/</pre> on your computer via a web browser.

Hopefully, you have apache configured properly and it is running.

== Making Your Changes Live on Inkscape.org ==

# Make your changes to your local inkscape_web module.
# Commit your changes, ensuring that you provide ample notes in your commit log message.
# ssh -l <your sf username> ssh.sourceforge.net *
# cd inkscape/inkscape_web
# ./publish_web.sh

(*)
If you haven't done this before, you need to set up a link to the inkscape_web folder in your home directory.
ln -s /home/groups/i/in/inkscape inkscape

== Adding News to the Site ==

If you have SVN access, you can add news to the site. First, you should add your signature to /includes/signatures.inc.

Create your news in english always! create a new file in the news/en/<this-year>/<this-month> folder, and give it the next highest number. (if there are files named 001.inc and 002.inc, name yours 003.inc) You can use this as a template:
<nowiki><pre>
<d i v class="item">
<h3>HEADER</h3>
<b>MONTH DAY, YEAR</b>
<p>MESSAGE
</p>
<?php echo $[[SIG_YOURNAME]]; ?>
</d i v>
</pre></nowiki>
Add new paragraphs if needed and dont forget to change the signature.

If you want, translate the news to your language and save it in news/XX/<this-year>/<this-month>

If you really want to add news only in your language (not english), it might probably be the better way to modify your localized header (/index.xx-header.php). If you really think you need to have a local-only news, then please add an empty file with the same name (number) in the english directory and add a comment:



Make your changes live as described above.

== Adding Screenshots to the Site ==

The best way to add screenshots to the website is not by emailing them to the list or to any one developer unless you are not a developer. Instead, the best way is to create a screenshot for whatever screen size your system is set to (preferably a standard size like 1024 by 768), creating it in the PNG file format and then give it a descriptive name.

Then the resulting thumbnail should be of the resolution 267 pixels wide by 200 pixels high in PNG format. The naming must be in relationship to the screenshot.

Naming convention is:

:inkscape-<version>-<id>-<name>.png
:inkscape-<version>-<id>-<name>_thumb.png

Example:

:inkscape-0.43-01-myfeature.png
:inkscape-0.43-01-myfeature_thumb.png

<id> is ment to be something like 01, 02, 03... but you can also use 10a, 10b, 10c. this affects the order in the gallery. use zzz to place a sceenshot on top.
(NOTE: <id> wasnt there before. but i suggest using it beginning with 0.43)

save your shot into the "screenshots/gallery" folder, the thumb into "screenshots/gallery/thumbs".

Once the graphics are in the right folder, my lovely PHP script will display them automatically on the main page of the website.
They also appear on the screenshots/index.php page, therefore you must create a description file:

:inkscape-<version>-<id>-<name>.en

You may also create translations of description files. Just replace .en with the language code. Example:

:inkscape-0.43-01-myfeature.en
:inkscape-0.43-01-myfeature.de
:inkscape-0.43-01-myfeature.es

Store them in "screenshots/gallery/info"

Then make sure that you add your new images and description files and any changes to the SVN repository. For more info, see [[WorkingWithSVN]].

== Translating the Inkscape Website ==

1. Do a CVS checkout of the website module.

IMPORTANT: all files you change MUST be UTF-8 encoded!!!
else, you will get broken output.
See UT-8 note below, please.

2. Add your language by these steps:
- update the following line includes/header.php
$LANGUAGES = array("en", "de", "es"); // available languages

- Add a flag for your language in the images directory. It should be named inkscape_web/images/flag-XX.png. (where XX is your language code). Size is 34x20px.

- Add a line to css/base.css, similar to the following: (place your flag 50px left of the others)
#lang-xx { left:225px; }

- Add a link for your flag in includes/header.php

- create a copy of includes/localized-en.inc for your language. (like includes/localized-fr.inc) and translate the values of the strings.

- copy and translate index.en-header.php to your language.

- copy the subdirectory structure news/en/ to news/xx/ and, if you want, translate the news. (you can delete all news that you will not translate. the script will use the original news of /news/en then)

- you may add a signature to includes/signatures.inc and use it for news you create.

3. Look into other pages to see what needs to be done to translate them. (in general you need to create an inclusion file)
Files you need to translate: (at least you must create a copy for your language, or those pages will fail to open)
discussion-en.inc
download-en.inc
mailing_lists-en.inc
report_bugs-en.inc
submit2webmaster-en.inc
submit2webmaster-en-form.inc
doc/index-en.inc
status/index-en.inc

You also may translate news, screenshot comments and status files.

Note: The tutorial translations in the doc/ directory are handled
separately from the website translation. These are the files in
inkscape_web/doc/*/ that have .XX.html extensions. You do not need
to do anything about these pages.

Note: The translation of doxygen, wiki, and the various SF pages
are separate from the website translation. You do not need to do
anything about these pages.

5. Add a news item to the index page announcing your translation. You are encouraged to write it in both English and your native language. Use UTF-8 character set (or character entities if you prefer).
You do this by adding a file like /news/en/200x/xx/0xx.inc and write your announcement.
IMPORTANT: all files you change MUST be UTF-8 encoded!!! else, you will break get broken output.
See UT-8 note below, please.

Note: Even if the announcement does not need to be translated,
you should copy it to your languages folder also.
Reason: Same news must have same file names. If your announcement
is 010.inc, and then the next news is 011.inc, if you translate
that news only, your announcement will no more be shown. This is
because if you have 11 localized news and there are 12 in /en/,
the 11th will be shown in english. Now, if the 11th file in your
folder is the translation of the 12th file in /en/, it will be
displayed wrong

6. If you have CVS access, then commit your changes to the site. See the Website Editing and Working With CVS documentation for directions.

If you do not have CVS access, then show your translation to one of the Inkscape administrators for review. They will then give you access to CVS and the website, so you can deploy your changes.

== There are no UTF-8 entities !!! ==

As different people have talked about UTF-8 entities, this should be clarified: THERE IS NO SUCH THING!

There are HTML entities (that's what you think of). This is not an encoding, it is a (somewhat) human readable transliteration. They look like this:

<pre> & (& a m p ;) --- ř (& # 3 4 5 ;) --- Ä (& A u m l ;)</pre>

The cool thing about them is that you don't need to care about encoding with them, as only the lower 128 of 256 ASCII characters are used to describe characters that normally are in the upper 128 or even don't exist in ASCII. The upper 128 are different (for example, in Windows codepages); at least, they are system-dependent.

Now, if we talk about UTF-8, this is an encoding! And it's one for UNIcode. The 8 means, that the most important characters need 8 bits (the same as the lower 128 in ASCII?). All the other UNIcode characters are stored using 2, 3, or 4 bytes. And if your editor is not capable of UTF-8, youll see a mess instead of special characters like äüößéńí etc.

So, if you edit existing pages, you need to have an UTF-8 capable editor. (Kate is capable, but you might need to check the encoding in the extras menu.)

<strong>Please do not use HTML-entities!</strong> We should all use the same system, which should be utf-8 encoding. If you have questions about this, please ask.

Reference: HTML Entities: http://www.w3schools.com/tags/ref_entities.asp

[[Category:Help Wanted]]

Inkscape coverage

2006-08-12T18:22:51Z

Brent: Added link to http://www.other-space.com/inkscape/

== Articles and Presentations ==

Please place presentation outlines, papers, and abstracts below.

=== Awards ===


* Reader's Choice Award for 2005 [http://www.linuxjournal.com/article/8520 Graphics Software], [http://www.linuxjournal.com/ Linux Journal] September 2005, 2nd (after Gimp).

* Editor's Choice Award for 2005 [http://www.linuxjournal.com/article/8293#N0x850ca10.0x8574140 Graphics Software], [http://www.linuxjournal.com/ Linux Journal] August 2005, 1st.

=== Abstracts and Files ===

* [[OSCon2004Abstract]] - Ted's abstract for the conference. If it gets accepted, hopefully we can put a bunch of effort into that endeavour via this wiki.
* [[PresentationInkscapeOverview]] - More in-depth points and so forth.
* [[TufteStylePresentation]] - A plain and simple Edward Tufte type presentation outline.
* [[GeneralConferenceAbstract]] - A general abstract and extended abstract that can be copied and pasted for various conferences.

=== Past Presentations ===

* Phillips, Jon. "Open Source + Open Content." Visiting Artist Lectures and Exhibitions 2004-2005, San Francisco Art Institute. 2005-03-08.
* Phillips, Jon. Inkscape Birds of a Feather Meeting. Siggraph, Los Angeles. 2004-08-09.
* Phillips, Jon. "CVS and Distributive Writing using Common Open Source Software." Narr@tive: Digital Storytelling, UCLA Hammer Museum. 2004-04-23.
* Phillips, Jon. "Vector Aesthetics." 040404 Symposium, UC Berkeley. 2004-04-04.
* Phillips, Jon. "Inkscape: Overview." Center for Research in Computing and the Arts (CRCA), University of California, San Diego (UCSD). 2004-03-10.
* Vieites, Lucas. "Presentation of Inkscape at Universidad de A Coruna." Universidad de A Coruna. 2004-11.

=== Online Articles about Inkscape ===
* Harrington, Bryce. [http://www.osnews.com/story.php?news_id=7241 osnews: Inkscape - A Union of Contributions Makes a Difference]. 2004-07
* Harrington, Bryce. [[ArticleIntroducingInkscape0 40|Introducing Inkscape 0.40]] - By Bryce Harrington, November 29, 2004.

* [http://niyam.com/gnulinux/lfy/fy/FY-monthly-col.php?article_body=FYmay2k4.html Follow Your Bliss]
* [http://developers.slashdot.org/article.pl?sid=04/06/02/1813212&mode=thread&tid=117&tid=152&tid=185&tid=99 Slashdot article & discussion: "Introduction To Inkscape And Its Future"]
* [http://www.newsforge.com/article.pl?sid=04/07/19/214206 newsforge article]
* [http://www.gnomedesktop.org/article.php?sid=1883&mode=thread&order=0&thold=1 gnome footnotes for 0.39 release]
* http://en.wikipedia.org/wiki/Inkscape
* [http://linuxgraphic.org/section2d/articles/miroir_Inkscape/index.html A nice tutorial focused on Inkscape, in French.]
* [http://www.linuxplanet.com/linuxplanet/tutorials/5757/3/ nice overview of svg and inkscape]
* [http://www.linux-user.de/ausgabe/2005/05/053-inkscape/index.html German language article with beginner's tutorial]
* [http://www.10-minute-rule.com/index.php?itemid=8 Review and rapid results tutorial]
* [http://www.other-space.com/inkscape/ Inkscape Tutorials] - Includes an overview of usage and a tutorial on the Bezier tool

====Release of Inkscape 0.44====

* http://slashdot.org/articles/06/06/24/0320210.shtml
* http://www.heise.de/newsticker/meldung/74651 (German)
* http://www.golem.de/0606/46108.html (German)
* http://en.wikinews.org/wiki/Version_0.44_of_SVG_image_software_Inkscape_released
* http://pl.wikinews.org/wiki/Inkscape_0.44_wydany (Polski)
* http://de.wikinews.org/wiki/SVG-Zeichenprogramm_Inkscape_0.44_erschienen (German)
* http://www.gnuzilla.info/download/index.php?action=downloadfile&filename=GNUzilla18-19.pdf&directory=& (PDF, Serbian)

=== Great Articles on SVG and Vector Graphics ===
* http://tech.irt.org/articles/js209/
* [http://www.w3.org/Graphics/SVG/About w3c's About SVG Document (defines and shows uses for)]
* IX Article (German) [http://www.heise.de/ix/artikel/2002/12/052/ SVG I: Grundlagen skalierbarer Webgrafik], [http://www.heise.de/ix/artikel/2003/01/128/ SVG-Tutorial II: Filter und Animationen], [http://www.heise.de/ix/artikel/2003/02/130/ SVG-Tutorial III: Scripting und Datenbankauswertung]
* [http://www.xml.com/pub/a/2004/06/02/svgtype.html SVG and Typography: Bells and Whistles]
* [http://software.newsforge.com/article.pl?sid=04/12/23/1638201&from=rss Introduction to Inkscape 0.4]

=== Print Articles (Magazines and Newspapers) about Inkscape ===

* [http://www.heise.de/kiosk/archiv/ct/06/12/168/ Peter König: Hausmannskunst - Günstige Vektorzeichenprogramme für Amateure, c't 12/2006, Seite 168] - review article of vector programs (including Inkscape 0.43) in the [http://www.heise.de/ct/ German c't magazine] - [[Report on c't article 12/2006]]
* [http://www.linuxformat.co.uk/ Linux Format Magazine] Issue 80, June 2006 - Cover special on Libre Graphics. Had a roundup of the inaugural [http://www.libregraphicsmeeting.org/ LGM], including two pages dedicated to Inkscape, in addition to pages on [http://www.scribus.net/ Scribus], [http://www.gimp.org Gimp] and [http://www.xaraxtreme.org/ Xara].
* Kreusel, Peter. "Inkscape - if you need something more than a bitmap, try the Inkscape vector graphics tool", Issue 56, July 2005, [http://www.linux-magazine.com/ Linux Magazine], pp. 82-84.
* [http://www.linuxformat.co.uk/ Linux Format Magazine] Christmas 04 Issue - brief mention in the news section, pointing out the .40 release and hightlighting some key additions. included GO! screenshot.
* [http://www.linuxformat.co.uk/ Linux Format Magazine] Issue 55 review of inkscape Issue 56 featured a roundup of vector graphics applications including Inkscape. Inskcape received 8/10 and was was second only to OpenOffice.org Draw which also received 8/10.
* [http://www.linux-magazine.com/ Linux Magazine] Issue 47, October 2004 featured a roundup of vector graphics applications including Inkscape.
* [http://www.linuxuser.co.uk/ Linux User and Developer Magazine] Issue 47, March 2005 featured a roundup of vector graphics applications including Inkscape written by Miriam Clinton.
* [http://www.ipercollege.org/inkscape/ Benvenuti su Inkscape] - Magazine review of Inkscape
* Aleksandar Urošević. "Inkscape 0.42.2 - Vektorski golgeter", Svet Kompjutera, November 2005, review of Inkscape in Serbian IT magazine ([http://www.sk.co.yu/2005/11/skpd09.html Online version])

[[Category:About Inkscape]]

=== Outside Links ===

* [[Links to us]]