The goal of this site is twofold:
- To remain a timely, vibrant, and community-driven reference with a relatively low barrier to contribution.
Much of the initial content - and spirit - comes from jQuery Fundamentals, an open-source book about jQuery, originally written by Rebecca Murphey and released in 2010. In 2011, Rebecca bequeathed the book unto the jQuery Foundation to serve as the basis for this site.
This site's core content consists of Markdown files. The template that controls the site's appearance is a child theme of jquery-wp-content, and any issues with the presentation should be directed to that repository.
All of the content lives inside of the subdirectories of the
page directory. Each of these subdirectories is considered a chapter, and contains one or more articles, and there is also a top level file that corresponds to each chapter, which contains the chapter's human-readable title and an overview, which will appear on the chapter's landing page.
order.yml file controls the order that chapters and articles appear in the site.
Each of the articles on the site has some YAML "Front Matter" that contains metadata. All articles should include the following:
title- The title of the article as it will appear in the site. If it contains special characters, put the string in quotes.
title: "jQuery Event Extensions"
level- The approximate level of jQuery experience required to find the article useful. Options:
As this site is part of the jQuery network of sites, its presentation is controlled by jquery-wp-content. To preview the site locally, first follow the instructions there to set up a local version of the jQuery WordPress network. Then, clone this repo and run the following steps (node.js required).
cp config-sample.json config.json
- Edit config.json to use the username and password for your local WordPress network
We encourage contribution from anyone. For more comprehensive documentation on how to get involved, please read our contributing guide.