Re: [SailfishDevel] Developing with SailfishOS - a short introduction
Hi all, this is a shameless plug (again). Still far from complete, now 133 pages short. The PDF can be directly downloaded from http: //hardcodes.de/SailfishOS/Developing-with-SailfishOS.pdf The project resides on Github. https://github.com/hardcodes/developwithsailfishos.git The source is still in LaTeX but I've decided to go for MultiMarkDown in near future. Happy holidays! BR. Sven ___ SailfishOS.org Devel mailing list
Re: [SailfishDevel] Developing with SailfishOS - a short introduction
Hi all, just a little update. A downloadable pdf version can now be found at http://hardcodes.de/SailfishOS/Developing-with-SailfishOS.pdf. It is still far from complete but grows :-) I went from thinking about moving to another markup language to I will move. But I am still thinking about which one?. If you ask for a gut reaction, I would answer MultiMarkDown. Still not sure... Have a nice weekend! BR. Sven ___ SailfishOS.org Devel mailing list
Re: [SailfishDevel] Developing with SailfishOS - a short introduction
W dniu 07.12.2013 11:13, Putze Sven pisze: Hi all, just a little update. A downloadable pdf version can now be found at http://hardcodes.de/SailfishOS/Developing-with-SailfishOS.pdf. It is still far from complete but grows :-) I went from thinking about moving to another markup language to I will move. But I am still thinking about which one?. If you ask for a gut reaction, I would answer MultiMarkDown. Still not sure... Have a nice weekend! How did I miss your first post in this thread? Great idea of creating such document - things like that are really needed to attract new developers. Regards, Filip PS. Thanks for mentioning SmartDevCon ;) ___ SailfishOS.org Devel mailing list
Re: [SailfishDevel] Developing with SailfishOS - a short introduction
Great work! A troubleshooting section with known issues could be great to have as well! Best, tortoisedoc On Sun, Dec 1, 2013 at 10:27 PM, christopher.l...@thurweb.ch wrote: Hi Sven Have now downloaded. Lots of good content, but I need to read through it a few more times to comment in detail. One thing that immediately occurs to me is: 2.3 Linux While it is not supported, an instalation of Sailfish within a Linux VM hosted on OSX works quite happily. It is some months since I did it (first sDK version), but I was able to install Lubuntu on VMWare Fusion hosted by OSX, and then install VirtualBox and the Sailfish SDK into that. The only problems I had could be replicated on a bare-metal install of Lubuntu. mfg Chris Zitat von Sven Putze sailfish...@hardcodes.de: Hi there, first of all: this is far from complete and basically just a skeleton yet. Nevertheless I have started to write down a howto for SailfishOS development. Criticism, suggestions, bugfixes, contribution wanted! https://github.com/hardcodes/developwithsailfishos BR. Sven ___ SailfishOS.org Devel mailing list ___ SailfishOS.org Devel mailing list ___ SailfishOS.org Devel mailing list
Re: [SailfishDevel] Developing with SailfishOS - a short introduction
Thanks! There is already a troubleshooting section but of course only with those problems that occurred to me so far. I guess some quirks will certainly follow. If you know something worth mentioning, I will be happy to integrate any clean text delivery if you don't want to latex around ;-) Nevertheless it's still very much work in progress. BR. Sven Great work! A troubleshooting section with known issues could be great to have as well! Best, tortoisedoc ___ SailfishOS.org Devel mailing list
[SailfishDevel] Developing with SailfishOS - a short introduction
Hi there, first of all: this is far from complete and basically just a skeleton yet. Nevertheless I have started to write down a howto for SailfishOS development. Criticism, suggestions, bugfixes, contribution wanted! https://github.com/hardcodes/developwithsailfishos BR. Sven ___ SailfishOS.org Devel mailing list
Re: [SailfishDevel] Developing with SailfishOS - a short introduction
Hi Sven Github won't display the pdf, it's too big ... Looking forward to reading your idea; the more of us talking about Software Engineering the better! grüsse aus der Schweiz (mit Schnee) Chris Zitat von Sven Putze sailfish...@hardcodes.de: Hi there, first of all: this is far from complete and basically just a skeleton yet. Nevertheless I have started to write down a howto for SailfishOS development. Criticism, suggestions, bugfixes, contribution wanted! https://github.com/hardcodes/developwithsailfishos BR. Sven ___ SailfishOS.org Devel mailing list ___ SailfishOS.org Devel mailing list
Re: [SailfishDevel] Developing with SailfishOS - a short introduction
On 01/12/13 15:18, Sven Putze wrote: Hi there, first of all: this is far from complete and basically just a skeleton yet. Nevertheless I have started to write down a howto for SailfishOS development. Criticism, suggestions, bugfixes, contribution wanted! https://github.com/hardcodes/developwithsailfishos Hi Sven This is good stuff - thanks. May I make a suggestion though; please consider using something other than LaTeX as the master for the content. I like LaTeX a lot and in fact the pdf version of the User Guide http://jolla.com/guide/ is produced using LaTeX. However by compromising on layout control and using a simpler markup language we were able to make a nice HTML version *and* make it easy to translate as well as creating the LaTeX version. I actually used org-mode [1] as my markup because a) I know it and use emacs and b) it supports a per-publish-format options which let me tailor the LaTeX macros and CSS output; but in retrospect I think Markdown may have been a better choice Eg this is the original source for some of a chapter from http://jolla.com/guide/#text-3 and it shows a couple of per-output tweaks as well as some comment in the code :: * Lock, Home, Launcher and Events The way your Jolla uses the screen is different - there are no fixed buttons or status areas and the whole screen is available for your apps. #+ATTR_LATEX: :macro \includegraphics #+ATTR_HTML: :class float_img file:img/wf-homelock.png Jolla's main screen has three areas you get to by pulling up and down : they're called Lock, Home and Launcher. The Events screen lists all your notifications and you can access it from everywhere using a swipe gesture starting from the bottom. You arrive at Lock when you wake your Jolla (it's easy to recognise as it shows the time). From here you pull up to see Home (showing your running apps and four useful app icons). Pull up again to see the app icons for all your other apps. Keep pulling down to go back. When you click the power button, you see Lock, so let's start there. # This lets the big image above appear on the left of the page in the HTML and # stops the following headings from looking wrong #+begin_html br style=clear:both; / #+end_html ** Lock screen and icons Lock Apart from the clock, Lock shows if you've missed any calls, texts, emails and so on. It also tells you about updates and other notifications - it's generally an information screen with some useful shortcuts in the menu. So, what can you do here? Quite a bit : * Quickly see if there are any events and notifications. * If you Swipe up (not Pull up) the Events view will reveal more information about the notifications. * Pull up a little to check battery level and network status. * Pull down a little to see the date at the bottom of a Pulley menu. * Pull down more to quickly (un)silence the sounds, and get to the phone, camera or settings. * After you've chosen some favourite Ambiences, swiping from the side lets you pick a favourite Ambience, which changes your ringtones and sounds too. * Pull up more to get to Home. If you're using the [[Device lock][device lock]] to stop people seeing personal information on your device, your Jolla won't respond to some of these actions until you unlock it. To do that just pull up and you see the unlock screen where you can enter your unlock code. #+BEGIN_QUOTE * When you leave your Jolla on the Lock screen screen it goes back to sleep quite quickly. * If Swipe from the side doesn't work, then set some favourite Ambiences from your photos in Gallery. #+END_QUOTE (nb ... for various reasons someone decided to get the HTML 'fixed' by a web-shop so it's a bit broken :) - it looks much better straight out of the convertor) As you can see this will really lower the barrier to contributing to the document and to translating it. If you choose to use org-mode then let me know as I will be automating the batch processing of the content into HTML and pdf. David [1] http://orgmode.org ___ SailfishOS.org Devel mailing list
Re: [SailfishDevel] Developing with SailfishOS - a short introduction
Hi Sven Have now downloaded. Lots of good content, but I need to read through it a few more times to comment in detail. One thing that immediately occurs to me is: 2.3 Linux While it is not supported, an instalation of Sailfish within a Linux VM hosted on OSX works quite happily. It is some months since I did it (first sDK version), but I was able to install Lubuntu on VMWare Fusion hosted by OSX, and then install VirtualBox and the Sailfish SDK into that. The only problems I had could be replicated on a bare-metal install of Lubuntu. mfg Chris Zitat von Sven Putze sailfish...@hardcodes.de: Hi there, first of all: this is far from complete and basically just a skeleton yet. Nevertheless I have started to write down a howto for SailfishOS development. Criticism, suggestions, bugfixes, contribution wanted! https://github.com/hardcodes/developwithsailfishos BR. Sven ___ SailfishOS.org Devel mailing list ___ SailfishOS.org Devel mailing list
