Doku-Migration ins Wiki

[BjoernS]

Hallo zusammen,

wie von Fred angeregt habe ich in einem ersten Schritt die i-Telex-Gesamtbeschreibung aufs Wiki portiert. Fertig sind Gliederung und Formatierung, es fehlen noch die Bilder -- gibt es die irgendwo als Datei oder soll ich die einfach aus dem letzten Word-Dokument herausziehen?

Die Maßgabe dieser Version war erstmal, alles möglichst unverändert ins Wiki zu übernehmen, so dass man danach gemeinsam daran feilen kann. Gerade bei der Formatierung der Drucktexte musste ich Kompromisse eingehen (ohne Anspruch der Absolutheit). Ich bilde mir ein, gerade z.B. die Tabellendaten hinreichend sorgfältig übertragen zu haben, bin aber für Gegenprüfungen dankbar. Ansonsten bin ich offen für Kritik beider Vorzeichen.

Nächster Schritt wäre die Anleitung der Ethernetkarte, die ja aus der Gesamtbeschreibung ausgegliedert wurde.

Grüße


Björn

[detlef]

Finde ich super. Vor allem, dass das gesamte Dokument auf einer Seite steht, so dass man wieder unkompliziert ein "offline" PDF daraus erstellen kann.

[FredSonnenrein]

Klasse Arbeit... Bezüglich der Bilder: Ich habe diese ohne irgendwelche Umwandlungen direkt in Word eingebettet, d.h. es müsste noch immer der Originalzustand sein. Eigene Bilder habe ich eh nicht gemacht, die meisten sind von der i-Telex Homepage.
Was aber die Struktur als "ein Dokument" angeht: Ich hätte im ersten Ansatz vermutet, dass eine feinere Aufgliederung "nutzerfreundlicher" ist. Denn genau wie die PDF: Zu viel Information erschlägt manchmal. Aber dazu bin ich "diskussionsoffen".

[detlef]

Was aber die Struktur als "ein Dokument" angeht: Ich hätte im ersten Ansatz vermutet, dass eine feinere Aufgliederung "nutzerfreundlicher" ist. Denn genau wie die PDF: Zu viel Information erschlägt manchmal. Aber dazu bin ich "diskussionsoffen".

Wenn du mit "eine feinere Aufgliederung" die Aufteilung in mehrere Wiki-Seite meinst, dann wäre die Anleitung nur noch online nutzbar.
Auch eine einfach Volltextsuche nach Stichworten ist dann nicht mehr möglich. Oder kann man im Wiki eine Volltextsuche in einem Unterbereich machen?

Edit: Gibt es im Wiki überhaupt eine Suchfunktion? Ausser die im Browser?

[FredSonnenrein]

Gibt es im Wiki überhaupt eine Suchfunktion? Ausser die im Browser?

Die Eingabezeile oben rechts mit der Lupe ist dein Freund.

[tw137125]

Gibt es im Wiki überhaupt eine Suchfunktion? Ausser die im Browser?

Die Eingabezeile oben rechts mit der Lupe ist dein Freund.

Ist doch der Sinn eines Wiki, oder habe ich da was falsch verstanden ?

[BjoernS]

Was aber die Struktur als "ein Dokument" angeht: Ich hätte im ersten Ansatz vermutet, dass eine feinere Aufgliederung "nutzerfreundlicher" ist. Denn genau wie die PDF: Zu viel Information erschlägt manchmal. Aber dazu bin ich "diskussionsoffen".

Dachte ich auch, und habe mir die Richtlinien aus der Doku von Mediawiki und bei Wikipedia angesehen. Dort wird eher empfohlen, alles auf einer Seite zu lassen, gerade da z.B. das Editieren auch abschnittsweise möglich ist. An anderer Stelle gibt Wikipedia die Empfehlung, ab ca. 50k eine Trennung in Erwägung zu ziehen, sofern es Sinn ergibt. Der Artikel erreicht die Grenze gerade so. Aber das ist auch nur Wikipedia, die haben typischerweise keine Dokumentations-Artikel.

Fürs Erste würde ich die Struktur so behalten wie sie ist, da das fürs Eingeben einfacher ist (Gesamtbeschreibung und ausgegliederte Ethernet-Beschreibung), wenn nach der Übernahme Hand an die Struktur gelegt werden soll bin ich der letzte, der sich dagegen stellt.

Grüße


Björn

[detlef]

Gibt es im Wiki überhaupt eine Suchfunktion? Ausser die im Browser?

Die Eingabezeile oben rechts mit der Lupe ist dein Freund.

Wie blind kann man sein?

Aber die Suche sucht eben immer im ganzen Wiki. Ist also nicht so praktisch, wenn man was nur in der i-Telex-Beschreibung sucht.

[detlef]

Dachte ich auch, und habe mir die Richtlinien aus der Doku von Mediawiki und bei Wikipedia angesehen. Dort wird eher empfohlen, alles auf einer Seite zu lassen, gerade da z.B. das Editieren auch abschnittsweise möglich ist. An anderer Stelle gibt Wikipedia die Empfehlung, ab ca. 50k eine Trennung in Erwägung zu ziehen, sofern es Sinn ergibt. Der Artikel erreicht die Grenze gerade so. Aber das ist auch nur Wikipedia, die haben typischerweise keine Dokumentations-Artikel.

Die Strukturierung erfolgt ja durch das Menü am Anfang der Seite. Deswegen würde ich erst dann auftrennen, wenn es merkliche Wartezeit beim Laden gibt.

[BjoernS]

Hallo zusammen,

Bilder sind jetzt auch alle drin. Die Beispielmessung am Ende hat mich etwas aufgehalten, da sie im Ursprungsdokument mithilfe einer Tabelle realisiert war. Das als Wiki-Tabelle umzusetzen wollte ich mir nicht antun, deshalb habe ich es als SVG abgekupfert.

Leider darf man im i-Telex-Wiki kein SVG hochladen, deshalb habe ich ein PNG mit 600 dpi draus gemacht, das sollte reichen. Wer das Original haben will, gerne Bescheid sagen.

Grüße


Björn