Tutorial for DataHub Pages v0.1

Tutorial for DataHub Pages v0.1

We want a a tutorial for v0.0.1.

Acceptance

Tutorial on "Simple Publishing of your Data / Data-Driven Document/Analysis" https://pages.datahub.io/blog/generate-an-interactive-webpage-from-csv-data-and-markdown DONE

NB: just single README + CSV

  • Title e.g. "Create your own DataHub Pages application"
  • Install your content/data
  • Test locally
  • Deployment the app (just give instructions to e.g. github, vercel, cloudflare, netlify)
  • Profit!
  • BTW: here's a script that does this all for you in a branch of your repo …

Demo repo with README + data

Questions: what happens if i want build this into my own data repo (i don't want to have 2 separate repos - my data and my data presentation)

marketing

#todo

  • What initial marketing do we do of v0.0.1?
    • dev.to article?
    • post on frictionless channels on discord

Tasks

  • First draft of the tutorial
  • Develop demonstration repo
    • Automate in github actions doing the whole set of steps
  • Technical fixes:
    • datahub-portal-local-cli.js copies all *.csv it finds into the public directory (currently hardcoded to just data.csv)

Analysis

Notes (Rufus & Leo)

https://excalidraw.com/#room=58cad8f74b6f1be3ea2f,p5RM_ybIKDOP6L832JrTfw

Brainstorm

Draft

https://github.com/datopian/next.datahub.io/blob/main/docs/projects/v0.1.0-readme-with-csv-table-preview.md#steps-for-a-user

Plus we have: https://github.com/datopian/portal.js/blob/main/examples/data-literate/README.md


# get the template
npx create-next-app@latest --example https://github.com/datopian/portal.js/examples/data-literate my-app

cd my-app

# run the script to connect your content
# put the path to your project directory
node datahub-portal-local-cli.js your-project-directory

# start the preview portal
npm run dev

# open a browser
open localhost:3000
As a proper tutorial (#someday)
  • Create a new project :
    • Copy and paste this example markdown/folder
    • All you need to start is a single markdown file
        1. Create a README.md in your folder
  • Run the portal command: datahub portal
  • Open your browser to localhost:3000

© 2024 All rights reservedBuilt with DataHub Cloud

Built with DataHub CloudDataHub Cloud