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
