Skip to content

angulardart-community/website

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

The next AngularDart documentation site.

This will be the next-generation documentation for AngularDart, built with Hugo and a modified version of the Doks theme. Compared to the old site, it's much easier and quicker to build and iterate new content.

It's still very much WIP in the current state, namely to migrate all the Jekyll templates to Hugo shortcodes. Follow #9 for this progress. A better README will be provided later.

Build the site

Here are simple instructions if you want to hack on it now:

  1. Install Dart and NodeJS (>= 16.16.0, though an older version may also work, just remove the restriction in package.json).
  2. (Optional) Run npm install. This is technically only needed if you don't have Hugo installed on your system or if you want to build the site locally using Hugo for testing.
  3. Run dart pub get and dart run build_runner build -o data/fragments to generate code excerpts.
  4. If you have Hugo installed on your system, you may run hugo server directly. If not, do step 2 and run npm run server.
  5. Open http://localhost:1313 (or the addresss Hugo shows you if you specified a custom address/port).
  6. If you want to build the site, perform step 2 and run npm run build:preview. DON'T run npm run build or hugo build. The site's baseurl won't be setup correctly. These options are for release builds. The result website will rest inside the public/ folder. Use your favorite http server to serve it (e.g. dhttpd --path public).

If you're familiar with the old site, you might be surprised that no git submodules are required. Yes indeed, we're using git subtree! You may want to check out if subtree suits your purposes if you're also annoyed by / struggling with submodules.

Made possible by

Thank you so much to all of the maintainers and contributors of these projects!

About

The next-generation AngularDart documentation website.

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published