[SailfishDevel] Developing with SailfishOS - a short introduction

Sven Putze sailfish.os at hardcodes.de
Sun Dec 1 20:00:53 UTC 2013


MultiMarkDown seems promising as it does not require Emacs, but I am not sure yet.

BR.
Sven
On 01.12.2013, at 20:41, Sven Putze <sailfish.os at hardcodes.de> wrote:

> Hi David,
> 
> there are no religious feelings about LaTeX from my side, so I will sleep over using another markup language :-)
> I definitely could use some input about merssh and the remote build process!
> 
> Thanks!
> BR.
> Sven
> 
> On 01.12.2013, at 20:07, David Greaves <david.greaves at jolla.com> wrote:
> 
>> 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
>> 
> 



More information about the Devel mailing list