Skip to content

UnitoAssyrianGovernance/kart4arch

Repository files navigation

Kart Tutorial

DOI Website - unitoassyriangovernance.github.io/kart4arch/

This is a tutorial to drive step by step any practitioner interested in learning how to use Kart, and is a companion to the publication: A. Titolo, A. Palmisano, "Using Kart and GitHub for versioning and collaborating with spatial data in archaeological research", submitted to Archeologia e Calcolatori journal and part of the proceedings of the ArcheoFOSS 17 conference.

The tutorial can be followed on the online website at https://unitoassyriangovernance.github.io/kart4arch/, but other options are available below.

This resource is also archived on Zenodo at: https://zenodo.org/doi/10.5281/zenodo.10962392

Follow the tutorial locally

Easiest solution

Download the index.html file located here and open it with any browser.

Additional formats

Navigate to the _manuscript folder, and open one of the html, pdf, or docx file.

Build the entire website from scratch

This website is built with Quarto using Quarto manuscript project type, and hosted on Github Pages. To reproduce and build the website locally, Quarto must be installed on your machine (following the available options on the quarto website).

Step by step guide:

  • Open the main file kart_tutorial.qmd in your editor of choice (Quarto has first-class support for RStudio, VSCode/VSCodium, Jupyter Lab, Neovim)
  • Render the Quarto manuscript (this will vary depending on your editor)
  • A new folder _manuscript will be created with all the available formats (html, docx, pdf, and meca bundle)