{"id":13852538,"url":"https://github.com/fieldpapers/fieldpapers","last_synced_at":"2025-04-07T09:15:47.718Z","repository":{"id":27698084,"uuid":"31184825","full_name":"fieldpapers/fieldpapers","owner":"fieldpapers","description":"Field Papers umbrella project","archived":false,"fork":false,"pushed_at":"2025-02-13T02:55:34.000Z","size":68,"stargazers_count":89,"open_issues_count":134,"forks_count":12,"subscribers_count":15,"default_branch":"main","last_synced_at":"2025-03-31T08:07:49.946Z","etag":null,"topics":["fieldpapers","openstreetmap"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fieldpapers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-02-22T22:54:34.000Z","updated_at":"2025-03-24T08:10:45.000Z","dependencies_parsed_at":"2022-09-03T03:35:40.725Z","dependency_job_id":"aa56b869-c68f-4152-b102-96a3e764a0fa","html_url":"https://github.com/fieldpapers/fieldpapers","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fieldpapers%2Ffieldpapers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fieldpapers%2Ffieldpapers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fieldpapers%2Ffieldpapers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fieldpapers%2Ffieldpapers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fieldpapers","download_url":"https://codeload.github.com/fieldpapers/fieldpapers/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247622988,"owners_count":20968575,"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":["fieldpapers","openstreetmap"],"created_at":"2024-08-04T22:01:24.974Z","updated_at":"2025-04-07T09:15:47.694Z","avatar_url":"https://github.com/fieldpapers.png","language":null,"funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"This is an umbrella project for collaborating on Field Papers.\n\n## Quick links\n- [🔗 fieldpapers.org](https://fieldpapers.org)\n- [📋 Project overview](https://github.com/fieldpapers)\n- [🐞 Issues and bug reports](https://github.com/fieldpapers/fieldpapers/issues)\n- [🌐 Translations](https://explore.transifex.com/fieldpapers/fieldpapers/)\n- [🤝 Code of Conduct](https://wiki.openstreetmap.org/wiki/Foundation/Local_Chapters/United_States/Code_of_Conduct_Committee/OSM_US_Code_of_Conduct)\n\n## Helping\n\nSo, you want to help with Field Papers. Great!\n\nField Papers is fundamentally about facilitating the production of printed\n(web) maps and providing a means to capture data that has been collected in the\nfield.\n\nIn its current form, this translates to the creation of multi-page PDFs\n(intended for varying paper sizes), ideally at high resolution, using map\nsources and overlays that follow [Slippy\nMap](https://wiki.openstreetmap.org/wiki/Slippy_Map) file naming conventions.\nFurthermore, each page includes a QR code with a link to a page that describes\nthe content of that page (in both human- and computer-readable forms).\n\nThe existence of quick, purpose-built paper maps that can be annotated is often\nsufficient, but FP goes a step further and will take the offline online.\n\nPages may be turned into snapshots by scanning them or taking photos and then\nuploading them. These images will be geo-rectified and turned into a slippy map\nlayer suitable for browsing or as an overlay in a tool like QGIS, iD, or JOSM.\n(They're also available for download as GeoTIFFs.)\n\nThat's basically it. Obviously additional features / tweaks complete the\npicture, which is where you come in.\n\n## Project Breakdown\n\n* The live site: [fieldpapers.org](http://fieldpapers.org/)\n* [The translation project on Transifex](https://www.transifex.com/projects/p/fieldpapers/)\n* [fp-web](https://github.com/fieldpapers/fp-web) - the updated website (Ruby/Rails)\n* [fp-scanner](https://github.com/fieldpapers/fp-scanner) - the updated scanning / rectification tools (EXPERIMENTAL)\n* [fp-printer](https://github.com/fieldpapers/fp-printer) - the updated atlas-creation pipeline (EXPERIMENTAL)\n* [fp-legacy](https://github.com/fieldpapers/fp-legacy) - the existing site, scanning, and atlas creation pipelines\n* [fieldpapers](https://github.com/fieldpapers/fieldpapers) - the umbrella project, for tracking issues, etc.\n* [fp-tiler](https://github.com/fieldpapers/fp-tiler) - the tile server.\n* [tilelive-fieldpapers](https://github.com/fieldpapers/tilelive-fieldpapers) - the tilelive module that drives the tile server.\n* [fp-tasks](https://github.com/fieldpapers/fp-tasks) - the task server, which provides a web API on top of the printing and snapshot processing components of fp-legacy.\n\n## For Multi-lingual Individuals\n\nField Papers is often used on the ground in disaster-stricken areas and the\ndeveloping world, and not everyone speaks English. Field Papers is intended to\nbe translated, so please help! We have a [Field Papers project on\nTransifex](https://www.transifex.com/projects/p/fieldpapers/) that you can\ncontribute to. Even partial translations are better than none, so let's get\nstarted!\n\nField Papers uses [Devise](https://github.com/plataformatec/devise) for\nmanaging users. As a result, we can share translations with other projects.\nTranslations are managed using [Locale](https://www.localeapp.com/):\n[devise-i18n](https://www.localeapp.com/projects/377)\n([GH](https://github.com/tigrish/devise-i18n)),\n[devise-i18n-views](https://www.localeapp.com/projects/2263)\n([GH](https://github.com/mcasimir/devise-i18n-views)).\n\nIf you encounter strings on the site that don't appear to have corresponding\nentries in Transifex or Locale, please [open an\nissue](https://github.com/fieldpapers/fieldpapers/issues/new) so we can track\nthem down.\n\n## For Web Developers\n\nThe Field Papers web site is a standard Rails application, chosen to minimize\nthe amount of effort required to implement standard features (Rails has\na fantastic ecosystem of plugins for concerns ranging from pagination to user\naccount management). The front-end is similarly intended to be simple, with the\nmajority of effort spent on configuring and extended\n[Leaflet](https://leafletjs.com/) for our purposes.\n\nHave a look at the [issue list](https://github.com/fieldpapers/fieldpapers/issues)\nand see if there are things that appeal or seem doable. If there's insufficient\ninformation, ask for more!\n\n## For Designers\n\nField Papers' current design represents its minimalist past. While we intend to\nkeep it simple (especially for users on low-bandwidth connections), that\ndoesn't mean we can't add a bit of flair. The same goes for the design of the\nprinted atlases--they originally used Python (and Cairo) to produce PDFs, but\nare now using HTML, which expands our options.\n\n## For Computer Vision Enthusiasts\n\nThe [scanner component](https://github.com/fieldpapers/fp-scanner) uses OpenCV\nto extract and geo-reference maps from images. There's surely more we can do to\ndigitize field annotations!\n\n## For Ops People\n\nWe haven't tackled instrumentation and monitoring yet and we're not totally\nclear on how we're going to deploy (Heroku is a reasonable default, and we're\naiming to provide `Dockerfile`s for each component). Weigh in with your\nexpertise and help us figure out the best approach.\n\nField Papers isn't just fieldpapers.org, as some organizations have configured\nit in \"appliance-mode\" before deploying it into the field. Let's do what we can\nto keep this process smooth.\n\n## For Everyone Else\n\nIf you're using Field Papers, we care about how you're using it. If you're\nfinding bugs, [let us\nknow](https://github.com/fieldpapers/fieldpapers/issues/new) and help us fix\nthem. If you have ideas about features that would make your life easier, write\nthem up as proposals (explaining _how_ they would be useful, particularly in\nthe field, is very helpful) and add them either as GitHub issues or on the wiki\n(we're still figuring this out) and see what you can do to drum up feedback and\nsupport.\n\nDocumentation in its many forms is also immensely welcomed, whether it's how to\nuse Field Papers with QGIS or collections of good ways to use it in your local\ncommunity.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffieldpapers%2Ffieldpapers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffieldpapers%2Ffieldpapers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffieldpapers%2Ffieldpapers/lists"}