For example, if I want to collaborate on making a (non-computer related) textbook with someone, and we want to use git as a version control system. Should we use github/codeberg for this or is there a platform that’s more suitable for using git in nontechnical contexts?

  • Otter@lemmy.ca
    link
    fedilink
    arrow-up
    11
    ·
    22 hours ago

    If it helps, a number of courses at my university used open source git based textbooks. For example, you can replicate this Statistics textbook using any static site generator designed for documentation: https://moderndive.com/ (https://github.com/moderndive/ModernDive_book/)

    We use vitepress for our docs: https://fedecan.ca/en/guide/get-started

    Or you can get even simpler by using plain markdown files organized into folders.

    In my opinion, it’s better to start off simple while writing the content since then you can pick a tool based on what type of formatting you end up needing

    • a_gee_dizzle@lemmy.caOP
      link
      fedilink
      arrow-up
      5
      ·
      22 hours ago

      Thanks for the info.

      In my opinion, it’s better to start off simple while writing the content since then you can pick a tool based on what type of formatting you end up needing

      Yeah I guess there should be rudimentary markdown to LaTeX translation programs, right?

      • Meron35@lemmy.world
        link
        fedilink
        arrow-up
        3
        ·
        14 hours ago

        pandoc. Converts markdown to html, latex, pdf, and Word.

        It serves as the backend behind basically every program that support some kind of rendering of markdown, e.g. quarto, ipython notebooks.

        Pandoc - Pandoc User’s Guide - https://pandoc.org/MANUAL.html

      • Otter@lemmy.ca
        link
        fedilink
        arrow-up
        6
        ·
        22 hours ago

        Yeah I guess there should be rudimentary markdown to LaTeX translation programs, right?

        I haven’t tried any, but I would think so yes. You can probably run a script over the files to accomplish the same thing :)