{"id":26461817,"url":"https://github.com/SynBioDex/SBOL-specification","last_synced_at":"2025-03-19T05:02:04.396Z","repository":{"id":33893324,"uuid":"37606622","full_name":"SynBioDex/SBOL-specification","owner":"SynBioDex","description":"The Synthetic Biology Open Language (SBOL)","archived":false,"fork":false,"pushed_at":"2023-04-25T15:52:14.000Z","size":17173,"stargazers_count":16,"open_issues_count":14,"forks_count":9,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-03-01T05:18:19.521Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://sbolstandard.org","language":"TeX","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/SynBioDex.png","metadata":{"files":{"readme":"README.md","changelog":"history.tex","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-06-17T16:23:47.000Z","updated_at":"2025-02-08T04:41:41.000Z","dependencies_parsed_at":"2025-01-11T19:34:38.502Z","dependency_job_id":"56ff95e4-628b-4011-9dab-157065a8077d","html_url":"https://github.com/SynBioDex/SBOL-specification","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SynBioDex%2FSBOL-specification","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SynBioDex%2FSBOL-specification/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SynBioDex%2FSBOL-specification/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SynBioDex%2FSBOL-specification/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SynBioDex","download_url":"https://codeload.github.com/SynBioDex/SBOL-specification/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244358431,"owners_count":20440360,"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":"2025-03-19T05:02:03.070Z","updated_at":"2025-03-19T05:02:04.388Z","avatar_url":"https://github.com/SynBioDex.png","language":"TeX","funding_links":[],"categories":["TeX"],"sub_categories":[],"readme":"# SBOL-specification\n\nThis repository contains the master specification document for the SBOL data model, formatted in LaTeX.  The workflow for updating the specification is to clone, edit, and submit a pull request on the master.\n\nMembers of the SBOL Development Community may use the issue tracker to flag problems with the existing specification and review ongoing issues under consideration.\n\n## Submitting changes to the specification\n\nBefore writing text for a non-trivial change, please have it approved by discussion as an Issue and/or SEP.\n\nProposed changes should be marked with the appropriate version\nmacros. The LaTeX command `\\threezeroone` has been provided for this\npurpose. See examples in the LaTeX source for proper usage.\n\nProposed changes should be made in either a branch or a separate fork on GitHub.  To do this, follow standard git branching or forking procedure.\n\nHere is an example of git commands to achieve this:\n\n```shell\ngit clone https://github.com/SynBioDex/SBOL-specification.git\ncd SBOL-specification\n\n# Make sure no one has made anymore changes\ngit pull origin master\n# Create new branch\ngit checkout -b \u003cnewBranch\u003e\n\n# Make your edits\ngit add \u003cfilesYouChanged\u003e\ngit commit\ngit push origin \u003cnewBranch\u003e\n```\n\nWhen you are ready for your changes to be reviewed for incorporation, create a pull request.\nIf you need help on pull requests see: https://help.github.com/articles/about-pull-requests/\n\n## Automation\n\nThis repository uses a [Github Action](https://github.com/features/actions) to automatically build the project when a pull request is made to the `SBOL3` branch, or a push is made to the branch (inlcuding when a PR is merged).\nThis creates a PDF and uploads it as as a [workflow artefact](https://help.github.com/en/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts); GitHub retains these for 90 days.\nYou can download this PDF by clicking on the green check mark beside a commit, then clicking 'details' in the popover; this will navigate to a different page, where you can click on 'Artefacts' and then 'PDF'.\n\nIf building the PDF fails, then this is shown by a red cross. \nThis does not necessarily mean that there is a problem with the specification document: automated builds will also fail if they are for a pull request that has already been closed, or are from a different repository (i.e., a fork rather than a branch). \n\nThe action is defined by the file [`.github/workflows/main.yml`](./.github/workflows/main.yml)\n\n## Using LaTeX\n\n### Building the PDF from LateX\n\nTo build, run these commands and check the output for errors. If there are errors, resolve them and re-run the failed build step before proceeding.\n\n    pdflatex sbol3\n    bibtex sbol3\n    pdflatex sbol3\n    pdflatex sbol3\n\nNote that pdflatex is run several times. Each successive pass mows down unresolved references from the previous passes. For example, the extra pdflatex commands set references correctly after bibtex completes. You don’t need to do this in every build unless the bibliography has changed.  For development purposes, you may just need to run pdflatex once.\n\nThe git status command will show you which intermediate build products and logs you need to delete for a clean build.\n\nYou can also build with Docker if you don't want to install latex, but note that the Docker image is huge.\n\n    docker run -v $(pwd):/opt/spec jmcl/specbuild\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSynBioDex%2FSBOL-specification","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSynBioDex%2FSBOL-specification","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSynBioDex%2FSBOL-specification/lists"}