{"id":16482811,"url":"https://github.com/shaps80/appledoc","last_synced_at":"2025-06-12T07:09:00.501Z","repository":{"id":69909682,"uuid":"9970126","full_name":"shaps80/appledoc","owner":"shaps80","description":"A handy script for managing appledoc installation and generation.","archived":false,"fork":false,"pushed_at":"2013-05-09T23:13:12.000Z","size":216,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-28T22:41:39.097Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/shaps80.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-05-09T22:49:14.000Z","updated_at":"2013-11-07T18:38:42.000Z","dependencies_parsed_at":"2023-02-21T06:55:28.636Z","dependency_job_id":null,"html_url":"https://github.com/shaps80/appledoc","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/shaps80/appledoc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shaps80%2Fappledoc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shaps80%2Fappledoc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shaps80%2Fappledoc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shaps80%2Fappledoc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shaps80","download_url":"https://codeload.github.com/shaps80/appledoc/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shaps80%2Fappledoc/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259418186,"owners_count":22854184,"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-11T13:12:06.294Z","updated_at":"2025-06-12T07:09:00.482Z","avatar_url":"https://github.com/shaps80.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"appledoc\n========\n\nI use appledoc a lot for generating my documentation but one thing that's annoyed me for a while is the installation and usage of this great utility from the command line.\n\nI sometimes have to setup a new computer and wanted a handy script that I could just install and have it do all the heavy lifting, forcing my devs to work the same way as the rest of the team. This has been especially useful when dealing with contractors.\n\nadgen currently supports the following features:\n\n* Downloads, compiles and installs appledoc when required.\n  * -u forces a fresh installation of appledoc, overwriting existing version\n* GIT style config files are stored per directory \n* Simple text file for .adconfig allowing easy editing\n  * -p prints current config\n  * -r runs config again\n* Auto install to Xcode\n  * -x to disable\n* Displays full details about each step, paths, etc...\n* Colors indicate important information, warnings or errors\n* If you're using GIT, auto-add (optional) GIT tracking to generated documentation and config\n* Confirmation for config, you can bail if its incorrect\n* Auto discovery and feedback about Xcode projects found and GIT status\n* Auto backup (optional) existing documentation folder\n* Auto generation of documentation, keeping intermediate files where specified in config\n* Auto generate config file on first run/per directory\n* Built in Help system with more information and options 'adgen -h'\n\nFuture Plans\n------------\n\n* Menu based system\n* Silent auto-generation every nth second\n\nInstallation\n------------\n\nI've provided the actual script however the easiest way to install is by downloading the adgen-installer and running it. \nOnce you've done that just run 'adgen' from the folder where your Xcode project files exist and the script will take of the rest.\n\nTo install manually you'll need to chmod 700 (executable) adgen.sh and copy it to /bin/local/bin/adgen\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshaps80%2Fappledoc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshaps80%2Fappledoc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshaps80%2Fappledoc/lists"}