Skip to content

Reorganize project directory structure #9

@neuromechanist

Description

@neuromechanist

Context

All content files (.qmd, slides, data, CSS) sit flat at the repository root. This makes the project hard to navigate and maintain as it grows. We need a clear folder structure.

Current layout (flat)

_quarto.yml
index.qmd
news.qmd
team.qmd
datasets.qmd
styles.css
requirements.txt
files/slides_kickoff.pdf
files/slides_ab_meeting_12_24.pdf
files/EEGManySteps _ AB meeting survey.tsv
news_files/...
news.ipynb

Proposed layout

_quarto.yml
styles.css
pages/
  index.qmd
  news.qmd
  team.qmd
  datasets.qmd
assets/
  slides/
    slides_kickoff.pdf
    slides_ab_meeting_12_24.pdf
  data/
    ab_meeting_survey.tsv
  posters/          (see #10)
  images/           (logo, diagrams, etc.)

Tasks

  • Create pages/ directory and move .qmd files there (or keep at root if Quarto routing is simpler)
  • Create assets/slides/ and move slide PDFs there
  • Create assets/data/ and move .tsv data files there
  • Create assets/images/ for project images/logos
  • Update all internal links in .qmd files to reflect new paths
  • Update _quarto.yml navbar hrefs if pages move
  • Rename the survey file to remove spaces (ab_meeting_survey.tsv)

Notes

Quarto handles nested directories well, but the navbar href paths in _quarto.yml need to match. Test locally with quarto preview before committing.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions