Giter Club home page Giter Club logo

redaxo_docs_i18n's Introduction

REDAXO Dokumentation

Die aktuelle Live-Version ist hier ersichtlich: https://redaxo.org/doku/main

Hinweise zur Mitarbeit

Wir freuen uns sehr über Mitarbeit bei der REDAXO-Dokumentation. Ihr könnt gern jederzeit komplette Kapitel übernehmen (bitte mit polarpixel, tbaddade oder skerbis absprechen) oder einfach nur Verbesserungen und Korrekturen einbringen (dann am besten als Pull request)

Bitte beachten

Bei der Formatierung und dem Markdown-Syntax an vorhandenen Dokumenten orientieren, möglich sind:

  • Überschriften
  • Sprunganker
  • Listen
  • Tabellen
  • Hinweise (eingerückt mit > **Hinweis:** ...)
  • Inline-Code und Code-Blöcke (ausgezeichnet mit 3 Backticks)
  • Bilder
  • ABBR (Erläuterung weiter unten)

Tipp: Der Markdown-Editor eurer Wahl unterstützt möglicherweise Linting und weitere Formatierungshilfen.

Inhaltsverzeichnis

Diese Sprunganker-Navigation (Inhaltsverzeichnis des Kapitels) muss direkt am Anfang hinter der ersten Überschrift kommen. Direkt danach muss die zweite Überschrift folgen. Bitte in jedes Kapitel eine Sprunganker-Navigation integrieren:

# Seitenüberschrift

- [Überschrift](#anker-zur-ueberschrift)
- [Anker 2](#anker-2)
    - [Anker 2a](#anker2a)
- [Anker 3](#anker-3)
    - [Anker 3a](#anker-3a)
    - [Anker 3b](#anker-3b)
    - [Anker 3c](#anker-3c)
- [Anker 4](#anker-4)

<a name="anker-zur-ueberschrift"></a>

## Überschrift 

[...]

Bearbeitungsstatus

Wenn man sich einen Inhalt vornimmt, bitte mit Namen und Status markieren in der dokumentation.md

Hinweis: Die Links in der Inhaltsverzeichnis-Datei dokumentation.md funktionieren nicht innerhalb von GitHub, da sie vorbereitet sind für den automatischen Import in die REDAXO-Website. Ihr müsst daher die gewünschte Datei selbst auswählen und öffnen.

Schreibstil

  • Möglichst ohne direkte Anrede (Du / Sie) auskommen. Falls in Ausnahmefällen nicht möglich, dann "Du" verwenden statt "Sie"

Schreibweisen häufig vorkommender Begriffe

  • REDAXO
  • AddOn
  • PlugIn

Coding-Standard

Bei den Code-Beispielen bitte bei den allgemein gültigen REDAXO-Coding-Standard beachten: http://symfony.com/doc/current/contributing/code/standards.html

Bilder und Screenshots

  • Breite 1600 Pixel Breite. Höhe, wie man es braucht.
  • Kein Browserfenster soll zu sehen sein.
  • Immer den kompletten REDAXO-Inhalt, inklusive Navigation.
  • Benennung: v5.2.0-[Kennung-was-das-Bild-zeigt].png
  • In den Assets-Ordner.
  • Immer Standard-Theme mit aktivierten AddOns aus der Installation verwenden, damit die Navigation gleich aussieht.

ABBR

Mit ABBR kann beim überfahren mit der Maus zum Beispiel die Langform einer Abkürzung anzeigt werden.

Steht irgendwo im Text z.B. folgendes: BSI, kann mit diesem Code der zusätzliche Hinweis angezeigt werden:

*[BSI]: Bundesamt für Sicherheit in der Informationstechnik

Beispiel aus der installation.md

Mehr dazu kann hier nachgelesen werden: PHP Markdown Extra

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.