Skip to content
Elemmire edited this page Mar 9, 2023 · 26 revisions

Run xWalk (Google Sheets / FODS)

Schnellrezept

  • ipd.data updaten
update_git_repositories.sh
  • FODS mit Tab HGV unter ~/projects/xWalk/data/HGV.fods speichern
  • xWalk durchführen
cd ~/projects/xWalk
ENTWEDER
./xWalk.sh new
ODER
./xWalk.sh modified
  • nach ipd.data committen und pushen
cd ~/projects/xWalk/data/idp.data/papyri/xwalk
git add HGV_meta_EpiDoc
ENTWEDER
git commit -m 'HGV xwalk new files (fods)' HGV_meta_EpiDoc
ODER
git commit -m 'HGV xwalk modified files (fods)' HGV_meta_EpiDoc
git push papyri xwalk_papy:xwalk
  • pull request

Papyri’s xWalk branch on github

Schritte im Detail

  • update idp.data branches master and xwalk
  • prepare HGV data in a Google Sheet
  • convert the Google Sheet to FODS and save in xWalk’s data directory
    • in Google Sheets, navigate to menu entry File > Download > Comma Separated Values (.csv) to save the table »HGV« in CSV format
    • open the CSV file in Libre Office, rename the tab to »HGV«, and save the document in FODS format in the xWalk’s data folder ~/projects/xwalk/data by the name of HGV.fods
  • run conversion script xWalk.sh [modified|new] (new will only processes only TM numbers that are not yet part of idp.data, producing new HGV files; modified won’t produce any new files, only updates already existing HGV files; defaults to both)
    • updates master and xwalk branch of the idp.data repository (git fetch papyri & git merge papyri/master)
    • updates list of all HGV ids currently known to idp.data (java -Xms512m -Xmx1536m net.sf.saxon.Query -q:xql/getHgvId.xql > data/hgvId.xml)
    • updates list of all place ref URIs currently used by HGV (java -Xms512m -Xmx1536m net.sf.saxon.Query -q:xql/getPlaceRef.xql > data/placeRef.xml)
cd ~/projects/xWalk
./xWalk.sh
./xWalk.sh new
./xWalk.sh modified
  • or call xslt script directly to invoke the transformation java -Xms512m -Xmx1536m net.sf.saxon.Transform -l -o:HGV.xml -it:FODS -xsl:xsl/xWalk.xsl HGV=../data/HGV2.fods&FODS_TABLE=HGV2&PROCESS=new which all allows you to modify a set of parameters:
    • PROCESS new|modified|all
    • DATA_DIRECTORY ../data
    • IDP_MASTER ../data/idp.data/papyri/master
    • IDP_XWALK ../data/idp.data/papyri/xWalk
    • FODS_DOCUMENT ../data/HGV.fods
    • FODS_TABLE HGV
    • fileNomeList ../data/idp.data/papyri/master/HGV_metadata/XML_dump/nomeList.xml
    • placeRef ../data/placeRef.xml
    • hgvId ../data/hgvId.xml
  • push new and modified contents of idp.data folder HGV_meta_EpiDoc to github

Summary

assuming xWalk has been installed in a folder called ~/projects/xWalk

    cd ~/projects/xWalk/data/idp.data/papyri/master; git fetch papyri; git merge papyri/master;
    cd ~/projects/xWalk/data/idp.data/papyri/xwalk; git fetch papyri; git merge papyri/master; git push papyri xwalk_papy:xwalk

    [PLACE FODS FILE WITH DATA IN TAB »HGV« IN XWALK’S DATA FOLDER, ~/projects/xWalk/data/HGV.xml]

    cd ~/projects/xwalk/
    ./xWalk.sh new

    cd ~/projects/xWalk/data/idp.data/papyri/xwalk
    git add HGV_meta_EpiDoc
    git commit -m 'HGV xwalk new files (fods)' HGV_meta_EpiDoc

    cd ~/projects/xwalk/
    ./xWalk.sh modified

    cd ~/projects/xWalk/data/idp.data/papyri/xwalk
    git add HGV_meta_EpiDoc
    git commit -m 'HGV xwalk modified files (fods)' HGV_meta_EpiDoc

    git push papyri xwalk_papy:xwalk

Weitere Schritte

  • HGV Aquila MariaDB updaten

wie’s geht steht im HGV-Wiki

  • HGV.Texte statische HTML-Seiten updaten

hilfreiche Infos dazu gibt es im HGV.HGV.Texte-Wiki

Clone this wiki locally