{"id":19632905,"url":"https://github.com/foundation/foundation-docs","last_synced_at":"2025-04-28T07:30:40.863Z","repository":{"id":42077296,"uuid":"47996333","full_name":"foundation/foundation-docs","owner":"foundation","description":"Common templates and utilities for the Foundation family documentation.","archived":false,"fork":false,"pushed_at":"2024-09-26T21:13:11.000Z","size":3477,"stargazers_count":30,"open_issues_count":15,"forks_count":24,"subscribers_count":30,"default_branch":"master","last_synced_at":"2025-04-05T07:32:59.823Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/foundation.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-12-14T19:24:47.000Z","updated_at":"2025-02-07T11:36:10.000Z","dependencies_parsed_at":"2024-08-10T09:51:14.989Z","dependency_job_id":null,"html_url":"https://github.com/foundation/foundation-docs","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foundation%2Ffoundation-docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foundation%2Ffoundation-docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foundation%2Ffoundation-docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foundation%2Ffoundation-docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/foundation","download_url":"https://codeload.github.com/foundation/foundation-docs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251271082,"owners_count":21562487,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-11T12:15:43.476Z","updated_at":"2025-04-28T07:30:40.276Z","avatar_url":"https://github.com/foundation.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Foundation Docs\n\n[![Build Status](https://travis-ci.org/foundation/foundation-docs.svg?branch=master)](https://travis-ci.org/foundation/foundation-docs)\n\nThis is a set of HTML templates and JavaScript utilities shared by the documentation pages for the [Foundation](https://get.foundation) family of frameworks, including:\n\n- [Foundation for Sites](https://get.foundation/sites)\n- [Foundation for Emails](https://get.foundation/emails)\n\n## Table of Contents\n\n- [Installation](#installation)\n- [JavaScript Usage](#javascript-usage)\n- [Sass Usage](#sass-usage)\n- [Testing](#testing)\n\n## Installation\n\nThis codebase isn't on npm, but this Git repository can be referenced in a `package.json`:\n\n```bash\n{\n  \"dependencies\": {\n    \"foundation-docs\": \"foundation/foundation-docs\"\n  }\n}\n```\n\n## JavaScript Usage\n\nWhen you `require()` the `foundation-docs` library, you get access to a handful of JavaScript libraries, as well as file paths to HTML templates.\n\n### foundationDocs.handlebars\n\nAn instance of a custom Handlebars renderer with all the helpful functions we need to generate documentation.\n\n### foundationDocs.marked\n\nAn instance of a custom Marked renderer, which has two custom functions:\n- When headings are written, an anchor icon is added to the left of the heading text.\n- When code samples are written:\n  - If the language is `html_example`, a live rendering of the HTML in the sample is added.\n  - If the language is `inky_example`, a live rendering of the HTML in the sample\u0026mdash;within an iframe that loads the Ink CSS\u0026mdash;is added.\n\n### foundationDocs.componentTemplate\n\nA String path to the HTML template used for component pages. The general structure is:\n\n- Title area\n- Main docs (converted Markdown)\n- Sass reference\n- JavaScript reference\n- Table of contents\n\nThe path is `node_modules/foundation-docs/templates/component.html`.\n\n## Sass Usage\n\nThe CSS used for the Foundation documentation is included as a series of Sass partials. Foundation and Motion UI must be loaded manually before it.\n\n```scss\n@import 'foundation';\n@import 'motion-ui';\n\n@include foundation-everything;\n@include motion-ui-transitions;\n\n@import 'foundation-docs';\n```\n\n## Testing\n\nThere are two kinds of tests in the repository:\n\n- **Unit tests**, which are run with Mocha.\n- **Visual tests**, which are full HTML templates with all of the documentation UI elements.\n\nRun `npm test` to run the test suite, as well as a BrowserSync server pointing to the visual tests. You can make changes to the HTML, Sass, or JavaScript of the library and see the changes refresh live. Use this test environment to make changes to the documentation template.\n\n### Testing with Foundation\n\nTo test with an actual framework's documentation, you can hook the two folders together using `npm link`.\n\nLet's assume you have `foundation-sites` and `foundation-docs` in the same folder:\n\n```\n- sites/\n  - foundation-sites/\n  - foundation-docs/\n```\n\nWhile inside of the `foundation-sites/` folder, run `npm link ../foundation-docs`. Now Foundation's documentation will reference the changes you're making.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoundation%2Ffoundation-docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffoundation%2Ffoundation-docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoundation%2Ffoundation-docs/lists"}