{"id":19848667,"url":"https://github.com/polterguy/aista-dox","last_synced_at":"2025-10-08T21:40:54.702Z","repository":{"id":84670024,"uuid":"463463773","full_name":"polterguy/aista-dox","owner":"polterguy","description":"Main documentation theme","archived":false,"fork":false,"pushed_at":"2023-04-15T08:49:51.000Z","size":1266,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-09-01T02:44:08.436Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://ainiro.io","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/polterguy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2022-02-25T08:57:51.000Z","updated_at":"2023-04-13T17:33:45.000Z","dependencies_parsed_at":null,"dependency_job_id":"fbdc1c5f-3813-4867-b14b-3ada64e2df43","html_url":"https://github.com/polterguy/aista-dox","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/polterguy/aista-dox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polterguy%2Faista-dox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polterguy%2Faista-dox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polterguy%2Faista-dox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polterguy%2Faista-dox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/polterguy","download_url":"https://codeload.github.com/polterguy/aista-dox/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polterguy%2Faista-dox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000706,"owners_count":26082837,"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","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-11-12T13:17:56.571Z","updated_at":"2025-10-08T21:40:54.686Z","avatar_url":"https://github.com/polterguy.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Aista Dox Jekyll Theme\n\nThis is a Jekyll theme created for Aista Ltd, and more specifically [Magic Cloud](https://polterguy.github.io/) to\ndocument our project(s). If you want to use it for your own site, you're welcome to do so under the terms of \nCreative Commons Attribution-ShareAlike version 4, implying you'll have to keep the link to our web site. Below\nis a screenshot of the theme in use over at [Magic Cloud's documentation site](https://polterguy.github.io/).\n\n![Screenshot of theme](https://raw.githubusercontent.com/polterguy/aista-dox/master/screenshot.jpg)\n\nThe theme works perfectly for your GitHub Page, and in fact it was explicitly created to document our\nown open source framework [Magic Cloud](https://github.com/polterguy/magic), and the theme is created\nwith a _\"content first\"_ approach, implying content over functionality, which of course is important\nfor a site intended to document an open source framework such as [Magic](https://polterguy.github.io).\n\n## Installation\n\nTo use the theme add something resembling the following to your YAML configuration file _\"\\_config.yml\"_.\n\n```\n# The next line declares you want to use this theme\nremote_theme: polterguy/aista-dox\n\n# The next line declares the URL structure of your blog items\npermalink: /blog/:title\n\n# Title of your site\ntitle: Title of your site\n\n# Slogan of your site\nslogan: Slogan of your site\n\n# Description of your site\ndescription: This is the description for your site\n\n# Google Analytics tracking code\ngoogle_analytics: UA-123456789-1\n\n# Copyright displayed in the bottom right corner\ncopyright: © Foo, Ltd 2022\n\n# Most Wanted Response, most important link on your site\nmwr: /section-1/foo\nmwr_text: Foo 1\n\n# Background images for banner and the main body/content parts of your site\nbanner_bg: /assets/bg.jpeg\nbody_bg: /assets/bg2.jpeg\n\n# Open Graph image for pages when shared on Facebook or Twitter, etc\nog_image: https://some-url.com/to-open-graph-image.jpeg\n\n# Your navigation section. Declares the drop down menu items for your hamburger menu.\nnav_sections:\n  - name: Section 1\n    items:\n      - url: /section-1/foo\n        name: Foo 1\n      - url: /section-1/bar\n        name: Foo 2\n  - name: Section 2\n    items:\n      - url: /section-2/\n        name: Another foo\n```\n\nThe `remote_theme` parts needs to be exactly as above, the rest is intended for configuring your site, and include\nGoogle Analytics tracking codes, MWR (_\"Most Wanted Response\"_, a link on your site being the most important navigation hyperlink),\nand navigation sections, etc. The navigation sections becomes a navbar that you can toggle at the top of your page\nusing a hamburger button. If you don't provide an MWR, and/or a `nav_section`, these elements will not be rendered.\n\n## Usage\n\nThe theme is blog aware, assuming you save your blog posts into your _\"\\_posts\"_ folder. To list your blog items, create\na Markdown page and store at your root folder and name it for instance _\"blog.md\"_, and fill it with the following content.\n\n```markdown\n---\nlayout: blog\npermalink: /blog/\n---\n\nSome descriptive spiehl here for your blog ...\n\n```\n\nTo create a single blog item, create a file called for instance _\"2022-01-04-new-documentation-website.md\"_ and store it\ninto your _\"\\_posts\"_ folder and fill it as follows.\n\n```markdown\n---\nlayout: post\nauthor: john doe\n---\n\nBananas are _cool_ because they can be eaten.\n```\n\nIf you do the above, you can go to your site with the relative URL of `/blog/` to see a list of your blogs.\n\n### Creating custom pages\n\nTo create custom pages, you can create a markdown file such as the following and store under for instance\na _\"misc\"_ folder.\n\n```markdown\n---\nlayout: default\npermalink: /about\n---\n\n# About our amazingly cool website\n\nThis website is like the coolest website in the world, because it features Bananas!\n```\n\n## License\n\nThe theme is freely available as open source under the terms of the [Creative Commons Attribution-ShareAlike 4.0 license](https://creativecommons.org/licenses/by-sa/4.0/legalcode).\n\n## Copyright and maintenance\n\nThe projects is copyright of Aista, Ltd 2021 - 2023, and professionally maintained by [AINIRO your friendly ChatGPT website chatbot vendor](https://ainiro.io).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpolterguy%2Faista-dox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpolterguy%2Faista-dox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpolterguy%2Faista-dox/lists"}