{"id":32591694,"url":"https://github.com/lsst-sqre/www_lsst_io","last_synced_at":"2025-10-30T02:01:39.225Z","repository":{"id":28131575,"uuid":"115058035","full_name":"lsst-sqre/www_lsst_io","owner":"lsst-sqre","description":"www.lsst.io — Rubin observatory documentation portal","archived":false,"fork":false,"pushed_at":"2025-07-29T18:40:29.000Z","size":4829,"stargazers_count":4,"open_issues_count":23,"forks_count":2,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-07-29T21:24:28.648Z","etag":null,"topics":["dochub","lsst-doc-engineering","lsst-projectmeta"],"latest_commit_sha":null,"homepage":"https://www.lsst.io","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/lsst-sqre.png","metadata":{"files":{"readme":"README.rst","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,"zenodo":null}},"created_at":"2017-12-22T00:05:44.000Z","updated_at":"2025-07-29T18:40:33.000Z","dependencies_parsed_at":"2025-07-29T20:24:01.944Z","dependency_job_id":"5fd2276a-af41-46c6-bcdb-7b3d0add861f","html_url":"https://github.com/lsst-sqre/www_lsst_io","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lsst-sqre/www_lsst_io","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lsst-sqre%2Fwww_lsst_io","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lsst-sqre%2Fwww_lsst_io/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lsst-sqre%2Fwww_lsst_io/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lsst-sqre%2Fwww_lsst_io/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lsst-sqre","download_url":"https://codeload.github.com/lsst-sqre/www_lsst_io/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lsst-sqre%2Fwww_lsst_io/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281731420,"owners_count":26551804,"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","status":"online","status_checked_at":"2025-10-30T02:00:06.501Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["dochub","lsst-doc-engineering","lsst-projectmeta"],"created_at":"2025-10-30T02:00:39.320Z","updated_at":"2025-10-30T02:01:39.213Z","avatar_url":"https://github.com/lsst-sqre.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":".. image:: https://github.com/lsst-sqre/www_lsst_io/workflows/CI/badge.svg\n   :target: https://github.com/lsst-sqre/www_lsst_io/actions?query=workflow%3ACI\n\n###########\nwww.lsst.io\n###########\n\nhttps://www.lsst.io is a portal for `Rubin Observatory`_ technical documentation.\nIt's designed to help Rubin Observatory staff and the astronomy community discover documentation, software, and other bits of technical information produced by the Rubin Observatory and LSST.\n\nTechnical stack\n===============\n\n- This site is built with Gatsby_ and React_.\n- The search experience is powered by Algolia_ and react-instantsearch_\n- Styling is done through styled-components_.\n- It's deployed on `LSST the Docs \u003chttps://sqr-006.lsst.io\u003e`__.\n- Searchable content is curated and ingested by Ook_, the Rubin Observatory librarian service.\n  Ook ingests URLs/documents on-demand through a Kafka message queue on Roundtable_.\n\nDevelopment workflow primer\n===========================\n\nNode version\n------------\n\nThe Node.js version used\nThis project is intended to be built with a Node.js version that's encoded in the `.nvmrc \u003c./.nvmrc\u003e`__ file.\nTo adopt this node version, we recommend `installing and using the node version manager \u003chttps://github.com/nvm-sh/nvm\u003e`__.\n\nThen you can use the preferred node version by running ``nvm`` from the project root:\n\n.. code-block:: bash\n\n   nvm use\n\nInstall locally\n---------------\n\nInstall the JavaScript packages:\n\n.. code-block:: bash\n\n   npm install .\n\nStart the development server\n----------------------------\n\n.. code-block:: bash\n\n   gatsby develop\n\nView the site at http://localhost:8000.\n\nAlso view the GraphiQL playground at http://localhost:8000/___graphql to explore the site's data layer.\n\nInstall pre-commit hooks\n------------------------\n\nYou can automatically lint and format code using pre-commit_ hooks.\n\nFirst, install pre-commit in an isolated virtual environment:\n\n.. code-block:: bash\n\n   python3 -m venv .venv\n   source .venv/bin/activate\n   python -m pip install pre-commit\n   pre-commit install\n\nAfter this initialization step, you can re-activate the hooks in the virtual environment:\n\n.. code-block:: bash\n\n   source .venv/bin/activate\n\nManual linting and formatting\n-----------------------------\n\nYou can also manually lint and format code.\n\nLint JavaScript:\n\n.. code-block:: bash\n\n   npm run lint\n\nLint and auto-format JavaScript (powered by Prettier_):\n\n.. code-block:: bash\n\n   npm run lint:fix\n\nFormat other types of code with Prettier_:\n\n.. code-block:: bash\n\n   npm run format\n\nCreate a production build\n-------------------------\n\n.. code-block:: bash\n\n   gatsby build\n\nThis build static HTML and optimized per-route JavaScript code bundles.\n\nYou can serve the production build locally:\n\n.. code-block:: bash\n\n   gatsby serve\n\nProject layout\n==============\n\nHere are the important files and directories:\n\n``licenses/``\n    This directory contains licenses for third-party code that is vendored by this project (such as the license for the Gatsby starter files).\n\n``node_modules/``\n    This directory contains npm packages, as defined by ``package.json`` / ``package-lock.json``.\n    This directory isn't maintained in Git.\n\n``src/``\n    This directory contains all the front-end code for www.lsst.io itself.\n\n``.pre-commit-config.yaml``\n    Pre-commit hooks that ensure code is correctly formatting and doesn't have any linting issues.\n\n``.prettierrc``\n    This file configures Prettier_, which automatically formats the codebase.\n\n``.prettierignore``\n    This file lists files and directories that Prettier_ will not format.\n\n``gatsby-browser.js``\n    This file is where we extend or customize Gatsby's default settings affecting the browser, through the `Gatsby browser APIs \u003chttps://www.gatsbyjs.org/docs/browser-apis/\u003e`__.\n\n``gatsby-config.js``\n    This is the main Gatsby configuration file.\n    See the `Gatsby config docs \u003chttps://www.gatsbyjs.org/docs/gatsby-config/\u003e`__ for details.\n\n``gatsby-node.js``\n    This file is where we customize the build process using `Gatsby Node APIs \u003chttps://www.gatsbyjs.org/docs/node-apis/\u003e`__.\n\n``gatsby-ssr.js``\n    This file is where we customize Gatsby's server-side rendering with the `Gatsby SSR APIs \u003chttps://www.gatsbyjs.org/docs/ssr-apis/\u003e`__.\n\n``LICENSE``\n    This project is licensed under MIT, along with the sub-licenses listed in ``licenses/``.\n\n``package-lock.json``\n    A file is generated based on ``package.json`` and contains the exact version of npm dependencies.\n\n``pacakge.json``\n    This file is the manifest for the Node.js project and contains the project's metadata and abstract dependencies.\n\n.. _Rubin Observatory: https://www.lsst.org\n.. _Gatsby: https://www.gatsbyjs.org\n.. _React: https://reactjs.org\n.. _Algolia: https://www.algolia.com\n.. _react-instantsearch: https://www.algolia.com/doc/guides/building-search-ui/what-is-instantsearch/react/\n.. _styled-components: https://styled-components.com\n.. _Ook: https://github.com/lsst-sqre/ook\n.. _Prettier: https://prettier.io/\n.. _pre-commit: https://pre-commit.com/\n.. _Roundtable: https://roundtable.lsst.io\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flsst-sqre%2Fwww_lsst_io","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flsst-sqre%2Fwww_lsst_io","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flsst-sqre%2Fwww_lsst_io/lists"}