OSLiC als LaTeX/BibTeX Entwicklung

Bitte berücksichtigen Sie, dass das Open Source License Compendium als eine Menge von ineinandergreifenden LaTeX-, BibTeX- und Make-Dateien entwickelt wird. Falls Sie mit diesen Techniken nicht vertraut sind oder Schwierigkeiten haben, die dafür nötigen Voraussetzung nicht zu erfüllen, sind Sie trotzdem eingeladen, über die Techniken der "fallweisen Partizipation" daran teilzuhaben.

Verwaltung der Sekundärliteratur

  • Verwenden Sie jabref und eine der vorbereiteten Bib-Dateien zur Verwaltung Ihrer Sekundärliteratur:
    • oscResourcesDe.bib  enthält verifizierte bibliographische Angaben mit deutschsprachigen BibTex 'annote's.
    • oscResourcesEn.bib enthält verifizierte bibliographische Angaben mit englischsprachigen BibTex 'annote's..
    • oscCopiedButNotRead.bib enthält die schon verifizierten bibliographischen Angaben der noch ungelesenen reps. nicht evaluierten Literatur.
    • oscNextActions.bib enthält Daten, die noch verifiziert werden müssen.
    • oscSomedayMaybe.bib enthält die bibliographischen Daten von Werken die erst später ausgewertet werden.
  • Um jabref entsprechend zu konfigurieren, importieren Sie btexmat/myScholarJabrefPrefs.xml über den jabref-Menue-Eintrag 'preferences'.
  • Um Ihre eingegeben bibliographischen Daten Korrektur zu lesen, lassen Sie sich die entsprechende Literaturliste kompilieren, die unter btexmat bereitliegt:
    • oscRevResources[De|En].tex erzeugt eine dvi/pdf Datei, die alle Einträge aus der BibTeX-Datei ocsResources[DeEn].bib auflistet, und zwar mit den [deutschen|englisch] Kommentaren und Abkürzungen.
    • oscBibRevCopiedButNotRead.tex erzeugt eine dvi/pdf files Datei, die alle Einträge aus der BibTeX-Datei oscBibRevCopiedButNotRead.bib in englischer Konfiguration auflistet.
    • oscBibRevNextActionEn.tex gerzeugt eine dvi/pdf files Datei, die alle Einträge aus der BibTeX-Datei oscBibRevNextActionEn.bib in englischer Konfiguration auflistet.

Zweisprachige Bibfile-Verwaltung

Das OSLiC wird initial in Englisch geschrieben und erst zum Ende ins Deutsche übersetzt. Mithin sollten Sie bitte, sobald Sie verifizierte bibliographische Angaben hinzufügen, diese in die englischsprachig orientierte Datenbankdatei (oscResourcesEn.bib) mit englischen Annotationen und Abkürzungen UND in die deutschsprachig orientierte Datenbankdatei (oscResourcesDe.bib) mit deutschen Annotationen und Abkürzungen eintragen, und zwar UNTER DEMSELBEN BIBTEXKEY!

Das Erstellen von Exzerpten und Snippets

Um Exzerpte und Zusammenfassung zu erzeugen, kopieren Sie die Datei templates/oscExtractTplEn.tex in den Ordner extracts, benennen Sie sie entsprechend des Bibkeys des zu exzerpierenden Werkes um, öffnen Sie Eclipse/Texlipse, Winefish, Texmaker oder vi und beginnen Sie mit Ihrer Arbeit.

Um ein in Ihr Hauptforschungspapier inkludierbares Snippet zu erzeugen, wechseln Sie in den snippet-Ordner, kopieren Sie die Datei oscSnippetInc.tex in den Kapitelordner und benennen Sie sie entsprechend um. Öffnen Sie dann Eclipse/Texlipse, Winefish, Texmaker oder vi und beginnen Sie mit Ihrer Arbeit. Wenn Sie Ihren Text genieren lassen wollen, inkludieren Sie das Snippet in die Hauptdatei oder in die Datei snippets/oscSnippetFrame.tex, bevor Sie das jeweilige Rahmendokument kompilieren lassen.

Arbeiten am eigentlichen Inhalt

Um das OSLiC selbst zu überarbeiten, starten Sie Ihren bevorzugten LaTeX Editor und öffnen die die jeweilige Kapiteldatei, die Sie im entsprechenden Subordner innerhalb des Ordners snippets/ finden. Wenn Sie einen eigenen Abschnitt als Snippet hinzufügen wollen, kopieren Sie bitte die Datei snippets/oscSnippet.tex der Kapitelposition entsprechend in den zugehörigen Ordner und inkludieren Sie die Datei in der Hauptdatei oslic-en.tex.

Nur getrennte inkludierbare Inhaltsdateien

Bitte erleichtern Sie die Mergearbeit, in dem Sie neue Textabschnitte nur in neue separaten Datein ablegen und diese in den Haupttext inkludieren. Bitte schreiben Sie inhaltlichen Text nicht direkt in diese Hauptdatei oslic-en.tex.

Compiling the OSLiC LaTex Documents

  • For compiling any LaTeX-file ${NAME}.tex [except the include files following the pattern ${NAME}Inc.tex] as dvi or pdf file, open a bash, go to the directory containing the file and call make ${NAME}.dvi or make ${NAME}.pdf.
  • For deleting the LaTeX auxiliary-files, call make clean (resp. make dclean in the top directory).
  • If you want to work on a OpenOffice / LibreOffice compatible document, please call  make ${NAME}.rtf.