The official repo has been archived and doesn't allow any changes, hence I created this fork so that we, the AngularDart community, can work on improvements by ourselves (and perhaps have our own documentation site?).
Feel free to create & submit ANY issues and pull requests! Nothing is too small to fix, even just a typo :)
A more modern and up-to-date new website is on its way!
The AngularDart community-maintained documentation site, built with Jekyll and hosted on Firebase Hosting.
We welcome contributions, and we're first-timer friendly!
Our main focus now is to keep the version of the website up-to-date with the latest version of AngularDart, but as stated above, feel free to submit anything. See the migration guide for more info!
For simple changes (such as to CSS and text), you probably don't need to build this site. Often you can make changes using the GitHub UI.
If your change involves code samples, adds/removes pages, or affects navigation, you'll need to build and test your work before submitting. If you want or need to build the site, follow the steps below.
Windows users might find themselves having trouble building this site because they can't run We have migrated (most) workflows to Dart and Docker, so Windows users should be able to build the site now. But seriously, considering switching to Linux?.sh files. We're currently migrating the workflows from using gulpjs to Dart's grinder, which will do everything in Dart and resolve this problem. Sorry Windows users! (and how about considering using linux in the meantime?)
Also, if you do a full-site build, it takes up about 2~3GB of space. Hard Drive Lives Matter!
Install the following tools if you don't have them already.
- Docker. We use Docker for local development and building the site. Install it from https://docs.docker.com/get-docker/.
- GNU Make. On Windows the easiest way to install Make is
choco install makeusing command prompt or powershell as an admin. Other options include using a [subsystem][wsl].
NOTE: This repo has a git submodule, which affects how you clone it.
To clone this repo (site-angulardart), follow the instructions given in the GitHub help on Cloning a repository, and choose one of the following submodule-cloning techniques:
- Clone this repo and its submodule at the same, use the
--recurse-submodulesoption:
git clone --recurse-submodules https://github.com/angulardart-community/site-angulardart.git - If you've already cloned this repo without its submodule, then run
this command from the repo root:
git submodule update --init --remote
IMPORTANT: Whenever you update your repo, update the submodule as well:
git pull; git submodule update --init --remote
Some common problems that might occur during this process (Linux/Mac only; for Windows please open an issue):
-
dart pub getgetting stuck for hours, usually ondart_style.Solution: before running all the steps above, run the following in the project root:
pub global activate webdev pub global activate dartdoc pub get
-
(Optional) Build the container image from scratch. If you don't have the hard drive space to do so or you just want to quickly see how it looks, you can skip this step and use the image we provide on GitHub. However, if you're changing dependencies, you must run this step to update the dependencies in the image.
make setup
-
Serve the site locally (via
docker compose).make up
-
View your changes in the browser by navigating to
http://localhost:5000.Note: Unless you're editing files under
site-shared, you can safely ignoreERROR: directory is already being watchedmessages. For details, see #1363. -
Make your changes to the local repo.
The site will rebuild and the browser will autoreload to reflect the changes.
Tip: If you aren't seeing the changes you expect (e.g. src/_data),
ctrl-Cout of your running dev server and rebuild the site from scratch using the following commands:$ make down && make clean && make up
-
When you've finished developing, shut down the Docker container:
$ make down
For more advance usage, see below
NOTE: Getting
jekyll | Error: Too many open filesunder MacOS or Linux? One way to resolve this is to add the following to your.bashrc:ulimit -n 8192and then reboot your machine.
To see the full list of workflow commands available, run grind --help. Below are a few handy ones that you'll likely use to make your life easier. (More coming soon!)
grind clean # Clean build artifacts
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent