Views

Difference between revisions of "How do I create an article?"

The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.

Jump to: navigation, search
 
(40 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<div class="breadcrumb">
+
{{Breadcrumb|en|Wie lege ich einen Artikel an?|Getting started}}
{{up}} [[Getting started]] | {{en}} [[Wie lege ich einen Artikel an?]]
 
</div>
 
  
 
__TOC__
 
__TOC__
 +
== First: Check it out==
  
== Möglichkeiten um einen neuen Artikel anzulegen ==
+
You should always make sure before you create a new article that the information is not already available in an existing article or described in a similar way. It may make more sense in this case to extend the existing article.
  
Dazu gibt es zwei übliche Methoden:
+
To do this, choose [[Special:Search|search options]] to look for keywords in the new article being created.
  
# Sie bearbeiten zunächst einen vorhandenen Artikel oder eine geeignete Übersichtsseite und setzen dort einen [[How do I link to other contents or URLs?#Internal_links|internal link]] auf den Artikel, den Sie anlegen möchten. Nachdem dem Speichern der Seite erscheint der Link zum noch nicht vorhandenen Artikel <span style="color:#ba0000; cursor:pointer" title="so sieht ein Link zu einem noch nicht vorhandenen Artikel aus.">rotfarbig</span>. Wenn Sie auf den Link klicken, gelangen Sie direkt zur Bearbeitungsseite für den neuen Artikel.
+
If you still think it makes sense to create a new article on your topic despite the content being similar, create a link from the existing article to your new article, for example: "For further information, see [[#First: Check it out|new article's name]]".
# Sie geben im Suchfeld für Artikel links den Titel eines Artikels ein, den Sie anlegen möchten. Wenn noch kein Artikel mit diesem Namen existiert, wird Ihnen auf der Ergebnisseite der Suche unter anderem die Möglichkeit angeboten, den Artikel neu anzulegen. Wenn Sie auf den entsprechenden Link klicken, gelangen Sie direkt zur Bearbeitungsseite für den neuen Artikel.
 
  
Die erste Methode ist eher zu empfehlen, weil dadurch sichergestellt ist, dass bereits ein Link auf den neuen Artikel existiert.
+
== How to Create a new Article ==
  
== Titel von Artikeln ==
+
There are two typical methods for doing this:
  
Folgende Zeichen dürfen in Titeln nicht verwendet werden:
+
# You first edit an existing article or an appropriate overview page and then create an [[How do I link to other contents or URLs?#Internal_links|internal link]] from here to the article you would like to create. Once you have saved the page, the link to the as yet unavailable article appears <span style="color:#ba0000; cursor:pointer" title="this is what a link to an as yet unavailable article looks like.">in red</span>. If you now click this link, the page for editing the new article will be opened directly.
 +
# In the search field for articles, enter the title of an article you would like to create on the left hand side. If an article with this name does not yet exist, one of the options you will be offered on the hits page for the search is to create the new article. By clicking the relevant link, the page for editing the new article will be opened directly.
 +
 
 +
The first method is recommended because it ensures that a link is already created to the new article.
 +
 
 +
== Article Titles ==
 +
 
 +
The following characters must not be used in titles:
  
 
  " # $ * + < > = @ [ ] \ ^ ` { } | ~
 
  " # $ * + < > = @ [ ] \ ^ ` { } | ~
  
Das erste Zeichen des Titels darf außerdem kein Schrägstrich "/" sein.
+
The first character of the title must also not be a forward slash "/".
 +
 
 +
Wikis is case sensitive, which means that it distinguishes between uppercase and lowercase letters. Two titles, such as ''optiPoint'' and ''OptiPoint'', which only differ in terms of how the first letter is written, lead to different articles in this Wiki!
  
Innerhalb dieses Wikis wird zwischen Groß- und Kleinschreibung unterschieden. Zwei Titel wie ''optiPoint'' und ''OptiPoint'', die sich nur durch die Schreibung des ersten Buchstabens unterscheiden, führen in diesem Wiki zu unterschiedlichen Artikeln!
+
The article name should always be in the language in which the content of the article is also written.
 +
Where proper names or abbreviations are used as article names, for example '''optiPoint''' or '''SIP''', use the suffix ''(de)'' to differentiate, therefore for example ''SIP (de)'' for the German article on SIP.
  
== Inhalte strukturieren ==
+
== Structuring Content ==
  
Lesen Sie zu diesem Zweck die folgenden Seiten:
+
Please refer to the following pages in this regard:
  
 
* [[How do I format my contents?]]
 
* [[How do I format my contents?]]
Line 32: Line 40:
 
* [[How do I add images and multimedia?]]
 
* [[How do I add images and multimedia?]]
  
== Artikel verlinken ==
+
== Linking Articles ==
  
Das Wiki lebt nicht nur von Inhalten, sondern auch von seiner Verlinkungsstruktur. Wenn Sie einen neuen Artikel erstellen, sollte dieser einerseits auf mehreren anderen Seiten verlinkt werden, und andererseits sollte er selbst Querverweise enthalten, wenn es sich anbietet. Siehe auch: [[How do I link to other contents or URLs?]]
+
Wiki is characterized not just by its content but also by its link structure. When creating a new article, it should on one hand be linked to a number of other pages and on the other hand it should contain cross-references, if it lends itself to this. See also: [[How do I link to other contents or URLs?]]
  
=== Eigenen Artikel auf anderen Seiten verlinken ===
+
=== Linking own Articles to other Pages ===
  
In jedem Fall sollte ein neuer Artikel auf einer passenden Übersichtsseite verlinkt werden. Solche Übersichtsseiten finden Sie unterhalb der Einstiege [[Phones]], [[Platforms]], [[Your Assistance]], [[FAQ]], [[How To]], [[White Papers]] und [[Glossary]]. Scheuen Sie sich nicht, diese Seiten zu editieren und den Link auf Ihren neuen Artikel an passender Stelle einzufügen.
+
A new article should in any case be linked to an appropriate overview page. Such overview pages can be found below the entry-level navigation points [[Phones]], [[Platforms]], [[Your Assistance]], [[FAQ]], [[How To]], [[White Papers]] and [[Glossary]]. Don't be afraid to edit these pages and insert the link to your new article in the appropriate place.
  
Häufig gibt es andere Artikel, die das im eigenen Artikel behandelte Thema erwähnen. Machen Sie sich die Mühe, den betreffenden Artikel zu bearbeiten und an der entsprechenden Stelle im Text einen Link auf Ihren neuen Artikel einzufügen. Es kann auch sein, dass Ihr neuer Artikel aus Sicht eines vorhandenen Artikels verwandte oder vergleichbare Informationen enthält. In einem solchen Fall können Sie dem fremden Artikel am Ende einen Abschnitt für weitere Information hinzufügen, sofern er noch keinen solchen Abschnitt enthält. Dort können Sie dann den Link zu Ihrem Artikel platzieren.
+
Other articles frequently exist that refer to the topic dealt with in your own article. Take the trouble to edit the relevant article and insert a link to your new article at the appropriate position in the text. It may also be the case that your new article contains related or comparable information from the perspective of an existing article. In such a case, you can add a section for further information at the end of the other article, assuming the article does not already contain such a section. You can then place the link to your article here.
  
=== Anderen Seiten im eigenen Artikel verlinken ===
+
=== Creating Links to other Pages in your own Article ===
  
Denken Sie bereits beim Bearbeiten Ihres Artikeltextes, dass der Artikel keine separate Publikation ist, sondern im Kontext des Wikis betrachtet werden muss. Verlinken Sie beispielsweise Fachbegriffe oder Abkürzungen, die im [[Glossary]] vorkommen. Falls dort übrigens ein Fachbegriff oder eine Abkürzung fehlt, dann legen Sie ruhig einen entsprechenden Artikel nach dem Vorbild der übrigen Glossareinträge an.
+
When editing your article text, remember that the article is not an isolated publication, rather must be looked at in the context of the Wiki. For example, you can link specialist terms or abbreviations that appear in the [[Glossary]]. Should it happen that a specialist term or abbreviation is not in the glossary, then simply create an appropriate article based on the template of the other glossary entries.
  
Setzen Sie auch Links zu anderen Seiten, die aus Sicht Ihres eigenen Artikels weiterführende oder vergleichbare Informationen enthalten. Eine [[How To|Anleitung]] kann beispielsweise Links auf Fragen der [[FAQ]] enthalten, die mit ihrem Inhalt zu tun haben. Artikel, die Erfahrungen mit [[Phones|phones]] schildern, sollten auf die Produktseite des jeweiligen Geräts verlinken.  
+
You can also create links to other pages, which contain additional or comparable information from the perspective of your article. A [[How To|How-to article]] for example can contain links to questions in the [[FAQ]], which relate to your content. Articles that portray experience with [[Phones|phones]] should link to the product page for the respective device.  
  
Benutzern, die sich noch nicht so gut im Informationsangebot dieses Wikis auskennen, können solche Links in eigenen Beiträgen noch nicht so souverän setzen. Zu den Aufgaben unserer erfahrenen Redakteure gehört es deshalb auch, Artikel mit zu schwacher Verlinkung nachzubearbeiten.
+
Users who are not altogether familiar with the information offering of this Wiki may not be able to use these links as confidently yet in their own articles. One of the tasks of our experienced editors is therefore to rework articles that contain weak links.
  
== Änderungen und Diskussionen zum Artikel verfolgen ==
+
== Tracking Changes and Discussions relating to the Article ==
  
Wer einen Artikel beiträgt, hat auch ein Interesse daran zu verfolgen, ob der Artikel von anderen Benutzern bearbeitet wird. Deshalb empfiehlt es sich, eigene Artikel in die eigene Beobachtungsliste zu übernehmen. Die Beobachtungsliste steht zur Verfügung, wenn Sie angemeldet sind.
+
If you have contributed an article, then you will no doubt also have an interest in checking whether the article is being edited by other users. It is therefore recommended to copy your own articles to your watchlist. The watchlist is available when you are logged in.
  
Um einen Artikel in die Beobachtungsliste aufzunehmen, rufen Sie den Artikel auf (nicht zum Bearbeiten, sondern in der normalen Präsentationsansicht). Klicken Sie dann in der Kopfnavigation auf ''watch''.  
+
To add an article to the watchlist, open the article (not for editing, rather in the normal presentation view) and then click ''watch'' in the topline navigation.  
  
Um zu sehen, welche Artikel Sie aktuell in Ihrer Beobachtungsliste haben, klicken Sie am oberen Seitenrand auf ''my watchlist''. Dabei können Sie die Beobachtungsliste auch bearbeiten und nicht mehr gewünschte Einträge daraus entfernen.
+
To see which articles you currently have in your watchlist, click ''my watchlist'' at the top of the page. You can also edit the watchlist here and remove entries from it that you no longer need.
  
Als Artikelautor sollten Sie Diskussionen zu Ihren Beiträgen mitverfolgen. Nehmen Sie zu Diskussionsbeiträgen anderer Benutzer gegebenenfalls Stellung. Um die Diskussionsseite zu einem Artikel aufzurufen, rufen Sie den Artikel in der normalen Präsentationsansicht auf. Klicken sie dann in der Kopfnavigation auf ''discussion''.
+
As author of an article you should also track discussions on your contributions. If appropriate, make comments on the discussion contributions of other users. In order to access the discussion page for an article, call up the article in the normal presentation view and then click ''discussion'' in the topline navigation.

Latest revision as of 07:33, 27 April 2011

First: Check it out

You should always make sure before you create a new article that the information is not already available in an existing article or described in a similar way. It may make more sense in this case to extend the existing article.

To do this, choose search options to look for keywords in the new article being created.

If you still think it makes sense to create a new article on your topic despite the content being similar, create a link from the existing article to your new article, for example: "For further information, see new article's name".

How to Create a new Article

There are two typical methods for doing this:

  1. You first edit an existing article or an appropriate overview page and then create an internal link from here to the article you would like to create. Once you have saved the page, the link to the as yet unavailable article appears in red. If you now click this link, the page for editing the new article will be opened directly.
  2. In the search field for articles, enter the title of an article you would like to create on the left hand side. If an article with this name does not yet exist, one of the options you will be offered on the hits page for the search is to create the new article. By clicking the relevant link, the page for editing the new article will be opened directly.

The first method is recommended because it ensures that a link is already created to the new article.

Article Titles

The following characters must not be used in titles:

" # $ * + < > = @ [ ] \ ^ ` { } | ~

The first character of the title must also not be a forward slash "/".

Wikis is case sensitive, which means that it distinguishes between uppercase and lowercase letters. Two titles, such as optiPoint and OptiPoint, which only differ in terms of how the first letter is written, lead to different articles in this Wiki!

The article name should always be in the language in which the content of the article is also written. Where proper names or abbreviations are used as article names, for example optiPoint or SIP, use the suffix (de) to differentiate, therefore for example SIP (de) for the German article on SIP.

Structuring Content

Please refer to the following pages in this regard:

Linking Articles

Wiki is characterized not just by its content but also by its link structure. When creating a new article, it should on one hand be linked to a number of other pages and on the other hand it should contain cross-references, if it lends itself to this. See also: How do I link to other contents or URLs?

Linking own Articles to other Pages

A new article should in any case be linked to an appropriate overview page. Such overview pages can be found below the entry-level navigation points Phones, Platforms, Your Assistance, FAQ, How To, White Papers and Glossary. Don't be afraid to edit these pages and insert the link to your new article in the appropriate place.

Other articles frequently exist that refer to the topic dealt with in your own article. Take the trouble to edit the relevant article and insert a link to your new article at the appropriate position in the text. It may also be the case that your new article contains related or comparable information from the perspective of an existing article. In such a case, you can add a section for further information at the end of the other article, assuming the article does not already contain such a section. You can then place the link to your article here.

Creating Links to other Pages in your own Article

When editing your article text, remember that the article is not an isolated publication, rather must be looked at in the context of the Wiki. For example, you can link specialist terms or abbreviations that appear in the Glossary. Should it happen that a specialist term or abbreviation is not in the glossary, then simply create an appropriate article based on the template of the other glossary entries.

You can also create links to other pages, which contain additional or comparable information from the perspective of your article. A How-to article for example can contain links to questions in the FAQ, which relate to your content. Articles that portray experience with phones should link to the product page for the respective device.

Users who are not altogether familiar with the information offering of this Wiki may not be able to use these links as confidently yet in their own articles. One of the tasks of our experienced editors is therefore to rework articles that contain weak links.

Tracking Changes and Discussions relating to the Article

If you have contributed an article, then you will no doubt also have an interest in checking whether the article is being edited by other users. It is therefore recommended to copy your own articles to your watchlist. The watchlist is available when you are logged in.

To add an article to the watchlist, open the article (not for editing, rather in the normal presentation view) and then click watch in the topline navigation.

To see which articles you currently have in your watchlist, click my watchlist at the top of the page. You can also edit the watchlist here and remove entries from it that you no longer need.

As author of an article you should also track discussions on your contributions. If appropriate, make comments on the discussion contributions of other users. In order to access the discussion page for an article, call up the article in the normal presentation view and then click discussion in the topline navigation.