/liputenpo.org

https://liputenpo.org using https://www.11ty.dev/

Primary LanguageHTML

lipu tenpo website (PROOF OF CONCEPT)

Rewrite of https://liputenpo.org using https://www.11ty.dev/

See live on https://liputenpo.alifeee.co.uk/

Under construction

How-to

The following should be done on a branch of the main repository. When ready, it can be merged into the staging repository, to see what it looks like online, and test links and images.

Only THEN should it be pushed to main of the main repository.

Add a new lipu

  1. Add the new PDFs to the ./pdfs folder.

  2. Edit _data/lipu_ale.yaml and add the new article. For example,

    - id: 23
      title: nanpa sewi
      date: 2023-12-25
      pdf: 0023sewi.pdf
      pdf_pf: 0023sewi_pf.pdf
      pdf_bwpf: 0023sewi_bwpf.pdf
      cover_image: 0023sewi_sinpin.png
  3. Wait for site to build - see status on the actions tab

  4. Merge into main branch of staging site

  5. Check links and images

  6. Merge into main branch of main site

  7. create an empty nanpa-<nimi> directory with an 11tydata file inside ./toki/ (copy from an existing folder and change as necessary)

Add a new toki

  1. Create a new markdown file in the sub-folder of the issue the toki is from in ./toki

  2. Create the frontmatter for the file with the TITLE, AUTHOR(S), DATE, and TAGS (article type), for example

    ---
    nimi-suli: nasin tawa Intawe
    jan-pali: jan Alipi
    tags:
      - sona
    ---
  3. Upload any images to ./toki/images/ prepended by the issue number and name

  4. Paste the content into the article

    • Lines must end with double-space " "or there should be a two-linebreak gap between paragraphs (as standard in markdown)

    • Use the image shortcode for images, e.g., {{{sitelen "0023sewi_nasin-tawa-intawe.png" "nasin tawa Intawe"}}}

    • Use the non-pu shortcode for non-pu words, e.g., {{{pu "kipisi"}}}

      (Shortcodes are defined in ./.eleventy.js)

  5. Wait for site to build - see status on the actions tab

  6. Merge into main branch of staging site

  7. Check links and images

  8. Merge into main branch of main site

Edit jan pali

Edit ./_data/jan_pali.yaml

Edit other data on the site

It's probably in a file in ./_data.

Export articles as plaintext

You can either check out the repository and run the export scripts yourself, or:

  • Go to the Actions tab > toki plaintext

  • Click Run workflow and target the branch you want to target

    Run workflow button

  • Wait, and refresh the page. Click the new in-progress workflow

  • When workflow completes, a .zip containing all the plaintext should be in the summary section

    screenshot of workflow artifact

  • Download this, and unzip it. These are the plaintext of the files in ./toki/

Development Commands

Install

npm install

Develop

npm run develop

Build

npm run build