Skip to content

USWDS-Tutorial - Feature: Switch to a Node static site generator #12

@scottkellum

Description

@scottkellum

Is your feature request related to a problem? Please describe.

Currently I ran into two issues getting started:

1: A permissions error with bundle install. Easy enough, I found the thing that failed and added sudo in front of it.
2: I ran into a Ruby interpreter bug:

/Library/Ruby/Gems/2.6.0/gems/ffi-1.15.5/lib/ffi/library.rb:275: [BUG] Bus Error at 0x0000000100c00000
ruby 2.6.8p205 (2021-07-07 revision 67951) [universal.arm64e-darwin21]

The Ruby ecosystem in general seems to be on the decline and it’s becoming more and more difficult to work with. This tutorial is the first place people will look for help spinning up a USWDS website. To be confronted with the struggle of getting Ruby dependencies working nicely from the start might be more of a struggle than some folks will want to deal with.

Describe the solution you'd like

Replace Jekyll with a Node based static site generator like Astro or 11ty

Astro gets my vote for easy (no) config and modern JS framework compatibility

Describe alternatives you've considered

No response

Additional context

No response

Code of Conduct

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    Status

    Done

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions