Skip to content
GitLab
Switch branch/tag
Find file Normal viewHistoryPermalink
gitlab-pages.html 35.5 KB
Newer Older
Wolfgang Knopki's avatar
first chapter documentation gitlab pages  
Wolfgang Knopki committed
1
2
3
4
5
6 
<!DOCTYPE html>
<html>

<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0, shrink-to-fit=no">
Wolfgang Knopki's avatar
configured help section according to feedback from meeting today    
Wolfgang Knopki committed
7 
    <title>Hilfe: Gitlab-Pages</title>
Wolfgang Knopki's avatar
first chapter documentation gitlab pages  
Wolfgang Knopki committed
8
9
10
11
12
13
14
15
16
17
18
19 
    <link rel="stylesheet" href="/css/bootstrap.min.css">
    <link rel="stylesheet" href="/css/m4lab.css">
    <link rel="stylesheet" href="/fonts/font-awesome.min.css">
    <link rel="stylesheet" href="/fonts/ionicons.min.css">
    <link rel="stylesheet" href="/css/Testimonials.css">
    <link rel="stylesheet" href="/css/help.css">
    <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.8.2/css/all.css" integrity="sha384-oS3vJWv+0UjzBfQzYUhtDYW+Pj2yciDJxpsK1OYPAYjqT085Qq/1cq5FLXAZQ7Ay" crossorigin="anonymous">
</head>

<body>

    <div style="background-color: #dadada;">
Wolfgang Knopki's avatar
configured help section according to feedback from meeting today    
Wolfgang Knopki committed
20
Wolfgang Knopki's avatar
first chapter documentation gitlab pages  
Wolfgang Knopki committed
21
22
23 
        <div class="container" style="background-color: #ffffff;margin-bottom: 30px;">
            <div class="row">
            </div>
Wolfgang Knopki's avatar
configured help section according to feedback from meeting today    
Wolfgang Knopki committed
24 
       </div>
Wolfgang Knopki's avatar
first chapter documentation gitlab pages  
Wolfgang Knopki committed
25
26
27
28 
        <div id="Gitlab_Text" style="margin-top: 40px;margin-bottom: 30px;">
            <div class="container" style="background-color: #ffffff;">
                <div style="margin-bottom: 0;padding-top: 20px;padding-bottom: 20px;">
                    <div class="col-lg-12">
Wolfgang Knopki's avatar
configured help section according to feedback from meeting today    
Wolfgang Knopki committed
29 
                        <h2 class="d-flex flex-column flex-shrink-1 justify-content-lg-start text-center" style="padding-top: 15px;color: #708090;"><strong>Gitlab-pages</strong></h2>
Wolfgang Knopki's avatar
first chapter documentation gitlab pages  
Wolfgang Knopki committed
30
31
32
33
34 
                    </div>
                    <div class="col-auto flex-row flex-grow-1 flex-fill" style="background-color: #ffffff;">
                        <p><a href="https://de.wikipedia.org/wiki/GitLab">GitLab</a> ist eine umfangreiche Webanwendung zur Versionsverwaltung für Softwareprojekte auf Basis von <a href="https://de.wikipedia.org/wiki/Git">Git</a> die auch Wiki-Funktionen und Issue Tracking bietet. Das Transferportal der HFT-Stuttgart betreibt eine eigene GitLab-Instanz für die Hochschule für Technik Stuttgart und ihre Kooperationspartner unter einer Open-Access-Lizenz. Mit <a href="https://docs.gitlab.com/ee/user/project/pages/">GitLab Pages </a> besteht für Angehörige der HFT die Möglichkeit, eine öffentliche statische Projektwebsite aus einem GitLab-Projekt heraus zu erzeugen. 
                        </p><p>
                        Die URL, unter der die Seite dann zu finden ist, lautet: <br/> <br/>
Wolfgang Knopki's avatar
adapted help to new workflow    
Wolfgang Knopki committed
35 
                        <p class="justify-content-lg-start text-center">https://transfer.hft-stuttgart.de/pages/EIGENTUEMER/PROJEKTNAME/</p>
Wolfgang Knopki's avatar
first chapter documentation gitlab pages  
Wolfgang Knopki committed
36
37
38
39
40
41
42
43
44
45
46 
                        </p>
                    </div>
                    <a class="btn btn-primary text-center d-inline-flex d-lg-flex flex-column flex-grow-1 flex-shrink-1 flex-fill justify-content-between align-items-baseline align-content-center align-self-baseline flex-wrap order-3 mb-auto justify-content-md-center align-items-md-end align-items-lg-center justify-content-xl-center mx-auto"
                            role="button" style="background-color: #E0001B;" href="https://transfer.hft-stuttgart.de/gitlab/explore/projects"><strong>Zugriff auf Gitlab</strong></a>
                </div>
            </div>
        </div>
        <div id="create_Text" style="margin-top: 10px;margin-bottom: 30px;">
            <div class="container" style="background-color: #ffffff;">
                <div style="margin-bottom: 0;padding-top: 20px;padding-bottom: 20px;">
                    <div class="col-lg-12">
Wolfgang Knopki's avatar
configured help section according to feedback from meeting today    
Wolfgang Knopki committed
47 
                        <h2 class="d-flex flex-column order-1 justify-content-lg-start text-center" style="padding-top: 15px;color: #708090;"><strong>Gitlab-pages Projekte</strong></h2>
Wolfgang Knopki's avatar
first chapter documentation gitlab pages  
Wolfgang Knopki committed
48
49 
                    </div>
                    <div class="col-auto" style="background-color: #ffffff;">
Wolfgang Knopki's avatar
configured help section according to feedback from meeting today    
Wolfgang Knopki committed
50
51
52
53
54
55
56
57 
                        <div class="help">
                            <div class="card">
                                <div class="card-header">
                                    <h3 class="card-title">
                                        <a class="collapsed" data-toggle="collapse" href="#collapse1" aria-expanded="false" aria-controls="collapse1">
                                        <small>Gitlab-pages Projekt erstellen</small></a>
                                    </h3>
                                </div>
Athanasios's avatar
Update pages help    
Athanasios committed
58 
                                <div id="collapse1" class="card-body collapse">
Wolfgang Knopki's avatar
configured help section according to feedback from meeting today    
Wolfgang Knopki committed
59
60
61
62
63
64
65 
                                    <p>
                                        Um ein eigenes Gitlab-pages Projekt zu erstellen und damit eine eigene Projektseite zu erstellen, führen Sie folgende Schritte aus:
                                    </p>
                                    <ol>
                                        <li> Legen Sie sich auf <a href="https://transfer.hft-stuttgart.de"> https://transfer.hft-stuttgart.de</a> ein Benutzerkonto an bzw. loggen Sie sich   mit Ihren HFT-Nutzerdaten in das Transferportal ein.</li>
                                        <li> Besuchen Sie die Website <a href="https://transfer.hft-stuttgart.de/gitlab/explore/projects">https://transfer.hft-stuttgart.de/gitlab/explore/projects</a></li>
                                        <li> Loggen Sie sich mit ihren Anmeldedaten ein </li>
Wolfgang Knopki's avatar
adapted help to new workflow    
Wolfgang Knopki committed
66
67
68 
					<li> Standardmäßig wird Ihr Projekt als persönliches Projekt veröffentlicht, es wird also an Ihren persönlichen Benutzernamen gekoppelt, der dann auch in der URL auftaucht. Wenn Sie dies nicht wünschen, erstellen Sie eine neue Gruppe, unter der Sie das Projekt erstellen. Klicken Sie dazu auf <em>Groups</em>, <em> Your Groups </em> und wählen <em> New group </em> aus. Hier können Sie nun der Gruppe einen entsprechenden Namen geben. <p> <strong> Wichtig: </strong> Dieser Name wird später auch in der URL auftauchen, unter der Ihre Seite aufrufbar ist.</p> Nach Klick auf <em>create group</em> wird Ihre Gruppe angelegt, und Sie werden automatisch zur Gruppenseite weitergeleitet. 
						<img src="/img/help/newgroup.png" width="95%"/>
					</li>
Wolfgang Knopki's avatar
configured help section according to feedback from meeting today    
Wolfgang Knopki committed
69
70
71 
                                        <li> Legen Sie ein neues Projekt an, indem Sie auf den Button <em> New Project </em> klicken
                                            <img src="/img/help/newproject.png" width="95%"/>
                                        </li>
Wolfgang Knopki's avatar
adapted help to new workflow    
Wolfgang Knopki committed
72 
                                        <li> Wählen Sie <em> Create from template </em> aus und nutzen Sie ein Template aus dem Bereich <em> Instance </em>, Klicken Sie dort auf <em> Use template</em> <img src="/img/help/fromtemplate.png" width="95%"/> <img src="/img/help/choosetemplate.png" width="95%"/> </li>
Wolfgang Knopki's avatar
configured help section according to feedback from meeting today    
Wolfgang Knopki committed
73
74
75 
                                        <li> Nun können Sie ihr Projekt befüllen. Tragen Sie mindestens die Grundinformationen wie <em> Project name </em> und <em> Project description </em> ein.<img src="/img/help/createproject.png" width="95%"/> </li>
                                        <li> Klicken Sie auf <em> Create project</em></li>
                                        <li>
Athanasios's avatar
Update pages help    
Athanasios committed
76
77 
                                            Ihr Projekt wird nun erstellt und enthält automatisch die notwendigen Grundeinstellungen für das Publizieren einer Website über die Funktion Pages. Vor allem wird im Repositorium der Ordner <em> Public </em> angelegt. 
                                            <img src="/img/help/folderpublic.png" width="95%"/> <br/>
Wolfgang Knopki's avatar
configured help section according to feedback from meeting today    
Wolfgang Knopki committed
78
79
80
81 
                                        </li>
                                        <li> 
                                            Um Ihre eigenen Projektinhalte zu veröffentlichen, können Sie entweder eine komplett eigene HTML-Seite erzeugen oder sich an unseren Vorgaben aus dem Template orientieren. Eine Anleitung zur Verwendung unserer Vorlage finden Sie im Bereich <a href="#template_Text">Gitlab-pages Template benutzen</a> 
                                        </li>
Wolfgang Knopki's avatar
adapted help to new workflow    
Wolfgang Knopki committed
82
83
84
85
86
87
88 
                                        <li id="li_url"> 
                                            Sobald Sie Änderungen an Ihrer Seite vornehmen und diese in den Master-Branch eintragen (der Standard-Branch ihres Projektes), wird das Projekt veröffentlicht. Um den Link zu sehen, unter dem Sie Ihre Seite finden, gehen Sie in der Sitebar auf der linken Seite unter <em>CI / CD </em> auf <em>Jobs</em> und wählen den obersten Job mit den Namen <em> pages </em> aus. Im nun angezeigten Log finden Sie die Adresse, unter der Ihr Projekt ausgerollt wurde.
					    <img src="/img/help/show_jobs.png" width="95%">
					    <img src="/img/help/log_link.png" width="95%">						
					</li>
					<li>
					    Für weitere Schritte gehen Sie zum nächsten Abschnitt.
Wolfgang Knopki's avatar
configured help section according to feedback from meeting today    
Wolfgang Knopki committed
89
90
91
92
93
94
95
96
97
98
99
100 
                                        </li>
                                    </ol>
                                </div>
                            </div>
                            <br/>
                            <div class="card">
                                <div class="card-header">
                                    <h3 class="card-title">
                                        <a class="collapsed" data-toggle="collapse" href="#collapse2" aria-expanded="false" aria-controls="collapse2">
                                        <small>Gitlab-pages Projekt ändern</small></a>
                                    </h3>
                                </div>
Athanasios's avatar
Update pages help    
Athanasios committed
101 
                                <div id="collapse2" class="card-body collapse">
Wolfgang Knopki's avatar
configured help section according to feedback from meeting today    
Wolfgang Knopki committed
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133 
                                    <p>
                                        Nachdem Ihr Projekt das erste Mal veröffentlicht wurde, möchten Sie sicherlich Änderungen an der Seite vornehmen. Dafür gehen Sie wie folgt vor:
                                        <ol>
                                            <li> 
                                                Klicken Sie die Datei, die Sie ändern wollen, in der Projektübersicht an <img src="/img/help/content_index_marked.png" width="95%"/>
                                            </li>
                                            <li> 
                                                Klicken Sie in der sich nun öffnenden Dateiansicht auf <em> Edit </em> <img src="/img/help/file_view.png" width="95%"/>
                                            </li>
                                            <li> 
                                                Bearbeiten Sie ihre Datei 
                                            </li>
                                            <li> 
                                                Um die Änderungen zu speichern und auf ihrer Seite sofort zu übernehmen, klicken Sie auf <em> Commit changes </em> 
                                                <img src="/img/help/save_file.png" width="95%"/>
                                            </li>
                                            <li> 
                                                In der Projektübersicht sehen Sie nun den Status der Deployment-Pipeline, die ihre Webseite auf unserem Server veröffentlicht. Durch Klick auf das Symbol gelangen Sie zu einer Übersicht aller für Ihr Projekt angelaufenen Pipelines.
                                                <img src="/img/help/pipeline_pending.png" width="95%"/><br/>
                                                Durch Klick auf eine Pipeline wird Ihnen eine Erklärung zum aktuellen Status angezeigt, der Sie auch eventuelle Probleme entnehmen können.
                                                <img src="/img/help/overview_pipelines.png" width="95%"/><br/>
                                                Eine fehlerfrei durchgelaufene Pipeline liefert etwa ein solches Ergebnis:
                                                <img src="/img/help/output.png" width="95%"/><br/>
                                                Für eine Übersicht über häufig auftretende Fehler und was man dagegen tun kann, siehe <a href="#error_Text"> hier </a>.
                                            </li>
                                            <li> Wenn die Änderungen an Ihrer Homepage ohne Probleme übernommen wurden, sehen Sie dies an einem grünen Haken in der Projektübersicht
                                                <img src="/img/help/pipeline_good.png" width="95%"/>
                                            </li>
                                        </ol>
                                    </p>
                                </div>
                            </div>
Wolfgang Knopki's avatar
fixed breaks and internal linking    
Wolfgang Knopki committed
134 
			    <br/>
Wolfgang Knopki's avatar
adapted help to new workflow    
Wolfgang Knopki committed
135
136
137 
                            <div class="card">
                                <div class="card-header">
                                    <h3 class="card-title">
Wolfgang Knopki's avatar
fixed breaks and internal linking    
Wolfgang Knopki committed
138 
                                        <a class="collapsed" data-toggle="collapse" href="#collapsedel" aria-expanded="false" aria-controls="collapsedel">
Wolfgang Knopki's avatar
adapted help to new workflow    
Wolfgang Knopki committed
139
140
141 
                                        <small>Gitlab-pages Seite entfernen</small></a>
                                    </h3>
                                </div>
Athanasios's avatar
Update pages help    
Athanasios committed
142 
                                <div id="collapsedel" class="card-body collapse">
Wolfgang Knopki's avatar
adapted help to new workflow    
Wolfgang Knopki committed
143
144
145
146
147
148
149
150
151
152
153
154
155
156 
                                    <p>
                                        Um Ihre gitlab-pages Seite zu entfernen, gibt es zwei Möglichkeiten. Sie können entweder das gesamte Projekt löschen, oder aber nur die öffentliche Seite, das Projekt aber behalten, um daran Änderungen vorzunehmen. Um nur die Seite, nicht aber das Projekt an sich zu löschen, gehen Sie wie folgt vor:
                                        <ol>
                                            <li> 
                                                Klicken Sie in der linken Sitebar auf <em> Settings </em> und <em>pages </em>.
                                            </li>
                                            <li> 
                                                Klicken Sie in der sich nun öffnenden Konfigurationsansicht auf <em> Remove pages </em>. Dies entfernt die Seite von unserem Server, das Projekt an sich bleibt aber erhalten.
                                            </li>
                                        </ol>
                                    </p>
                                </div>
                            </div>
Wolfgang Knopki's avatar
configured help section according to feedback from meeting today    
Wolfgang Knopki committed
157 
                        </div>
Wolfgang Knopki's avatar
first chapter documentation gitlab pages  
Wolfgang Knopki committed
158
159
160
161
162 
                    </div>
                </div>
            </div>
        </div>
Wolfgang Knopki's avatar
second chapter    
Wolfgang Knopki committed
163
164
165
166 
        <div id="error_Text" style="margin-top: 10px;margin-bottom: 30px;">
            <div class="container" style="background-color: #ffffff;">
                <div style="margin-bottom: 0;padding-top: 20px;padding-bottom: 20px;">
                    <div class="col-lg-12">
Wolfgang Knopki's avatar
adapted help to new workflow    
Wolfgang Knopki committed
167 
                        <h2 class="d-flex flex-column order-1 justify-content-lg-start text-center" style="padding-top: 15px;color: #708090;"><strong>Häufige Fragen und Probleme</strong></h2>
Wolfgang Knopki's avatar
second chapter    
Wolfgang Knopki committed
168
169
170
171
172 
                    </div>
                    <div class="col-auto" style="background-color: #ffffff;">
                        <p>
                            <ul>
                                <li>
Wolfgang Knopki's avatar
adapted help to new workflow    
Wolfgang Knopki committed
173
174
175
176
177
178 
                                    <h6> Pipeline schlägt beim Schritt <em> pages-test </em> fehl </h6>
                                    <p> In diesem Fall ist Ihr Projekt noch nicht vollständig konfiguriert. Bitte konfigurieren Sie ihr Projekt entsprechend der Vorlage im nächsten Abschnitt </p>
                                </li>

                                <li>
                                    <h6> Ich habe ein Gitlab-pages-Projekt erstellt, unter <em>Settings/ pages</em> steht aber eine kryptische URL der Form *.thishost.local:8090/*, die nicht funktioniert. </h6>
Wolfgang Knopki's avatar
faq adapted with link finding explanation    
Wolfgang Knopki committed
179 
                                    <p> Dies ist die interne Repräsentation des Projektes auf unserem Server und ist somit nicht von außerhalb ereichbar. Um die tatsächliche, von außen erreichbare URL Ihrer Seite zu finden, gehen Sie in der Sitebar auf der linken Seite unter <em>CI / CD </em> auf <em>Jobs</em> und wählen den obersten Job mit den Namen <em> pages </em> aus. Im nun angezeigten Log finden Sie die Adresse, unter der Ihr Projekt ausgerollt wurde.</p>
Wolfgang Knopki's avatar
second chapter    
Wolfgang Knopki committed
180 
                                </li>
Wolfgang Knopki's avatar
faq adapted size limit artifacts    
Wolfgang Knopki committed
181
182 
				<li>
                                    <h6> Ich möchte größere Projektdaten hochladen, wie groß darf mein Projekt maximal sein? </h6>
Wolfgang Knopki's avatar
faq missing parentheses    
Wolfgang Knopki committed
183 
                                    <p> Gegenwärtig ist die Gesamtgröße der ausgerollten Seite (Ordner <em> public </em>) auf 2 GB beschränkt.</p>
Wolfgang Knopki's avatar
faq adapted size limit artifacts    
Wolfgang Knopki committed
184 
                                </li>
Wolfgang Knopki's avatar
second chapter    
Wolfgang Knopki committed
185
186
187
188
189
190
191
192
193
194
195
196
197
198 
                            </ul>
                        </p>
                    </div>
                     <a class="btn btn-primary text-center d-inline-flex d-lg-flex flex-column flex-grow-1 flex-shrink-1 flex-fill justify-content-between align-items-baseline align-content-center align-self-baseline flex-wrap order-3 mb-auto justify-content-md-center align-items-md-end align-items-lg-center justify-content-xl-center mx-auto"
                            role="button" style="background-color: #E0001B;" href="mailto:support-transfer@hft-stuttgart.de"><strong>Administratorkontakt</strong></a>
                </div>
            </div>
        </div>
        
        
        <div id="template_Text" style="margin-top: 10px;margin-bottom: 30px;">
            <div class="container" style="background-color: #ffffff;">
                <div style="margin-bottom: 0;padding-top: 20px;padding-bottom: 20px;">
                    <div class="col-lg-12">
Wolfgang Knopki's avatar
adapted help to new workflow    
Wolfgang Knopki committed
199 
                        <h2 class="d-flex flex-column order-1 justify-content-lg-start text-center" style="padding-top: 15px;color: #708090;"><strong>Gitlab-pages Template <em>pages-basic</em>  benutzen</strong></h2>
Wolfgang Knopki's avatar
second chapter    
Wolfgang Knopki committed
200
201
202
203 
                    </div>
                    <div class="col-auto" style="background-color: #ffffff;">
                        <p>
                            Wir stellen eine Vorlage für Projektwebseiten zur Verfügung.
Wolfgang Knopki's avatar
first chapter documentation gitlab pages  
Wolfgang Knopki committed
204 
                        </p>
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
205
206
207
208 
                        <div class="help">
                            <div class="card">
                                <div class="card-header">
                                    <h3 class="card-title">
Athanasios's avatar
Update pages help    
Athanasios committed
209 
                                        <a class="collapsed" data-toggle="collapse" href="#collapse3" aria-expanded="false" aria-controls="collapse3">
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
210
211
212 
                                        <small>Erste Schritte</small></a>
                                    </h3>
                                </div>
Athanasios's avatar
Update pages help    
Athanasios committed
213 
                                <div id="collapse3" class="card-body collapse">
Athanasios's avatar
Update pages help    
Athanasios committed
214
215
216
217
218
219
220
221
222
223
224
225
226
227 
                                    <p>
                                        A template can be a single page or it can be multiple pages with a menu to select them. 
                                        If the name of a template begins with the word "simple" then it is a single page template. This is the general structure of a template:
                                    </p>
                                    <img src="/img/help/content_public.jpg"/>
                                    <p><em>assets</em> folder: You place in this folder files that should be common for the single page or all the pages of your gitlab template. E.g. you should place any personal avatars or partner logos in the corresponding folders (images, logos).</p>
                                    <p><em>home</em> folder: This is the default folder where you place your main page (think of it as the landing page).</p>
                                    <p><em>settings.js</em>: This is the file where you select the settings for your gitlab page.</p>
                                    <p>You should not make changes to some of the files.</p>
                                    <img src="/img/help/content_public_colors.jpg"/>
                                    <p>Red: Those files should not be changed.</p>
                                    <p>Orange: Those files should be replaced by your own files. The filename should remain the same. If there are files that should be replaced depends on the template you choose.</p>
                                    <p>Green: Those files you can edit.</p>
                                    <p>Blue: In those folders you can add your additional files. In case of assets, images, logos etc. In case of a template folder, your custom css, javascript or any other files.</p>
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
228
229
230
231
232
233
234
235
236
237
238
239 
                                    <p>
                                        Um unsere Vorlage zu benutzen, müssen Sie folgende Schritte ausführen:
                                    </p>
                                    <ol>
                                        <li> Anpassen der Standardwerte in settings.js 
                                            <p><b> Wichtig: </b> Werden diese Werte nicht angepasst, wird das Projekt nicht auf unseren Servern ausgerollt und die deployment-Pipeline wirft einen Fehler 
                                            </p>
                                            <p> 
                                                Klicken Sie dazu im Ordner <em> public </em> auf die Datei <em> settings.js </em> und editieren Sie die Datei. 
                                            </p>
                                            <img src="/img/help/select_settings.png" width="95%"/>
                                            <p>
Athanasios's avatar
Update pages help    
Athanasios committed
240 
                                                Those are the default values for the social networks/personal website of a participant and the default avatar. It is recommended not to change them, but you can add another social network if you want.
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
241 
                                            </p>
Athanasios's avatar
Update pages help    
Athanasios committed
242
243
244 
                                            <img src="/img/help/default_settings.png"/>
                                            <p>The switches control which parts of you gitlab page should turn on or off. E.g. if you want a single page and not a menu then you change the menu value to OFF.</p>
                                            <img src="/img/help/switches.png"/>
Athanasios's avatar
Update pages help    
Athanasios committed
245
246 
                                            <p>Here you change the project logo. The logo will appear centered at the top of the page. If the switch for the project logo is OFF then it will not be visible.</p>
                                            <img src="/img/help/pr_logo.png"/>
Athanasios's avatar
Update pages help    
Athanasios committed
247
248
249
250 
                                            <p>Here you change the project name. If the switch for the project name is OFF then it will not be visible.</p>
                                            <img src="/img/help/pr_name.png"/>
                                            <p>Here you change the menu of your gitlab page. A menu can be linked with a folder/template or with an external link, e.g. a demo. You can add or remove menu entries. You hide the menu when the switch is OFF. 
                                                Don't forget to add the forward slash at the end of a menu link if it is pointing to a folder.
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
251 
                                            </p>
Athanasios's avatar
Update pages help    
Athanasios committed
252
253
254 
                                            <img src="/img/help/menu.png"/>
                                            <p>Here you change the participants. You can use default values for a social network (They point to HFT's social networks) or you can use your own profiles. 
                                                You can also add your personal webpage. You can add or remove a social network. You can also use a personal avatar or the default one (DEFAULT.avatar).
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
255 
                                            </p>
Athanasios's avatar
Update pages help    
Athanasios committed
256
257
258
259
260
261
262 
                                            <img src="/img/help/partic.png"/>
                                            <p>
                                                Here is an example of two participants.
                                            </p>
                                            <img src="/img/help/partic2.png"/>
                                            <p>
                                                Here you change the footer logos of a project's partners. If you don't want a logo to link to an external website then use the href value EMPTY_LINK. The title will appear when you hover the mouse over a logo.
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
263 
                                            </p>
Athanasios's avatar
Update pages help    
Athanasios committed
264 
                                            <img src="/img/help/f_logos.png"/>
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
265
266
267 
                                            <p>
                                                Klicken Sie anschließend auf <em> commit changes </em>, um die Änderungen zu speichern.
                                            </p>
Athanasios's avatar
Update pages help    
Athanasios committed
268
269
270 

                                            <img src="/img/help/edit_settings.png" width="95%"/>
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
271
272
273
274
275
276
277
278 
                                        </li>
                                    </ol>
                                </div>
                            </div>
                            <br/>
                            <div class="card">
                                <div class="card-header">
                                    <h3 class="card-title">
Athanasios's avatar
Update pages help    
Athanasios committed
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303 
                                        <a class="collapsed" data-toggle="collapse" href="#collapse4" aria-expanded="false" aria-controls="collapse4">
                                        <small>Avatar hinzufügen</small></a>
                                    </h3>
                                </div>
                                <div id="collapse4" class="card-body collapse">
                                    <p> To add a personal avatar: 
                                        <ol>
                                            <li>
                                                Öffnen Sie den Ordner <em> public/assets/images </em> 
                                            </li>
                                            <li>
                                                Klicken Sie auf das + im Oberen Bereich, und anschließend auf <em> Upload File </em>
                                            </li>
                                            <li>
                                                It is recommended the avatar to be square or portrait oriented. Also, better do not upload large avatars (>500px). 
                                            </li>
                                        </ol>
                                    </p>
                                </div>
                            </div>
                            <br/>
                            <div class="card">
                                <div class="card-header">
                                    <h3 class="card-title">
                                        <a class="collapsed" data-toggle="collapse" href="#collapse5" aria-expanded="false" aria-controls="collapse5">
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
304
305
306 
                                        <small>Logo hinzufügen</small></a>
                                    </h3>
                                </div>
Athanasios's avatar
Update pages help    
Athanasios committed
307 
                                <div id="collapse5" class="card-body collapse">
Wolfgang Knopki's avatar
fixed text projectlogo    
Wolfgang Knopki committed
308 
                                    <p> Um ein eigenes Projektlogo zum Projekt hinzuzufügen, müssen Sie folgende Schritte ausführen:
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
309
310 
                                        <ol>
                                            <li>
Athanasios's avatar
Update pages help    
Athanasios committed
311 
                                                Öffnen Sie den Ordner <em> public/assets/logos </em>
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
312
313
314
315
316 
                                            </li>
                                            <li>
                                                Klicken Sie auf das + im Oberen Bereich, und anschließend auf <em> Upload File </em>
                                                <img src="/img/help/publicplus.png" width="95%"/>
                                            </li>
Athanasios's avatar
Update pages help    
Athanasios committed
317
318
319
320
321 
                                            <li>
                                                <p>
                                                    The logo should be square with dimentions 300x300 pixels
                                                </p>
                                            </li>
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
322
323
324
325
326
327
328 
                                            <li>
                                                Fügen Sie die gewünschte Datei hinzu und klicken Sie auf <em> Upload File </em>
                                                <img src="/img/help/upload_logo.png" width="95%"/>
                                            </li>
                                            <li> 
                                                Öffnen Sie nun im Ordner <em> public </em> die Datei <em> settings.js </em> und editieren diese.
                                                <p>
Athanasios's avatar
Update pages help    
Athanasios committed
329 
                                                    In der Zeile mit <em>projectLogo</em> schreiben Sie nun DATEINAME in die Anführungszeichen, um den Pfad zum Logo anzugeben. Ein Klick auf <em> Commit changes </em> speichert die Datei.
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
330 
                                                </p>
Athanasios's avatar
Update pages help    
Athanasios committed
331 
                                                <img src="/img/help/pr_logo.png"/>
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
332
333
334
335
336
337
338
339
340
341
342
343 
                                            </li>
                                            <li>
                                                Nun erscheint auf all Ihren Seiten das Projektlogo neben dem Logo der Hochschule. 
                                            </li>
                                        </ol>
                                    </p>
                                </div>
                            </div>
                            <br/>
                            <div class="card">
                                <div class="card-header">
                                    <h3 class="card-title">
Athanasios's avatar
Update pages help    
Athanasios committed
344 
                                        <a class="collapsed" data-toggle="collapse" href="#collapse6" aria-expanded="false" aria-controls="collapse6">
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
345
346
347 
                                        <small>Neue Seite hinzufügen</small></a>
                                    </h3>
                                </div>
Athanasios's avatar
Update pages help    
Athanasios committed
348 
                                <div id="collapse6" class="card-body collapse">
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
349
350
351 
                                    <p>
                                        Um Ihrem Projekt neue Seiten hinzuzufügen, führen Sie folgende Schritte aus:
                                        <ol>
Athanasios's avatar
Update pages help    
Athanasios committed
352
353
354 
                                            <li>
                                                Visit the templates folder and edit the index.html file. Select all the text inside this file and copy it. Then click the button <em>cancel</em>.
                                            </li>
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
355
356
357
358
359
360
361 
                                            <li>
                                                Klicken Sie im Ordner <em> public </em> auf das +, das sich oben neben dem Pfad befindet
                                                <img src="/img/help/publicplus.png" width="95%"/>
                                            </li>
                                            <li>
                                                Klicken Sie dort auf <em> New File </em>
                                            </li>
Athanasios's avatar
Update pages help    
Athanasios committed
362 
                                            <li>Paste the text you copied from the template</li>
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
363 
                                            <li>
Athanasios's avatar
Update pages help    
Athanasios committed
364 
                                                Geben Sie die Dateinamen index.html (<b> wichtig: </b> Endung .html)
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
365
366
367
368
369
370
371
372 

                                                <img src="/img/help/editnewpage.png" width="95%"/>
                                            </li>
                                            <li>
                                                Nun können Sie noch den Inhalt der Seite anpassen. Wenn Sie mit dem Inhalt der Seite zufrieden sind, speichern Sie sie durch Klick auf <em> Commit changes </em>
                                            </li>
                                            <li>
                                                Ihre Seite wird nun automatisch auf den Server übertragen und ist unter folgender Adresse erreichbar:
Wolfgang Knopki's avatar
adapted help to new workflow    
Wolfgang Knopki committed
373 
                                                <p>https://transfer.hft-stuttgart.de/pages/EIGENTUEMER/PROJEKTNAME/DATEINAME</p>
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
374
375
376
377
378 
                                            </li> 
                                        </ol>
                                    </p>
                                </div>
                            </div>
Athanasios's avatar
Update pages help    
Athanasios committed
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429 
                            <br/>
                            
                            <div class="card">
                                <div class="card-header">
                                    <h3 class="card-title">
                                        <a class="collapsed" data-toggle="collapse" href="#collapse7" aria-expanded="false" aria-controls="collapse7">
                                        <small>simple_raw template</small></a>
                                    </h3>
                                </div>
                                <div id="collapse7" class="card-body collapse">
                                    <p>This is a single page template with arbitrary content. In order to change the contents you have to edit the index.html file.</p>
                                </div>
                            </div>

                            <br/>

                            <div class="card">
                                <div class="card-header">
                                    <h3 class="card-title">
                                        <a class="collapsed" data-toggle="collapse" href="#collapse8" aria-expanded="false" aria-controls="collapse8">
                                        <small>simple_thesis template</small></a>
                                    </h3>
                                </div>
                                <div id="collapse8" class="card-body collapse">
                                    <p>
                                        This is a single page template for a thesis. Inside the home folder you have to replace the files with the cover of your thesis and the actual thesis file. 
                                        Then you have to edit the index.html file and replace your name, year, etc.
                                    </p>
                                </div>
                            </div>

                            <br/>

                            <div class="card">
                                <div class="card-header">
                                    <h3 class="card-title">
                                        <a class="collapsed" data-toggle="collapse" href="#collapse9" aria-expanded="false" aria-controls="collapse9">
                                        <small>generic template</small></a>
                                    </h3>
                                </div>
                                <div id="collapse9" class="card-body collapse">
                                    <p>
                                        When you use the generic template there is an additional folder called templates. Inside this folder you will find all the available templates. 
                                        In order to use a template, you have to copy the folder from templates/&lttemplate name&gt and paste it (when you edit your pages locally) in the root folder. 
                                        Then it’s a good practice to rename this folder with the menu text you want to link it. Notice that the home page always points to the home folder. 
                                        That means if you want to use a template as home page then you have to rename the folder to home.
                                    </p>
                                    <img src="/img/help/generic.png"/>
                                </div>
                            </div>
Wolfgang Knopki's avatar
added manual gitlab-pages template    
Wolfgang Knopki committed
430 
                        </div>
Wolfgang Knopki's avatar
first chapter documentation gitlab pages  
Wolfgang Knopki committed
431
432
433 
                </div>
            </div>
        </div>
Wolfgang Knopki's avatar
second chapter    
Wolfgang Knopki committed
434
Wolfgang Knopki's avatar
configured help section according to feedback from meeting today    
Wolfgang Knopki committed
435
436
437
438 
        <div class="container" style="background-color: #ffffff;margin-bottom: 30px;">
            <div class="row">
            </div>
       </div>
Wolfgang Knopki's avatar
first chapter documentation gitlab pages  
Wolfgang Knopki committed
439
440
441
442
443
444
445
446
447
448 
    </div>
</div>

<script src="https://code.jquery.com/jquery-3.3.1.slim.min.js" integrity="sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo" crossorigin="anonymous"></script>
<!--<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.7/umd/popper.min.js" integrity="sha384-UO2eT0CpHqdSJQ6hJty5KVphtPhzWj9WO1clHTMGa3JDZwrnQq4sF86dIHNDz0W1" crossorigin="anonymous"></script>-->
<script src="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/js/bootstrap.min.js" integrity="sha384-JjSmVgyd0p3pXB1rRibZUAYoIIy6OrQ6VrjIEaFf/nJGzIxFDsf4x0xIM+B07jRM" crossorigin="anonymous"></script>
<script src="/js/headfoot.js"></script>
</body>

</html>

Dies ist die Gitlab-Instanz des Transferportals der Hochschule für Technik Stuttgart. Hier geht es zurück zum Portal