proScientia.ltx

proSci­en­tia.ltx offers a set of con­fig­u­ra­tion- and tem­plate-files that allow schol­ars to do human­i­ties research work on the base of LaTeX, BibLa­TeX, Biber, and Jabref. The vis­i­ble result of these tools, the respec­tive con­fig­u­ra­tion files and con­tent files fol­low the style of (Ger­man) clas­si­cal philol­o­gy, Ger­man stud­ies and (Ger­man) his­to­ry.

By using this tool, I’ve writ­ten the pro­Sci­en­tia man­i­fest Über hil­fre­iche Anmerkungsap­pa­rate.

Objectives

proScientia.ltx deliv­ers a com­plete set of BibLaTex‑, LaTeX- und Make­files to

  1. to search for sec­ondary lit­er­a­ture,
  2. to main­tain the bib­li­o­graph­ic data,
  3. to gen­er­ate ‚abstracts‘ und excerpts
  4. to write one’s own sci­en­tif­ic work.

The out­stand­ing fea­ture of the proScientia.ltx is to man­age quo­ta­tions via foot­notes in accor­dance with the clas­si­cal (Ger­man) philo­log­i­cal stan­dard.

Exam­ples for this kind of doc­u­ment are human­i­ties, Demo in Ger­man, Demo in Eng­lish

Installation

Pre­req­ui­sites:

  • a LaTeX dis­tri­b­u­tion with dif­fer­ent packages/programs which should be part of your TeX-Dis­tri­b­u­tion includ­ing BibLa­TeX, Biber, bibla­tex-dw, Koma-Script
  • Beside your pre­ferred LaTeX edi­tor you need the tools bash and make

URLS:

Ini­tial­iza­tion:

  1. Clone the proScientia.ltx repos­i­to­ry via git clone https://github.com/kreincke/proScientia.ltx (or down­load and extract the respec­tive tar­ball)
  2. Open a shell, change into the proScientia.ltx direc­to­ry and
    • Select a project iden­ti­fi­er YOURPRJ that does not con­tain blanks or slash­es
    • exe­cute chmod 755 bin/collprj.sh
    • exe­cute collprj.sh YOURPRJ [de|en]
    • move the cre­at­ed project direc­to­ry to any oth­er work­ing place
  3. change into the cre­at­ed project direc­to­ry
  4. callmaketo ver­i­fy that the sys­tem is run­ning
  5. open and close you JabRef ver­sion once.
  6. call find $HOME -type f | grep jabref | grep customizedBiblatexTypes to deter­mine, where your JabRef con­fig­u­ra­tion files are stored
  7. copy cfg/jabref-prefs.xml to $HOME/.java/.userPrefs/org/jabref/prefs.xml (or wher­ev­er your sys­tems stores the gen­er­al JabRef con­fig­u­ra­tions)
  8. copy cfg/jabref-customizedBibLatexTypes-prefs.xml to $HOME/.java/.userPrefs/org/jabref/customizedBiblatexTypes/prefs.xml (or wher­ev­er your sys­tems stores the BibLa­tex lit­er­a­ture spec­i­fi­ca­tions)

Do your library work:

  • Change into the cre­at­ed project direc­to­ry
  • Update the file tools/search.tex in accor­dance with your needs.
  • cd tools && make search.pdf
  • Do your library research work as you planned it in tools/search.tex
  • Incor­po­rate the bib­li­o­graph­ic data into bib/lit.main.bib by using jabref or any oth­er text edi­tor
  • In case you eval­u­ate a web doc­u­ment, down­load the PDF files under proofs/BIBTEXKEY.pdf
  • copy extracts/extract.md to extract/BIBTEXKEY.md
  • read and excerpt the sec­ondary lit­er­a­ture in the respec­tive file

Write your work:

  • Edit / update your frame tex file proScientia.tex
  • Cre­ate your snip­pets by copy­ing snippets/inc.snippet.tex to snippets/inc.YOURCHOICE.tex and edit the files
  • Inte­grate the snip­pets by using the LaTeX com­mand input{snippets/inc.YOURCHOICE.tex}
  • Open a shell and type make proScientia.pdf to cre­ate a human-read­able ver­sion of your sci­en­tif­ic work.

If you want to rename the frame, also update the Make­file. If you want to see how the writ­ing work can be done and how the result looks, read Demo in Eng­lish or the proScientia.ltx man­i­fest. If help­ful, study the respec­tive sources under proScientia.ltx/humanities

proScientia.ltx is dis­trib­uted under the terms of the CC BY 4.0 license. Details are described in the README file.

To top