{"action":"created","issue":{"url":"https://api.github.com/repos/RetroPie/RetroPie-Setup/issues/1833","repository_url":"https://api.github.com/repos/RetroPie/RetroPie-Setup","labels_url":"https://api.github.com/repos/RetroPie/RetroPie-Setup/issues/1833/labels{/name}","comments_url":"https://api.github.com/repos/RetroPie/RetroPie-Setup/issues/1833/comments","events_url":"https://api.github.com/repos/RetroPie/RetroPie-Setup/issues/1833/events","html_url":"https://github.com/RetroPie/RetroPie-Setup/issues/1833","id":200256378,"number":1833,"title":"Make Wiki Prettier","user":{"login":"HerbFargus","id":10035308,"avatar_url":"https://avatars.githubusercontent.com/u/10035308?v=3","gravatar_id":"","url":"https://api.github.com/users/HerbFargus","html_url":"https://github.com/HerbFargus","followers_url":"https://api.github.com/users/HerbFargus/followers","following_url":"https://api.github.com/users/HerbFargus/following{/other_user}","gists_url":"https://api.github.com/users/HerbFargus/gists{/gist_id}","starred_url":"https://api.github.com/users/HerbFargus/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/HerbFargus/subscriptions","organizations_url":"https://api.github.com/users/HerbFargus/orgs","repos_url":"https://api.github.com/users/HerbFargus/repos","events_url":"https://api.github.com/users/HerbFargus/events{/privacy}","received_events_url":"https://api.github.com/users/HerbFargus/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":7,"created_at":"2017-01-12T01:36:28Z","updated_at":"2017-01-21T23:28:58Z","closed_at":null,"body":"The wiki is fantastic. I like it a lot. but per our earlier discussion there are a few things we can do to improve the design of the wiki so it looks a little cleaner.\r\n\r\nHere are a few examples:\r\n\r\n### Sphinx:\r\n**Borg Backup**\r\nhttps://borgbackup.readthedocs.io/en/stable/\r\ngithub repo: https://github.com/borgbackup/borgbackup.github.io\r\n**Qgis**\r\nhttp://www.qgis.org/en/docs/index.html\r\n\r\n### Mkdocs:\r\nhttps://mkdocs.readthedocs.io/en/stable/\r\n\r\nI think they should be able to be hosted on github with github pages (powered by jekyll of course)\r\n\r\nI don't think we should do away with the github wiki by any means as it is nice to be able to rely on the community for wiki updates but one way would be to have a conversion script of sorts \r\n\r\nThere is some discussion on it here: \r\nhttp://stackoverflow.com/questions/25578928/rendering-a-github-wiki-on-a-github-pages-jekyll-site\r\n\r\nBasically the script will create wiki pages with proper liquid tags for jekyll. unfortunately the examples are broken but it should still be a doable thing. We can rerun the script whenever we need to, to regenerate the docs from our wiki.\r\n\r\ngithub repo here: https://github.com/djacquel/WikiToJekyll\r\n\r\nI'm sure there are other ideas too, I'm open to any good ideas. there are a few things on the wiki that may need some work (mame being one of them)\r\n"},"comment":{"url":"https://api.github.com/repos/RetroPie/RetroPie-Setup/issues/comments/274295305","html_url":"https://github.com/RetroPie/RetroPie-Setup/issues/1833#issuecomment-274295305","issue_url":"https://api.github.com/repos/RetroPie/RetroPie-Setup/issues/1833","id":274295305,"user":{"login":"HerbFargus","id":10035308,"avatar_url":"https://avatars.githubusercontent.com/u/10035308?v=3","gravatar_id":"","url":"https://api.github.com/users/HerbFargus","html_url":"https://github.com/HerbFargus","followers_url":"https://api.github.com/users/HerbFargus/followers","following_url":"https://api.github.com/users/HerbFargus/following{/other_user}","gists_url":"https://api.github.com/users/HerbFargus/gists{/gist_id}","starred_url":"https://api.github.com/users/HerbFargus/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/HerbFargus/subscriptions","organizations_url":"https://api.github.com/users/HerbFargus/orgs","repos_url":"https://api.github.com/users/HerbFargus/repos","events_url":"https://api.github.com/users/HerbFargus/events{/privacy}","received_events_url":"https://api.github.com/users/HerbFargus/received_events","type":"User","site_admin":false},"created_at":"2017-01-21T23:28:58Z","updated_at":"2017-01-21T23:28:58Z","body":"\r\n@markwkidd from what I gather lakka uses the bootswatch theme, I am looking more for a theme that has complete nav and dropdowns on the left side.\r\n\r\nHow I envision it is to have 3ish levels of navigation where I have one master config file that defines the TOC.\r\n\r\nSo it would be\r\n\r\n- Top level togglable nav (Home, Emulators, Ports, Advanced Configs, Development, etc)\r\n  - Second Level Nav (Individual Wiki Pages)\r\n      - Third Level Nav (markdown headings for each wiki page #, ##, ###)\r\n\r\nexample config\r\n\r\n```\r\npages:\r\n\r\nHome\r\n   - index.md\r\n      - What is RetroPie\r\n      - What is an Emulator\r\n      - What are ROMS\r\n      - Getting Started\r\nEmulators\r\n   - AGS\r\n      - Roms\r\n      - Controls\r\n   - Amiga\r\n      - Roms\r\n      - Controls\r\n\r\netc.\r\n```\r\nExample from borg docs:\r\n\r\n![nav screenshot](https://cloud.githubusercontent.com/assets/10035308/22178544/dd50864a-dfed-11e6-8496-7c2efe272a02.png)\r\n"}}
{"actor":{"display_login":"HerbFargus"}}