{"id":28100360,"url":"https://github.com/tidev/titanium-docs","last_synced_at":"2025-10-30T01:04:22.815Z","repository":{"id":37824222,"uuid":"158241606","full_name":"tidev/titanium-docs","owner":"tidev","description":"We use VuePress for Guides and API docs.","archived":false,"fork":false,"pushed_at":"2025-04-28T09:23:30.000Z","size":1699388,"stargazers_count":13,"open_issues_count":10,"forks_count":23,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-04-28T10:38:45.690Z","etag":null,"topics":["documentation","hacktoberfest","markdown","vue","vuepress"],"latest_commit_sha":null,"homepage":"https://titaniumsdk.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tidev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"tidev","liberapay":"tidev"}},"created_at":"2018-11-19T14:55:43.000Z","updated_at":"2025-04-28T09:23:34.000Z","dependencies_parsed_at":"2023-02-16T00:31:30.963Z","dependency_job_id":"513b3c18-77f0-480f-b6ae-93d9ff161b55","html_url":"https://github.com/tidev/titanium-docs","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/tidev%2Ftitanium-docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tidev%2Ftitanium-docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tidev%2Ftitanium-docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tidev%2Ftitanium-docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tidev","download_url":"https://codeload.github.com/tidev/titanium-docs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254003562,"owners_count":21997904,"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":["documentation","hacktoberfest","markdown","vue","vuepress"],"created_at":"2025-05-13T18:33:52.740Z","updated_at":"2025-10-30T01:04:22.809Z","avatar_url":"https://github.com/tidev.png","language":"JavaScript","funding_links":["https://github.com/sponsors/tidev","https://liberapay.com/tidev"],"categories":[],"sub_categories":[],"readme":"# titanium-docs\n\n\u003e Website with Guides and API docs for the [Titanium SDK](https://github.com/tidev/titanium_mobile) (Powered by [VuePress](https://vuepress.vuejs.org/)).\n\n## Getting started\n\nThese docs aim to be a hybrid solution of Markdown bases guides and dynamically generated docs for API references using the existing [apidoc](https://github.com/tidev/titanium-sdk/tree/master/apidoc) from Titanium.\n\n### Installation\n\n```bash\ngit clone https://github.com/tidev/titanium-docs.git\ncd titanium-docs\nnpm i\n```\n\n### Development\n\nVuePress supports a dev mode with hot reloading for a convenient developing experience.\n\n```bash\nnpm run docs:dev\n```\n\nNow start editing the docs and you can immediatly see the results in your browser.\n\n### Building the docs\n\nThere are currently a few manual steps required to build the docs which we aim to consolidate into a single build step while this project moves foreward.\n\n\u003e ✅ For convenience the repo currently contains a pre-generate `api.json` so you can skip this if you just want to play with the new docs.\n\nThe following steps assume you have checked out this repo parallel to Titanium so that your folder structure looks like this:\n\n```\n./\n├── titanium_mobile/\n└── titanium-docs/\n```\n\nNow generate the `api.json` into the `docs/api` folder\n\n```bash\nnpm run docs:metadata\n```\n\nFinally, let VuePress build the awesome new docs.\n\n```bash\ncd ../titanium-docs\nnpm run docs:build\n```\n\nThis will output the statically rendered docs into `docs/.vuepress/dist`.\n\n## Versioning\n\nRun the script with a command line argument of the version you wish to create. e.g.,\n\n```bash\nnpm run docs:version 8.0\n```\n\nThis will preserve all documents currently in the `docs` directory and make them available as documentation for version `8.0`.\n\nFor more info please refer to the [versioning guide](https://titanium-docs-devkit.netlify.com/guide/versioning.html).\n\n## Migrating docs to VuePress\n\n[VuePress](https://vuepress.vuejs.org/) renders gorgeously looking documentation directly from markdown files. This means that our currents guides and parts of the api docs have to be migrated to markdown files. Thanks to VuePress they can be enhanced with Vue components to bypass the restriction of markdown in terms of rendering complex HTML structures.\n\n### Writing guides in VuePress\n\nGuides reside under `docs/guide` and a few documents already have been ported as examples. However none of those guides are complete yet.\n\nTo add a new guide first create a new markdown file under `docs/guide`. To add it to the sidebar navigation open `docs/.vuepress/config.js` and edit the `/guide/` section under `themeConfig.sidebar`. The key you want to add is the name of the new markdown file without the `.md` extension.\n\n```js\nmodule.exports = {\n  themeConfig: {\n    sidebar: {\n      '/guide/': [\n        {\n          title: 'Titanium Guides',\n          collapsable: false,\n          children: [\n            '',\n            'getting-started',\n            'first-app'\n            'my-new-guide'\n          ]\n        }\n      ],\n     // ...\n    }\n  }\n}\n```\n\n### Adding API docs\n\nIn theory the `api.json` contains all required information to automatically generate markdown files. However, some APIs contain very detailed description and various examples which are just better to maintain directly in markdown files here than in their `.yaml` counterpart in Titanium's [apidoc](https://github.com/tidev/titanium-sdk/tree/master/apidoc). All other information regarding the API for a type in Titanium is then taken from the `api.json`. This creates a clear seperation of extensive documentation and simple api reference.\n\nTo automatically migrate a type over to these docs you can run the migration script.\n\n```bash\nnode scripts/migrate.js\n```\n\nThis will parse `docs/api/api.json` and generate the missing markdown files.\n\nYou may need to adjust the automatically generated content and fix any markdown issues or adjust the front matter section to properly display links throughout the docs.\n\nApart of the [predefined variables](https://vuepress.vuejs.org/guide/frontmatter.html#predefined-variables) from VuePress, API pages support the following additional variables:\n\n| Name | Descriptions |\n| --- | --- |\n| `metadataKey` | Fully qualified type name which is used to find metadata for a type in `api.json`. The page title will be used if this is not set. |\n\nOnce you have made sure the automatically generated markdown is correct you can add the new type to the sidebar in `docs/.vuepress/config.js` under the `/api/` key.\n\n## Deploy\n\nOne time:\n\n\tgit remote add dokku dokku@titaniumsdk.com:titaniumsdk.com\n\nThen to release:\n\n\tgit push dokku main\n\n## Contributions\n\nOpen source contributions are greatly appreciated! If you have a bugfix, improvement or new feature, first make sure you have signed the [TiDev CLA](https://github.com/tidev/organization-docs/blob/main/AUTHORIZED_CONTRIBUTORS.md), then create\n[an issue](https://github.com/tidev/titanium-docs/issues/new) first and submit a [pull request](https://github.com/tidev/titanium-docs/pulls/new) against master.\n\n## Legal\n\nTitanium is a registered trademark of TiDev Inc. All Titanium trademark and patent rights were transferred and assigned to TiDev Inc. on 04/07/2022. Please see the LEGAL information about using our trademarks, privacy policy, terms of usage and other legal information at https://tidev.io/legal.\n\n## License\n\nTitanium is licensed under the OSI approved Apache Public License (Version 2). All trademark rights were assigned to TiDev, Inc. on 04/07/2022 from Axway, Inc. Please see the LICENSE file for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftidev%2Ftitanium-docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftidev%2Ftitanium-docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftidev%2Ftitanium-docs/lists"}