koreader/frontend/ui/quickstart.lua

--[[--This module is responsible for generating the quickstart guide.
]]
local DataStorage = require("datastorage")
local FileConverter = require("apps/filemanager/filemanagerconverter")
local Version = require("version")
local _ = require("gettext")
local lfs = require("libs/libkoreader-lfs")
local T = require("ffi/util").template

local QuickStart = {
    quickstart_force_show_version = 201511982,
}

local quickstart_shown_version = G_reader_settings:readSetting("quickstart_shown_version") or nil
local language = G_reader_settings:readSetting("language") or "en"
local version = Version:getNormalizedCurrentVersion()
local rev = Version:getCurrentRevision()

local quickstart_guide = T(_([[
# KOReader Quickstart Guide

Welcome to KOReader.

You can activate the menu by swiping down from the top of the screen. Clicking outside the menu or swiping up on the menu will discard it.

Turning pages can be done either by swiping left and right or by single taps on the left or right side of the screen.

### Contents

* [menu](#menu)
  * [main menu](#main-menu)
  * [settings](#settings)
* [file browser](#file-browser)


## Menu <a id="menu"></a>

### Main <a id="main-menu"></a>

![Menu](../resources/icons/menu-icon.png) You can always view this quickstart guide again through *Help* → *Quickstart guide* in the top right menu.

### Settings <a id="settings"></a>

![Settings](../resources/icons/appbar.settings.png) You can change the language and other settings through the gear icon.


## File browser <a id="file-browser"></a>

The file browser will only show document or ebook files that KOReader can read.

In the file browser, you can tap on any file to open it. Long press on any file to bring up a menu with more options. The location path display above the list of files and folders shows you which folder you're viewing. The `../` entry, at the top of the listed folders, lets you go *up* one level. For instance, if you are at `/mnt/onboard` now, tapping the `../` will bring you to `/mnt/`.

Once you have found the folder you have your books listed in, you can long press the selection that opens that folder and you should see a message box popup with the option to **Set as HOME directory**.


-------------
Generated by KOReader %1.
]]),
    rev)

--[[-- Returns `true` if shown, `false` if the quickstart guide hasn't been
shown yet or if display is forced through a higher version number than when
it was first shown.
]]
function QuickStart:isShown()
    if quickstart_shown_version == nil then return false end
    return (quickstart_shown_version >= self.quickstart_force_show_version)
end

--[[--Generates the quickstart guide in the user's language and returns its location.

The fileformat is `quickstart-en-v2015.11-985-g88308992.html`, `en` being the
language of the generated file and `v2015.11-985-g88308992` the KOReader version
used to generate the file.

@treturn string path to generated HTML quickstart guide
]]
function QuickStart:getQuickStart()
    local quickstart_dir = ("%s/help"):format(DataStorage:getDataDir())
    local quickstart_filename = ("%s/quickstart-%s-%s.html"):format(quickstart_dir, language, rev)
    if lfs.attributes(quickstart_dir, "mode") ~= "dir" then
        lfs.mkdir(quickstart_dir)
    end
    if lfs.attributes(quickstart_filename, "mode") ~= "file" then
        local quickstart_html = FileConverter:mdToHtml(quickstart_guide, _("KOReader Quickstart Guide"))
        if quickstart_html then
            FileConverter:writeStringToFile(quickstart_html, quickstart_filename)
        end
    end
    G_reader_settings:saveSetting("quickstart_shown_version", version)
    return quickstart_filename
end

return QuickStart