• Recent
  • Tags
  • Popular
  • Home
  • Docs
  • Register
  • Login
RetroPie forum home
  • Recent
  • Tags
  • Popular
  • Home
  • Docs
  • Register
  • Login

Operation Make the Wiki Pretty!

Scheduled Pinned Locked Moved Ideas and Development
wikidocumentation
37 Posts 9 Posters 8.0k Views
Loading More Posts
  • Oldest to Newest
  • Newest to Oldest
  • Most Votes
Reply
  • Reply as topic
Log in to reply
This topic has been deleted. Only users with topic management privileges can see it.
  • M
    mattrixk @herb_fargus
    last edited by 23 Jan 2017, 03:35

    @herb_fargus: It looks good, but I've noticed something. When you have 2 levels of dot-points on the old wiki (like this), it shows up as a single line of dot-points like this on the new pretty one.

    My ES themes: MetaPixel | Spare | Io | Indent

    H 2 Replies Last reply 23 Jan 2017, 04:17 Reply Quote 0
    • H
      herb_fargus administrators @mattrixk
      last edited by 23 Jan 2017, 04:17

      @mattrixk I didn't realise that, I believe it is due to mkdocs using python markdown whereas the github wiki obviously uses github flavoured markdown (btw this is why many people recommend ReStructured Text for documentation instead of a non standardised markdown) for reference https://github.com/waylan/Python-Markdown/issues/3

      I'll see if there are some parser extensions or settings in the .yml that I can add that might address the markdown nuances.

      If you read the documentation it will answer 99% of your questions: https://retropie.org.uk/docs/

      Also if you want a solution to your problems read this first: https://retropie.org.uk/forum/topic/3/read-this-first

      1 Reply Last reply Reply Quote 1
      • H
        herb_fargus administrators @mattrixk
        last edited by 23 Jan 2017, 04:37

        @mattrixk so this is one of those things where we may need to update some wiki pages.

        I've tested it and I'm pretty sure 4 spaces instead of 2 works see the following:

        - Level 1
            - Level2
        
        • Level 1
          • Level2

        If you read the documentation it will answer 99% of your questions: https://retropie.org.uk/docs/

        Also if you want a solution to your problems read this first: https://retropie.org.uk/forum/topic/3/read-this-first

        M 2 Replies Last reply 23 Jan 2017, 04:40 Reply Quote 0
        • M
          mattrixk @herb_fargus
          last edited by 23 Jan 2017, 04:40

          @herb_fargus Okay, great. I'll have a look at it tomorrow during my lunch break (won't have the chance tonight, I'm probably going to crash out as soon as I get home... and it's only Monday).

          My ES themes: MetaPixel | Spare | Io | Indent

          1 Reply Last reply Reply Quote 0
          • H
            herb_fargus administrators
            last edited by 23 Jan 2017, 04:42

            It's not pressing by any means. this will take a while to get into a publishable state, thanks for the feedback

            If you read the documentation it will answer 99% of your questions: https://retropie.org.uk/docs/

            Also if you want a solution to your problems read this first: https://retropie.org.uk/forum/topic/3/read-this-first

            1 Reply Last reply Reply Quote 0
            • M
              mattrixk @herb_fargus
              last edited by 23 Jan 2017, 04:50

              @herb_fargus: I just made a quick change to that page (just adding the 2 extra spaces to those first list items), but it didn't make a change to the new pretty version. Do I need to do anything to "push" the change, or is it just a matter of waiting?

              My ES themes: MetaPixel | Spare | Io | Indent

              H 1 Reply Last reply 23 Jan 2017, 05:32 Reply Quote 0
              • H
                herb_fargus administrators @mattrixk
                last edited by 23 Jan 2017, 05:32

                @mattrixk I have to update the submodule (which clones the latest version of the retropie wiki) and then rebuild the site and push the changes to the docs repository

                I'll probably make a module at some point to automate the process.

                If you read the documentation it will answer 99% of your questions: https://retropie.org.uk/docs/

                Also if you want a solution to your problems read this first: https://retropie.org.uk/forum/topic/3/read-this-first

                M 1 Reply Last reply 23 Jan 2017, 05:39 Reply Quote 1
                • M
                  mattrixk @herb_fargus
                  last edited by 23 Jan 2017, 05:39

                  @herb_fargus Ahh okay. No worries. As I said, I probably won't get the chance to update that page until tomorrow or the day after, so no rush. (also, it's not a major problem, but I'm glad there is a simple solution.)

                  My ES themes: MetaPixel | Spare | Io | Indent

                  1 Reply Last reply Reply Quote 0
                  • H
                    herb_fargus administrators
                    last edited by 23 Jan 2017, 06:36

                    I've deployed the latest and can confirm the nested lists are working with the 4 spaces.

                    I wrote up quick workflow on deploying the docs (mostly for personal reference) likely can be improved

                    https://github.com/RetroPie/RetroPie-Docs/wiki/Updating-the-Docs

                    If you read the documentation it will answer 99% of your questions: https://retropie.org.uk/docs/

                    Also if you want a solution to your problems read this first: https://retropie.org.uk/forum/topic/3/read-this-first

                    1 Reply Last reply Reply Quote 1
                    • H
                      hooperre
                      last edited by hooperre 20 Feb 2017, 23:24

                      Edit: Nvm. Thought it was live. Still looks great haha.

                      4B ~ RPi PSU 5.1V / 3.0A ~ 32GB SanDisk microSD ~ 128GB USB

                      B 1 Reply Last reply 21 Feb 2017, 01:04 Reply Quote 0
                      • B
                        BuZz administrators @hooperre
                        last edited by 21 Feb 2017, 01:04

                        @hooperre the wiki is now converted and available from the docs link at the top of the screen here. Herb did a great job. It's still being improved but the documentation is now more accessible than it was via GitHub.

                        To help us help you - please make sure you read the sticky topics before posting - https://retropie.org.uk/forum/topic/3/read-this-first

                        1 Reply Last reply Reply Quote 0
                        • B
                          backstander @herb_fargus
                          last edited by 21 Feb 2017, 17:47

                          @herb_fargus
                          I might have trouble explaining this but...

                          When you're trying to point someone to a selection on one of the Wiki pages, it uses the # sign + the name of that header (without any spaces/special characters and all in lowercase) like for example:
                          https://github.com/RetroPie/RetroPie-Setup/wiki/First-Installation#installation

                          For me to get that link I click on that "Installation" header and it gives me that address so I can post it for someone on the forum.

                          Now the Docs, that # sign thing works but I can't click on that "Installation" header to easily give me this address:
                          https://retropie.github.io/RetroPie-Docs/First-Installation/#installation

                          I don't know anything about mkdocs but is this something that can be added or is it not available like github has it?

                          H 1 Reply Last reply 21 Feb 2017, 20:57 Reply Quote 0
                          • H
                            herb_fargus administrators @backstander
                            last edited by 21 Feb 2017, 20:57

                            @backstander I believe that's specific to github. Isn't clicking on the TOC on the right the same thing though?

                            If you read the documentation it will answer 99% of your questions: https://retropie.org.uk/docs/

                            Also if you want a solution to your problems read this first: https://retropie.org.uk/forum/topic/3/read-this-first

                            B 1 Reply Last reply 21 Feb 2017, 21:14 Reply Quote 1
                            • B
                              backstander @herb_fargus
                              last edited by 21 Feb 2017, 21:14

                              Isn't clicking on the TOC on the right the same thing though?

                              Yes, I didn't realize that was clickable ;-)
                              Thanks @herb_fargus

                              1 Reply Last reply Reply Quote 0
                              • M
                                mrbwa1
                                last edited by 21 Feb 2017, 21:18

                                Does anyone have an opinion ofn having the FAQ at the Top Level instead of under Troubleshooting. I have spent too many years in support and folks don't seem to look at Troubleshooting, but will look at an FAQ.

                                Not a big deal if it's current place is where it should be, just thinking out loud.

                                B H 2 Replies Last reply 21 Feb 2017, 21:21 Reply Quote 2
                                • B
                                  backstander @mrbwa1
                                  last edited by 21 Feb 2017, 21:21

                                  @mrbwa1
                                  I agree. To me I think of FAQ and Troubleshooting as very closely related (if not the same thing) but non-technical users think of FAQ as something they will read and Troubleshooting as something that's way over their heads and they don't typically read.

                                  1 Reply Last reply Reply Quote 0
                                  • H
                                    herb_fargus administrators @mrbwa1
                                    last edited by 22 Feb 2017, 01:04

                                    @mrbwa1 I put it down there because for one it's a bit outdated, and most people's frequently asked questions I would hope would be addressed on the first installation page, or at the very least individual system pages.

                                    I'm also more of the opinion that people should take the time to understand how the system works rather than chasing Willy nilly through the infinite variations of questions that are derived from the same base misunderstanding.

                                    The current FAQ just looks spammy to me. I don't know personally how I want it laid out or even what I want it to include. I'm probably going to remove at least a few of them as they are irrelevant. I'm almost more partial to a more generalised what is emulationstation what is retropie what are ROMs etc. Rather than the customised tweaks or questions about specific games...

                                    Idk what do you think?

                                    If you read the documentation it will answer 99% of your questions: https://retropie.org.uk/docs/

                                    Also if you want a solution to your problems read this first: https://retropie.org.uk/forum/topic/3/read-this-first

                                    B 1 Reply Last reply 22 Feb 2017, 01:16 Reply Quote 1
                                    • B
                                      backstander @herb_fargus
                                      last edited by backstander 22 Feb 2017, 01:16

                                      @herb_fargus

                                      The current FAQ just looks spammy to me.

                                      I agree but I don't know what could be done to make it flow better.

                                      Idk what do you think?

                                      I personally like the technical aspects of the wiki but when someone is new here they might want something a little more stripped down and the basics.

                                      Maybe have a first page with the basics and a 2nd page with all the advanced features per system? Idk, I'm just thinking out loud.

                                      1 Reply Last reply Reply Quote 0
                                      • D
                                        detron
                                        last edited by 14 Oct 2017, 22:59

                                        I think the retropie.org.uk/docs/ looks great. I may be the oddball here, but is there an "off-line" version of the manual?
                                        I find that the times I do not have internet access are usually the times I would take a deeper look at manuals and configurations.

                                        I know that online stays current, and some of the links go to other sites, but I was just curious.

                                        thank you.

                                        PS. I would buy a "RetroPie: The Complete Manual" type book. since I already buy things like

                                        alt text

                                        and

                                        alt text

                                        meleuM 1 Reply Last reply 15 Oct 2017, 01:57 Reply Quote 0
                                        • meleuM
                                          meleu @detron
                                          last edited by meleu 11 Sept 2017, 18:55 15 Oct 2017, 01:57

                                          @detron said in Operation Make the Wiki Pretty!:

                                          but is there an "off-line" version of the manual?

                                          what about downloading the current version to your computer right now?

                                          Here is the command to do the trick:

                                          EDIT: removed the trick because it can stress the server.

                                          • Useful topics
                                          • joystick-selection tool
                                          • rpie-art tool
                                          • achievements I made
                                          D B 2 Replies Last reply 15 Oct 2017, 02:37 Reply Quote 0
                                          • First post
                                            Last post

                                          Contributions to the project are always appreciated, so if you would like to support us with a donation you can do so here.

                                          Hosting provided by Mythic-Beasts. See the Hosting Information page for more information.

                                            This community forum collects and processes your personal information.
                                            consent.not_received