{"id":38544506,"url":"https://github.com/impresso/impresso-datalab","last_synced_at":"2026-01-17T07:16:58.685Z","repository":{"id":225320723,"uuid":"761699061","full_name":"impresso/impresso-datalab","owner":"impresso","description":"Impresso Datalab static Astro website","archived":false,"fork":false,"pushed_at":"2025-12-19T10:34:27.000Z","size":5162,"stargazers_count":2,"open_issues_count":20,"forks_count":0,"subscribers_count":6,"default_branch":"develop","last_synced_at":"2025-12-20T23:09:10.332Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://impresso-project.ch/datalab","language":"MDX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/impresso.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-02-22T10:19:55.000Z","updated_at":"2025-12-19T10:34:30.000Z","dependencies_parsed_at":"2024-05-22T15:34:33.240Z","dependency_job_id":"fcb51c60-a19a-4817-b4a6-6594f7d38b16","html_url":"https://github.com/impresso/impresso-datalab","commit_stats":null,"previous_names":["impresso/impresso-datalab"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/impresso/impresso-datalab","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/impresso%2Fimpresso-datalab","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/impresso%2Fimpresso-datalab/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/impresso%2Fimpresso-datalab/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/impresso%2Fimpresso-datalab/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/impresso","download_url":"https://codeload.github.com/impresso/impresso-datalab/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/impresso%2Fimpresso-datalab/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28503366,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T06:57:29.758Z","status":"ssl_error","status_checked_at":"2026-01-17T06:56:03.931Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-01-17T07:16:58.573Z","updated_at":"2026-01-17T07:16:58.648Z","avatar_url":"https://github.com/impresso.png","language":"MDX","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Impresso Datalab\n\nWelcome to the Impresso Datalab repository!\nImpresso Datalab is designed to highlight the research and analysis conducted within the Impresso project. It serves as a platform to display interactive Jupyter notebooks, allowing visitors to explore our methodologies, data, and findings through ipynb notebooks.\n\n## Features\n\nThe Impresso Datalab offers several features, including the ability to showcase individual Jupyter notebooks and display series of related notebooks. It also provides automatic synchronization with notebooks hosted on GitHub, ensuring that the latest versions are always available. Additionally, the platform includes detailed contributor information and attribution, recognizing the efforts of all team members involved.\nHappy researching and sharing with Impresso Datalab!\n\n## Contributing\n\nWe welcome contributions from team members! To add your notebook to the Impresso Datalab, follow these steps:\n\n1. Get the public url of the ipynb file you want to reference\n2. Create a MDX file in `src/content/notebooks/` and fill only its [frontmatter](https://mdxjs.com/guides/frontmatter/): the content of the notebook will be automatically fetched right after your commit. Its filename should be the slugified version of the title you wish to give to the notebook.\n3. Create or update notebook creators or collaborators information in `src/content/authors/`. Its filename will be the local identifier of the person mentioned.\n\nIn the frontmatter of your MDX file, please include the following key information:\n\n- `title`: The title of your notebook.\n- `githubUrl`: The URL pointing to your notebook's repository on GitHub.\n- `excerpt`: An optional text providing a brief excerpt or summary of the notebook.\n- `authors`: An array of contributor slugs.\n\nOptionally, you can include the following additional information:\n\n- `googleColabUrl`: An optional string representing the Google Colab URL of the notebook.\n- `tags`: An optional array of strings representing tags associated with the notebook.\n- `seealso`: An optional array of strings representing related notebooks (use the notebook filename without the suffix).\n\nExample frontmatter for a notebook MDX file:\n\n```yaml\n---\ntitle: The title of your notebook\ngithubUrl: https://github.com/your-username/your-repo/blob/main/notebooks/your-notebook.ipynb\nexcerpt: This notebook explores the impact of something on something else.\nauthors:\n  - john-doe\n  - tizio-caio\n---\n```\n\nAs soon as you push your changes to the repository, the Impresso Datalab will automatically update the notebooks list (or display errors if the frontmatter is not correctly formatted or the referenced notebook is not found) and update the notebook frontmatter with the latest information of the latest commit on the remote github repository.\n\n## Creating series of notebooks\n\nTo create a series of related notebooks just create an MDX file in `src/content/series/`.\nIn the frontmatter of your series MDX file, include the following information:\n\n- `title`: The title of your notebook series\n- `excerpt`: A brief description of the series\n- `notebooks`: An array of notebook slugs that belong to this series\n\nFeel free to add images or other content to the body of the MDX file to provide additional context or information about the series.\n\n## Development\n\nThe Impresso Datalab is built using AstroJS and MDX. The Impresso Datalab is connected to the Impresso API and the Impresso WebSocket API and locally you have to provide the full URL to the API and WebSocket API.\n\n```bash\nnpm install\n\nPUBLIC_IMPRESSO_API_HOST=http://ws.localhost \\\nPUBLIC_IMPRESSO_API_PATH=/public-api/v1 \\\nPUBLIC_IMPRESSO_WS_API_HOST=http://api.localhost \\\nPUBLIC_IMPRESSO_WS_API_PATH=/api/socket.io \\\nnpm run dev\n```\n\nTo force the download of recent notebooks, you can run the following command:\n\n```bash\nnpm run updatenotebooks\n```\n\n## Support\n\nIf you encounter any issues or have questions about contributing, please open an issue in this repository.\n\n# Project\n\nThe 'Impresso - Media Monitoring of the Past' project is funded by the Swiss National Science Foundation (SNSF) under grant number [CRSII5_173719](http://p3.snf.ch/project-173719) (Sinergia program). The project aims at developing tools to process and explore large-scale collections of historical newspapers, and at studying the impact of this new tooling on historical research practices. More information at https://impresso-project.ch.\n\n## License\n\nCopyright (C) 2024 The Impresso team. Contributors to this program include: [Daniele Guido](https://github.com/danieleguido), [Kirill Mitsurov](https://github.com/donsiamese) and [Roman Kalyakin](https://github.com/theorm).\nThis program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.\nThis program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. See the [GNU Affero General Public License](https://github.com/impresso/impresso-datalab/blob/master/LICENSE) for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimpresso%2Fimpresso-datalab","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimpresso%2Fimpresso-datalab","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimpresso%2Fimpresso-datalab/lists"}