Styleguide:Techn. Integration mit Template: Unterschied zwischen den Versionen

Aus Imperia Support Wiki
Zeile 1: Zeile 1:
 
<div class="alert alert">Bitte nehmen Sie vor Beginn der Programmierung mit [mailto:landesredaktion@berlin.de?cc=support@berlin.de&Subject=externes%20Angebot%20-%20Integration%20mit%20Template der Landesredaktion und dem Support von Berlin.de] Kontakt auf, um die layoutorischen und technischen Rahmenbedingungen zu besprechen. </div>
 
<div class="alert alert">Bitte nehmen Sie vor Beginn der Programmierung mit [mailto:landesredaktion@berlin.de?cc=support@berlin.de&Subject=externes%20Angebot%20-%20Integration%20mit%20Template der Landesredaktion und dem Support von Berlin.de] Kontakt auf, um die layoutorischen und technischen Rahmenbedingungen zu besprechen. </div>
  
== Variante A (Standard für Landes-Layout) ==
+
<!-- == Variante A (Standard für Landes-Layout) == -->
  
Aus jedem Landesauftritt kann ein Template in beliebiger URL-tiefe erzeugt werden. Bitte klären Sie vorher mit den entsprechenden Bereichen ab, welcher Auftritt und ggf. welcher Pfad verwendet werden soll. Der Pfad bestimmt, welcher Menüpunkt in der Navigation hervorgehoben wird.  
+
Aus jedem Landesauftritt kann ein Template in beliebiger URL-tiefe erzeugt werden. Bitte klären Sie vorher mit den entsprechenden Bereichen ab, welcher Auftritt und ggf. welcher Pfad verwendet werden soll. Der Pfad bestimmt, welcher Menüpunkt in der Navigation hervorgehoben bzw. aufgeklappt wird.  
  
 
Beispiel:
 
Beispiel:
* '''STD''' - Layout mit vollständiger "Hülle" (Top-Bereich der Institution, linke Navigation, Sidebar und Footer): bspw. https://www.berlin.de/rbmskzl/aktuelles/__i9/std/
+
* '''STD''' - Layout mit vollständiger "Hülle" (Top-Bereich der Institution, Navigation inkl. Breadcrumb und kompletter Footer, zusätzlich kann noch Notfallbox, SozialWidget und Sidebar sichtbar sein): bspw. https://www.berlin.de/rbmskzl/aktuelles/__i9/std/
 
An Stelle des Platzhalters <code><nowiki><!-- Hier den Applikations-Content einfuegen --> <!-- CONTENT --></nowiki></code> kann der eigene Code eingefügt werden
 
An Stelle des Platzhalters <code><nowiki><!-- Hier den Applikations-Content einfuegen --> <!-- CONTENT --></nowiki></code> kann der eigene Code eingefügt werden
* '''OHNE''' - Layout mit Top-Bereich der Institution und Footer, aber ohne linke Navigation und Sidebar, somit ist die komplette Breite für die Applikation verfügbar: bspw. https://www.berlin.de/rbmskzl/aktuelles/__i9/ohne/
+
* '''OHNE''' - Layout mit Top-Bereich der Institution, Navigation und komplettem Footer, aber ohne Breadcrumb und ggf. Notfallbox, SocialWidget und Sidebar, somit ist mehr Platz für die Applikation verfügbar: bspw. https://www.berlin.de/rbmskzl/aktuelles/__i9/ohne/
 +
 
 +
<!--
 +
* '''PORTAL''' - Layout nur mit dem Portal-Header ohne Inhalte vom Imperia-Auftritt: bspw. https://www.berlin.de/rbmskzl/aktuelles/__i9/portal/
 +
-->
  
 
Welches Layout verwendet werden kann, muss mit der [mailto:landesredaktion@berlin.de Landesredaktion] abgestimmt werden.  
 
Welches Layout verwendet werden kann, muss mit der [mailto:landesredaktion@berlin.de Landesredaktion] abgestimmt werden.  
Zeile 24: Zeile 28:
 
*** css=0 - für einen Aufruf ohne CSS
 
*** css=0 - für einen Aufruf ohne CSS
 
*** js=0 - für einen Aufruf ohne JavaScript
 
*** js=0 - für einen Aufruf ohne JavaScript
*** Kombination beider Parameter ist natürlich auch möglich
+
*** die Kombination beider Parameter ist ebenfalls möglich
  
 
Beispiel für eine ESI (https://varnish-cache.org/docs/6.0/users-guide/esi.html?highlight=esi) -Zeile:
 
Beispiel für eine ESI (https://varnish-cache.org/docs/6.0/users-guide/esi.html?highlight=esi) -Zeile:
Zeile 32: Zeile 36:
 
Weitere Informationen dazu befinden sich auf der Seite [[Styleguide:Berlin.de_Subdomains]].
 
Weitere Informationen dazu befinden sich auf der Seite [[Styleguide:Berlin.de_Subdomains]].
  
== Variante B (ohne Bezug zu einem vorhandenen Landesauftritt) ==
+
<!--
 +
== Variante B (ohne Bezug zu einem vorhandenen Landesauftritt) ==  
  
 
Wir stellen ein Standard-Template ohne Bezug zu einem Landesauftritt unter folgender URL bereit:
 
Wir stellen ein Standard-Template ohne Bezug zu einem Landesauftritt unter folgender URL bereit:
Zeile 42: Zeile 47:
 
Im Template ist die Stelle markiert, an der sie ihren Inhalt dynamisch einfügen müssen.
 
Im Template ist die Stelle markiert, an der sie ihren Inhalt dynamisch einfügen müssen.
  
* Sie fügen ihre Header-Zeilen ein an der Stelle <code><nowiki><!-- HEAD --></nowiki></code>
+
* Sie fügen ihre Header-Zeilen ein an der Stelle <code><nowiki><!-- HEAD -->
* Sie fügen Ihren Content ein an der Stelle <code><nowiki><!-- CONTENT --></nowiki></code>
+
<!--
 +
</nowiki></code>
 +
* Sie fügen Ihren Content ein an der Stelle <code><nowiki><!-- CONTENT -->
 +
<!--
 +
</nowiki></code>
  
 
Sollten Sie eine Anwendung über https betreiben, empfehlen wir auch das Template als https abzurufen, damit z.B. der Internet Explorer nicht meckert: https://www.berlin.de/__i9/portal/
 
Sollten Sie eine Anwendung über https betreiben, empfehlen wir auch das Template als https abzurufen, damit z.B. der Internet Explorer nicht meckert: https://www.berlin.de/__i9/portal/
 +
-->
  
  

Version vom 22. Juli 2022, 07:56 Uhr

Bitte nehmen Sie vor Beginn der Programmierung mit der Landesredaktion und dem Support von Berlin.de Kontakt auf, um die layoutorischen und technischen Rahmenbedingungen zu besprechen.


Aus jedem Landesauftritt kann ein Template in beliebiger URL-tiefe erzeugt werden. Bitte klären Sie vorher mit den entsprechenden Bereichen ab, welcher Auftritt und ggf. welcher Pfad verwendet werden soll. Der Pfad bestimmt, welcher Menüpunkt in der Navigation hervorgehoben bzw. aufgeklappt wird.

Beispiel:

  • STD - Layout mit vollständiger "Hülle" (Top-Bereich der Institution, Navigation inkl. Breadcrumb und kompletter Footer, zusätzlich kann noch Notfallbox, SozialWidget und Sidebar sichtbar sein): bspw. https://www.berlin.de/rbmskzl/aktuelles/__i9/std/

An Stelle des Platzhalters <!-- Hier den Applikations-Content einfuegen --> <!-- CONTENT --> kann der eigene Code eingefügt werden

  • OHNE - Layout mit Top-Bereich der Institution, Navigation und komplettem Footer, aber ohne Breadcrumb und ggf. Notfallbox, SocialWidget und Sidebar, somit ist mehr Platz für die Applikation verfügbar: bspw. https://www.berlin.de/rbmskzl/aktuelles/__i9/ohne/


Welches Layout verwendet werden kann, muss mit der Landesredaktion abgestimmt werden.

Zusätzliche technische Möglichkeiten

Bei beiden Layout-Varianten können Sie sich auch nur 3 "Schnipsel" aufrufen, um sie direkt (z.b. via ESI) auf ihren Seiten einbinden zu können:

  • Sondervariante nur Landesfooter https://www.berlin.de/rbmskzl/aktuelles/__i9/std/landesfooter.inc = nur der dunkelgraue Landesfooter, bitte am Ende vor dem schließenden "</body>" einfügen, nicht gleichzeitig mit dem "foot.inc" verwenden
    • hier gibt es mit Parametern die Möglichkeit, das CSS und JavaScript nicht zu laden, folgende Parameter dazu an die Include-URL anhängen
      • css=0 - für einen Aufruf ohne CSS
      • js=0 - für einen Aufruf ohne JavaScript
      • die Kombination beider Parameter ist ebenfalls möglich

Beispiel für eine ESI (https://varnish-cache.org/docs/6.0/users-guide/esi.html?highlight=esi) -Zeile: <esi:include src="/rbmskzl/aktuelles/__i9/std/top.inc" onerror="continue" /> (in echte esi-Befehle kein http://www.berlin.de eintragen, sondern nur die halb-absolute URL)

Weitere Informationen dazu befinden sich auf der Seite Styleguide:Berlin.de_Subdomains.