Help:Editing: Difference between revisions

From BlueM
Jump to navigation Jump to search
(→‎Syntaxhervorhebung: update and translate)
(26 intermediate revisions by 3 users not shown)
Line 5: Line 5:
* [http://meta.wikimedia.org/wiki/Hilfe Deutsche Hilfe]
* [http://meta.wikimedia.org/wiki/Hilfe Deutsche Hilfe]


==Integration mit Bugzilla und ViewVC==
==Kommentare==
Zusätzlich zu den standardmäßigen [http://meta.wikimedia.org/wiki/Help:Magic_words magischen Wörtern] in MediaWiki, sind in dieser Wiki-Installation die folgenden Wörter registriert:
Für Diskussionen eignen sich die Mediawiki-eigenen [{{fullurl:Special:PrefixIndex|from=&namespace=1}} Diskussionsseiten] der einzelnen Artikel.
* '''Bug''' gefolgt von einer Zahl wird automatisch mit dem entsprechenden Bug in [http://130.83.196.170/bugzilla/ Bugzilla] verlinkt.
* '''Rev''' oder '''Rev.''' gefolgt von einer Zahl wird automatisch mit der entsprechenden Revisionsansicht in [http://130.83.196.170/viewvc/viewvc.cgi ViewVC] verlinkt*.


Siehe auch den entsprechenden [[MediaWiki SVN Patch]] hierfür.
<div class="comment">
Beispielkommentar
</div>
Es ist aber auch möglich, Kommentare direkt in den Text einer Seite zu setzen, indem man folgende Syntax benutzt:
<source lang="html5"><div class="comment">
Beispielkommentar
</div></source>
In jedem Fall ist es sinnvoll, seine Kommentare mit der Zeichenfolge <code><nowiki>~~~~</nowiki></code> zu signieren (fügt Namen und Uhrzeit des Bearbeiters ein)


''* <small>Verlinkung wird immer zu der Repository "BlauesModell" hergestellt. Um zu anderen Repositories zu verlinken, muss der Link manuell erstellt werden.</small>
==Literaturangaben==
Für die Angabe von Literaturverweisen ist die [http://www.mediawiki.org/wiki/Extension:Cite/Cite.php Cite] Extension installiert.
 
Um die mehrfache Eingabe von Literaturangaben zu vermeiden bekommt jede Literaturangabe eine eigene Seite, und zwar im Namensraum '''[{{fullurl:Special:PrefixIndex|from=&namespace=100}} Literatur:]'''. Die Literaturangabe kann dann auf beliebig vielen Seiten über Vorlageneinbindung eingebunden werden.
 
'''Beispiel:''' <br/>
Ich will die Literaturangabe Mustermann (2008) zitieren:
 
:{| cellspacing="0" cellpadding="2" border="0"
|-
|
<pre>
Blablabla (siehe {{:Literatur:Mustermann_2008}})
</pre>
| width="100" align="center" | &rarr;
| Blablabla (siehe {{:Literatur:Mustermann_2008}})
|-
| colspan="3" | oder unter Nutzung des optionalen Übergabeparameters:
|-
|
<pre>
{{:Literatur:Mustermann_2008|Blablabla}}
</pre>
| align="center" | &rarr;
| {{:Literatur:Mustermann_2008|Blablabla}}
|-
| colspan="3" | und dann am Ende der Seite:
|-
|
<pre>
<references/>
</pre>
| align="center" | &rarr;
| <references/>
|-
|}
 
Dies führt dazu, dass der Inhalt der Seite [[Literatur:Mustermann_2008]] eingebunden wird. Wenn die Seite noch nicht existiert, wird ein roter Link angezeigt, über den man diese erstellen kann. Literaturseiten sollten folgende Syntax einhalten:
 
<pre>
{{{1|Mustermann (2008)}}}<ref name="mustermann_2008">'''Mustermann, M.''' (2008): Mein Buch</ref><noinclude>
==Vorschau==
<references/>
</noinclude>
</pre>
 
'''Erläuterung:'''
* Alles, was sich zwischen den '''<code><nowiki><noinclude></nowiki></code>''' Tags befindet, wird ''nicht'' mit eingebunden und dient nur zur Vorschau der Literaturangabe.
* Der Teil '''<code><nowiki>{{{1|xxxx}}}</nowiki></code>''' wird, wenn vorhanden, durch den Übergabeparameter ersetzt, ansonsten durch <code>xxxx</code> (im Beispiel <code>Mustermann (2008)</code>).
* Der Text zwischen den '''<code><nowiki><ref></nowiki></code>''' Tags wird angezeigt, wenn man den Tag '''<code><nowiki><references/></nowiki></code>''' auf einer Seite benutzt (sollte am Ende der Seite geschehen).
* Das Attribut '''<code><nowiki>name</nowiki></code>''' des <code><nowiki><ref></nowiki></code>-Tags dient dazu, die Literaturangabe eindeutig zu identifizieren, so dass sie nur einmal angezeigt wird, wenn sie auf einer Seite mehrmals benutzt wird.
 
===DOI===
DOI-Angaben im Format <code><nowiki>doi:XXXXXXXX</nowiki></code> werden automatisch mit dem DOI-Resolver <nowiki>http://dx.doi.org</nowiki> verlinkt.


==Dokumente einbinden==
==Dokumente einbinden==
Line 26: Line 84:
| {{file|doc|Macro.doc|Makro}}
| {{file|doc|Macro.doc|Makro}}
|}
|}
==Literaturangaben==
Für die Angabe von Literaturverweisen ist die [http://meta.wikimedia.org/wiki/Cite/Cite.php Cite] Extension installiert.


==Formeln==
==Formeln==
Formeln können in Form von '''TeX-Markup''' innerhalb von <code>&lt;math&gt;&lt;/math&gt;</code> Tags eingegeben werden. Ausführliche Hilfe hier: [http://meta.wikimedia.org/wiki/Help:Formula Englisch] / [http://meta.wikimedia.org/wiki/Hilfe:Mathematische_Formeln Deutsch]
Formeln können in Form von '''TeX-Markup''' innerhalb von <code>&lt;math&gt;&lt;/math&gt;</code> Tags eingegeben werden. Ausführliche Hilfe hier: [http://meta.wikimedia.org/wiki/Help:Formula Englisch] / [http://meta.wikimedia.org/wiki/Hilfe:Mathematische_Formeln Deutsch]
==FreeMind Mind Maps==
Mind Maps von [http://freemind.sourceforge.net Freemind] können wie [http://freemind.sourceforge.net/wiki/index.php/Embedded_Mind_Maps hier] beschrieben eingebettet werden.


==Syntaxhervorhebung==
==Syntaxhervorhebung==
Syntaxhervorhebung von Code-Passagen erfolgt mit [http://qbnz.com/highlighter/ GeSHi - Generic Syntax Highlighter] (Wiki Extension von [http://www.mangue.org/wiki/MediaWiki_Coloration hier]).  
Syntax highlighting uses the [https://www.mediawiki.org/wiki/Extension:SyntaxHighlighter SyntaxHighlighter Extension].


Den hervorzuhebenden Code einfach mit Tags der entsprechenden Sprache umschließen, z.B. <code>&lt;fortran&gt;&lt;/fortran&gt;</code>, <code>&lt;vb&gt;&lt;/vb&gt;</code> oder <code>&lt;vbnet&gt;&lt;/vbnet&gt;</code>.<br/>
To highlight code, enclose it with source tags, e.g. <code><nowiki><source lang="fortran"> </source></nowiki></code>, oder <code><nowiki><source lang="vbnet"> </source></nowiki></code>.<br/>
Beispiel:  
Example:  
{| cellpadding="2" cellspacing="0" border="0"
{| cellpadding="2" cellspacing="0" border="0"
|<pre>
|<pre>
<fortran>
<source lang="fortran" highlight="5">
       FUNCTION Test
       FUNCTION Test
c        Kommentar
c        Kommentar
Line 47: Line 105:
           variable(1) = variable2 + 5.03  ! Kommentar
           variable(1) = variable2 + 5.03  ! Kommentar
       END FUNCTION
       END FUNCTION
</fortran>
</source>
</pre>
</pre>
| &rarr;
| &rarr;
| <fortran>
| <source lang="fortran" highlight="5">
       FUNCTION Test
       FUNCTION Test
c        Kommentar
c        Kommentar
Line 57: Line 115:
           variable(1) = variable2 + 5.03  ! Kommentar
           variable(1) = variable2 + 5.03  ! Kommentar
       END FUNCTION
       END FUNCTION
</fortran>
</source>
|}
|}


Line 79: Line 137:
</pre>
</pre>
Änderungen an der Struktur der Hierarchie können an der Index-Seite vorgenommen werden. Die Hierarchie wird immer dann neu generiert, wenn man die Index-Seite speichert.
Änderungen an der Struktur der Hierarchie können an der Index-Seite vorgenommen werden. Die Hierarchie wird immer dann neu generiert, wenn man die Index-Seite speichert.
==Integration mit Bugzilla und WebSVN==
<del>Zusätzlich zu den standardmäßigen [http://meta.wikimedia.org/wiki/Help:Magic_words magischen Wörtern] in MediaWiki, sind in dieser Wiki-Installation die folgenden Wörter registriert:</del>
*<del> '''Bug''' gefolgt von einer Zahl wird automatisch mit dem entsprechenden Bug in [http://bugs.bluemodel.org/ Bugzilla] verlinkt. (z.B. Bug 1)</del>
*<del> '''Rev''' oder '''Rev.''' gefolgt von einer Zahl wird automatisch mit der entsprechenden Revisionsansicht in [http://websvn.bluemodel.org WebSVN] verlinkt. (z.B. Rev 1)</del>
<del>;Achtung: ''Verlinkung erfolgt momentan nur automatisch auf die Repository 'BlueM.Sim'!'' </del>
<del>Siehe auch den entsprechenden [[MediaWiki SVN Patch]] hierfür.</del>
''no longer working, workaround using interwiki links:''<br>
<nowiki>[[bugzilla:2]]</nowiki> &rarr; [[bugzilla:2]]<br>
<nowiki>[[rev:2]]</nowiki> &rarr; [[rev:2]] (assumes the repository BlueM.Sim)''

Revision as of 06:41, 27 January 2018

Wiki-Bearbeitung allgemein

Kommentare

Für Diskussionen eignen sich die Mediawiki-eigenen Diskussionsseiten der einzelnen Artikel.

Beispielkommentar

Es ist aber auch möglich, Kommentare direkt in den Text einer Seite zu setzen, indem man folgende Syntax benutzt:

<div class="comment">
Beispielkommentar
</div>

In jedem Fall ist es sinnvoll, seine Kommentare mit der Zeichenfolge ~~~~ zu signieren (fügt Namen und Uhrzeit des Bearbeiters ein)

Literaturangaben

Für die Angabe von Literaturverweisen ist die Cite Extension installiert.

Um die mehrfache Eingabe von Literaturangaben zu vermeiden bekommt jede Literaturangabe eine eigene Seite, und zwar im Namensraum Literatur:. Die Literaturangabe kann dann auf beliebig vielen Seiten über Vorlageneinbindung eingebunden werden.

Beispiel:
Ich will die Literaturangabe Mustermann (2008) zitieren:

Blablabla (siehe {{:Literatur:Mustermann_2008}})
Blablabla (siehe Mustermann (2008)[1])
oder unter Nutzung des optionalen Übergabeparameters:
{{:Literatur:Mustermann_2008|Blablabla}}
Blablabla[1]
und dann am Ende der Seite:
<references/>
  1. 1.0 1.1 Mustermann, M. (2008): Mein Buch

Dies führt dazu, dass der Inhalt der Seite Literatur:Mustermann_2008 eingebunden wird. Wenn die Seite noch nicht existiert, wird ein roter Link angezeigt, über den man diese erstellen kann. Literaturseiten sollten folgende Syntax einhalten:

{{{1|Mustermann (2008)}}}<ref name="mustermann_2008">'''Mustermann, M.''' (2008): Mein Buch</ref><noinclude>
==Vorschau==
<references/>
</noinclude>

Erläuterung:

  • Alles, was sich zwischen den <noinclude> Tags befindet, wird nicht mit eingebunden und dient nur zur Vorschau der Literaturangabe.
  • Der Teil {{{1|xxxx}}} wird, wenn vorhanden, durch den Übergabeparameter ersetzt, ansonsten durch xxxx (im Beispiel Mustermann (2008)).
  • Der Text zwischen den <ref> Tags wird angezeigt, wenn man den Tag <references/> auf einer Seite benutzt (sollte am Ende der Seite geschehen).
  • Das Attribut name des <ref>-Tags dient dazu, die Literaturangabe eindeutig zu identifizieren, so dass sie nur einmal angezeigt wird, wenn sie auf einer Seite mehrmals benutzt wird.

DOI

DOI-Angaben im Format doi:XXXXXXXX werden automatisch mit dem DOI-Resolver http://dx.doi.org verlinkt.

Dokumente einbinden

Für das Einbinden von bereits hochgeladenen Dateien so, dass auch ein entsprechendes Icon angezeigt wird, kann man folgende Syntax nutzen: {{file|pdf|datei.pdf|Anzeigetext}} (Idee kommt von hier).
Akzeptierte Dateiformate sind pdf, doc, xls, mdb, ppt, zip. Beispiele:

{{file|pdf|Ostrowski 1992 Universeller Baustein.pdf|Ostrowski}}
Ostrowski information.png
{{file|doc|Macro.doc|Makro}}
Makro information.png

Formeln

Formeln können in Form von TeX-Markup innerhalb von <math></math> Tags eingegeben werden. Ausführliche Hilfe hier: Englisch / Deutsch

FreeMind Mind Maps

Mind Maps von Freemind können wie hier beschrieben eingebettet werden.

Syntaxhervorhebung

Syntax highlighting uses the SyntaxHighlighter Extension.

To highlight code, enclose it with source tags, e.g. <source lang="fortran"> </source>, oder <source lang="vbnet"> </source>.
Example:

<source lang="fortran" highlight="5">
      FUNCTION Test
c         Kommentar
          REAL :: variable(n),
     +            variable2
          variable(1) = variable2 + 5.03  ! Kommentar
      END FUNCTION
</source>
      FUNCTION Test
c         Kommentar
          REAL :: variable(n),
     +            variable2
          variable(1) = variable2 + 5.03  ! Kommentar
      END FUNCTION

Hierarchie

Die Hierarchy Extension kann dazu genutzt werden, Seiten hierarchisch anzuordnen.

Hierzu braucht man eine Index-Seite in der Form:

<index>
[[BlauesModell Theorie]]
= Betriebsregelkonzept =
== Grundlegende Typen von Betriebsregeln ==
...
</index>

Und in jede Seite innerhalb der Hierarchie müssen zwei Vorlagen integriert werden:

{{HierarchieKopf}}
Inhalt der Seite
{{HierarchieFuss}}

Änderungen an der Struktur der Hierarchie können an der Index-Seite vorgenommen werden. Die Hierarchie wird immer dann neu generiert, wenn man die Index-Seite speichert.

Integration mit Bugzilla und WebSVN

Zusätzlich zu den standardmäßigen magischen Wörtern in MediaWiki, sind in dieser Wiki-Installation die folgenden Wörter registriert:

  • Bug gefolgt von einer Zahl wird automatisch mit dem entsprechenden Bug in Bugzilla verlinkt. (z.B. Bug 1)
  • Rev oder Rev. gefolgt von einer Zahl wird automatisch mit der entsprechenden Revisionsansicht in WebSVN verlinkt. (z.B. Rev 1)

;Achtung: Verlinkung erfolgt momentan nur automatisch auf die Repository 'BlueM.Sim'!

Siehe auch den entsprechenden MediaWiki SVN Patch hierfür.

no longer working, workaround using interwiki links:
[[bugzilla:2]] → bugzilla:2
[[rev:2]] → rev:2 (assumes the repository BlueM.Sim)