Navigation

    UBports Robot Logo

    UBports Forum

    • Register
    • Login
    • Search
    • Categories
    • Recent
    • Tags
    • Popular
    • Users
    • Groups
    • Search

    Ubuntu Touch Programming Course

    App Development
    documentation ubuntu touch
    27
    113
    25333
    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.
    • mimecar
      mimecar last edited by

      Good afternoon.

      I wanted to comment on the status of the programming course. For personal reasons I have left the course on hold. In these moments with the day to day I already have enough.

      I have reviewed the GitBook server and I see that several things have changed. Now the course is within the "legacy" subdomain and some functions like the start page have been disabled. The book can be updated but with several conditions:

      • The book can only be in HTML format.
      • Plugins no longer work.

      For these reasons I am considering changing the platform of the course. It does not convince me to generate documentation only in HTML format. The platforms that I see reasonable are:

      • LaTeX
      • Sphynx.
      • LibreOffice.

      Of the three platforms I see more powerful LaTeX. It is true that it does more work than using Markdown + GitBook, but it also allows you to better adjust the output in all formats.

      What is your opinion?

      advocatux Pulsar33 lfortanet U 4 Replies Last reply Reply Quote 2
      • advocatux
        advocatux @mimecar last edited by advocatux

        @mimecar hi, good to see you 🙂

        Yes, LaTeX is more complete than the other two tools, and its output has the highest possible quality, but it has the steeper learning curve too, and that's not good if you want people helping you with your course, someday.

        I personally don't see LibreOffice as a good option, so my opinion based in tool functionality, and user-friendliness, I think Sphynx is the best option 🙂

        1 Reply Last reply Reply Quote 0
        • Pulsar33
          Pulsar33 @mimecar last edited by

          @mimecar Hello

          I follow this forum since some months and I was really happy to discover your work (as I said above). There was a chance for me to develop GUI for usefull functions, which is my favorite hobby. I've been programming since the 80's with so many old langages, from microcode to object oriented. However, I don't know about collaborative methods of coding. It's difficult for me to involve in big projects. Nevertheless, I thought that your work could help me to be usefull for the community.

          Unfortunately, I'm blocked (as described to youself and others above). I've read that I'm not the only one to have problems. So, mimecar, sorry but I've no idea about the questions you asked. But what I know is that it would be more usefull for the community to give your time in unblocking volunteers instead of improving your (really nice) documentation. Is it possible please ?

          Best regards
          Pulsar33

          1 Reply Last reply Reply Quote 0
          • Flohack
            Flohack last edited by

            FYI we are in an experimental state with building the sdk again: https://github.com/ubports/usdk-image-tools/pull/1 - if this Pull Request is finally merged it should be able to generate a new SDK 🙂

            BR

            advocatux Pulsar33 lfortanet 5 Replies Last reply Reply Quote 3
            • advocatux
              advocatux @Flohack last edited by

              @flohack wow, that would be really cool \o/

              1 Reply Last reply Reply Quote 0
              • Pulsar33
                Pulsar33 @Flohack last edited by

                @flohack Thank you for the answer
                I don't understand very well what is said on your link. Here is my lack of knowledge about collaborative methods of coding. I'm a poor lonesome coder ...
                But if the work is about to succeed, it's a very good news !
                Best regards
                Pulsar33

                1 Reply Last reply Reply Quote 0
                • lfortanet
                  lfortanet @mimecar last edited by

                  @mimecar Hi...In my opinion, LaTex is the best option, easy and with sufficient resources to guarantee a comfortable edition.

                  1 Reply Last reply Reply Quote 0
                  • lfortanet
                    lfortanet @Flohack last edited by

                    @flohack Great...It would be great, it's very important for the Ubports ecosystem to have a SDK working without give us a lot of isssues.

                    1 Reply Last reply Reply Quote 0
                    • U
                      UniSuperBox @mimecar last edited by

                      @mimecar I know that everyone will have their opinion on your choice of technology, but I can say that document flow and downloadable formats are very good with Sphinx and ReStructuredText. At UBports, we mainly use Read the Docs to accomplish our documentation. The Godot game engine also uses Read the Docs for their documentation quite successfully.

                      If you have any questions on using any of these technologies, drop me a PM and I'll be happy to help you get them set up.

                      1 Reply Last reply Reply Quote 0
                      • mimecar
                        mimecar last edited by

                        Good afternoon.

                        I have dedicated this week to analyzing the different options that I have. For the facilities that it gives, I will use ReadTheDocs. Although it does not give me as much control as the other options (LaTeX, LibreOffice, etc.), it allows me to fulfill the needs that I have:

                        • Reduced time since I finish an entry and it is published.
                        • To be able to have the course in several formats (HTML, PDF, etc.)
                        • Being able to have the documentation in several languages (facilitates collaborations)
                        • Integrated with version control.

                        I'm going to dedicate this month to migrate the course to ReadTheDocs. Next month there would be new delivery of the course. I still do not know if it will be at the beginning or at the end of the month.

                        T 1 Reply Last reply Reply Quote 3
                        • T
                          Talkless @mimecar last edited by

                          @mimecar said in Ubuntu Touch Programming Course:

                          Next month there would be new delivery of the course.

                          This is great news! Thanks a lot!

                          1 Reply Last reply Reply Quote 1
                          • mimecar
                            mimecar last edited by mimecar

                            Second version of the doc 😛
                            https://pbs.twimg.com/media/DkP8fMjXgAE1m3J.jpg:large

                            advocatux 1 Reply Last reply Reply Quote 3
                            • advocatux
                              advocatux @mimecar last edited by

                              @mimecar looks great!

                              1 Reply Last reply Reply Quote 0
                              • Ellypsis
                                Ellypsis last edited by

                                Hi @mimecar ! any news about your programming course? Do you need help on anything?

                                1 Reply Last reply Reply Quote 0
                                • Pulsar33
                                  Pulsar33 @Flohack last edited by

                                  Hello,
                                  @flohack said in Ubuntu Touch Programming Course:

                                  FYI we are in an experimental state with building the sdk again: https://github.com/ubports/usdk-image-tools/pull/1 - if this Pull Request is finally merged it should be able to generate a new SDK 🙂

                                  BR

                                  It seems that something was done some days ago. Is the good sdk available now ?
                                  Best regards
                                  Pulsar33

                                  advocatux 1 Reply Last reply Reply Quote 0
                                  • advocatux
                                    advocatux @Pulsar33 last edited by

                                    @pulsar33 just in case you don't know it, @dobey is working on https://github.com/dobey/ergo

                                    Pulsar33 1 Reply Last reply Reply Quote 0
                                    • Pulsar33
                                      Pulsar33 @advocatux last edited by

                                      @advocatux : thanks but I don't find a thread speaking of that on this forum and github is a bit vague for me.

                                      @Flohack : any news ?

                                      Best regards
                                      Pulsar33

                                      advocatux 1 Reply Last reply Reply Quote 0
                                      • advocatux
                                        advocatux @Pulsar33 last edited by

                                        @pulsar33 what I meant with that post is just to let you know that there will be a new toolkit 🙂

                                        1 Reply Last reply Reply Quote 0
                                        • Pulsar33
                                          Pulsar33 @Flohack last edited by

                                          @flohack said in Ubuntu Touch Programming Course:

                                          FYI we are in an experimental state with building the sdk again: https://github.com/ubports/usdk-image-tools/pull/1 - if this Pull Request is finally merged it should be able to generate a new SDK 🙂

                                          BR

                                          @Flohack : I read on your link :

                                          • Generate the SDK for Ubports #1
                                            Merged
                                            mardy merged 5 commits into ubports:master from mardy:ubports 21 days ago

                                          But I'm not sure to understand. Can we use now the Ubuntu Touch Programming Course with the good sdk ?

                                          Best regards
                                          Pulsar33

                                          Flohack 1 Reply Last reply Reply Quote 0
                                          • Flohack
                                            Flohack @Pulsar33 last edited by

                                            @pulsar33 Me neither, please ask @mardy or @mimecar 🙂

                                            Pulsar33 1 Reply Last reply Reply Quote 0
                                            • First post
                                              Last post