{"id":15655223,"url":"https://github.com/edsu/fondz","last_synced_at":"2025-05-02T16:15:39.265Z","repository":{"id":12399531,"uuid":"15052595","full_name":"edsu/fondz","owner":"edsu","description":"fondz is a tool for auto-generating an \"archival description\" from a bag or series of bags. ","archived":false,"fork":false,"pushed_at":"2014-06-30T15:50:12.000Z","size":8194,"stargazers_count":26,"open_issues_count":19,"forks_count":3,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-05-01T15:06:22.999Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/edsu.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}},"created_at":"2013-12-09T16:30:05.000Z","updated_at":"2024-10-11T19:48:40.000Z","dependencies_parsed_at":"2022-08-26T16:11:00.797Z","dependency_job_id":null,"html_url":"https://github.com/edsu/fondz","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/edsu%2Ffondz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edsu%2Ffondz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edsu%2Ffondz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edsu%2Ffondz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/edsu","download_url":"https://codeload.github.com/edsu/fondz/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251895480,"owners_count":21661345,"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-10-03T12:57:10.310Z","updated_at":"2025-05-01T15:06:30.246Z","avatar_url":"https://github.com/edsu.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"fondz \n-----\n\n*WORK IN PROGRESS WARNING*\n\n[![travis-ci status](https://travis-ci.org/edsu/fondz.png)](http://travis-ci.org/edsu/fondz)\n\nfondz is a command line tool for auto-generating an \"archival description\" for a set of born digital content found in a [bag](http://en.wikipedia.org/wiki/BagIt) or series of bags. The name fondz was borrowed from a [humorous](http://curatememe.tumblr.com/post/28097866834/respect-de-fondz-taking-into-consideration-the) take on the archival principle of [provenance](http://www2.archivists.org/glossary/terms/p/provenance) or respect des fonds. fondz works best if you point it at a collection of content that has some thematic unity, such as a collection associated with an individual, family or organization.\n\nThe description that fondz generates is expressed as HTML, suitable for \nviewing in both online and offline mode without the need for running software\nother than your Web browser. The HTML also contains structured metadata, so \nthat it can be easily processed by other applications. fondz is largely an\nintegration layer for other tools such as:\n\n* [libreoffice](http://www.libreoffice.org/) - for converting various document formats to html\n* [mallet](http://mallet.cs.umass.edu/) - for creating topic models of textual content\n* [fido](https://github.com/openplanets/fido) - for identifying file formats using the [Pronom](http://www.nationalarchives.gov.uk/PRONOM/Default.aspx) registry.\n* [exiftool](http://www.sno.phy.queensu.ca/~phil/exiftool/) - for extracting image metadata\n\nAs better opensource tools for converting documents and summarizing their \ncontents become available they can be swapped out for the ones that are being \nused now.\n\nThanks go to Twitter and Facebook for their HTML based archive packages, and\nto [Jekyll](http://jekyllrb.com/) and other static site generators, which \nwere an inspiration for fondz.\n\nExample\n-------\n\nHere's an example for generating a finding aid for two bags, the first bag \nwhich contains a Word document `abc.doc`, and the second which contains a \nWordPerfect document `def.wpd`.\n\n    % fondz create \"Collection Name\" example /path/to/a/bag /path/to/another/bag\n    % tree example/\n    example/\n    ├── css\n    │   └── style.css\n    ├── derivatives\n    │   ├── 1\n    │   │   └── abc.doc.html\n    │   └── 2\n    │       └── def.wpd.html\n    ├── index.html\n    ├── js\n    │   │── topics.json\n    │   └── formats.json\n    └── originals\n        ├── 1 -\u003e /path/to/a/bag\n        └── 2 -\u003e /path/to/another/bag\n\nOnce fondz has run you should be able to open `index.html` in your \nbrowser and browse the content.\n\nInstall\n-------\n\nOn Ubuntu you should be able to install fondz by running: \n\n    sudo scripts/install\n\nIf you are on OSX or Windows you should be able to read the install script and\nfigure out what you need to install and put in your PATH.\n\nIdeas\n-----\n\nIf you've got ideas for things fondz could do, please submit them as\nan enhancement issue at [GitHub](https://github.com/edsu/fondz/issues/new).\n\nThese are ideas that seem theoretically doable. If you have similar\nideas to add, please send me a pull request for your changes to the README.md, \nor open an issue here on Github.\n\nNotes\n-----\n\nIf you are on OSX and want to convince fondz to use your OpenOffice install put\na script like this named `libreoffice` in your PATH:\n\n    #!/bin/sh\n\n    cd /Applications/LibreOffice.app/Contents/MacOS/\n    ./soffice $@\n\nLicense\n-------\n\n* CC0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedsu%2Ffondz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fedsu%2Ffondz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedsu%2Ffondz/lists"}