README.rst
author Oleksandr Gavenko <gavenkoa@gmail.com>
Mon, 16 Sep 2019 22:13:19 +0300
changeset 2376 20b65f046002
parent 2049 27dcfffe49d5
permissions -rw-r--r--
Revoke privileges and drop role.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1334
9bf0d5a1f0cf Include common header with quick links.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1247
diff changeset
     1
.. -*- coding: utf-8; -*-
1247
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     2
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     3
================
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     4
 gavenkoa tips.
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     5
================
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     6
.. contents::
1905
fba288d59662 Include only local subsections into TOC. This prevent duplication of
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1896
diff changeset
     7
   :local:
1247
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     8
1337
2bd47e0a87fa Add About and Licence statements.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1334
diff changeset
     9
About tips.
2bd47e0a87fa Add About and Licence statements.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1334
diff changeset
    10
===========
2bd47e0a87fa Add About and Licence statements.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1334
diff changeset
    11
1787
274aa5f80036 Referencing to defun site.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1642
diff changeset
    12
This site is a collection of tips that author (`Oleksandr Gavenko`_ AKA
274aa5f80036 Referencing to defun site.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1642
diff changeset
    13
gavenkoa_) was created during his life.
1337
2bd47e0a87fa Add About and Licence statements.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1334
diff changeset
    14
1912
8b81a8f0f692 Remove HEADER.rst because that info now added to HTML template.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1905
diff changeset
    15
.. _`Oleksandr Gavenko`: http://resume.defun.work/
8b81a8f0f692 Remove HEADER.rst because that info now added to HTML template.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1905
diff changeset
    16
.. _`gavenkoa`: http://resume.defun.work/
8b81a8f0f692 Remove HEADER.rst because that info now added to HTML template.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1905
diff changeset
    17
1337
2bd47e0a87fa Add About and Licence statements.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1334
diff changeset
    18
Tips licence.
2bd47e0a87fa Add About and Licence statements.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1334
diff changeset
    19
=============
2bd47e0a87fa Add About and Licence statements.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1334
diff changeset
    20
2049
27dcfffe49d5 Fix grammar.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2011
diff changeset
    21
You can do **anything** with these tips. Author doesn't provide warranty for any
27dcfffe49d5 Fix grammar.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2011
diff changeset
    22
possible harm imposed by using these tips.
1337
2bd47e0a87fa Add About and Licence statements.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1334
diff changeset
    23
1896
c2448e4e25f4 Use special markup to warn about international copyright law.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    24
In countries where defined *public domain* you may assume that it is.
1337
2bd47e0a87fa Add About and Licence statements.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1334
diff changeset
    25
1896
c2448e4e25f4 Use special markup to warn about international copyright law.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    26
.. WARNING::
1337
2bd47e0a87fa Add About and Licence statements.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1334
diff changeset
    27
1896
c2448e4e25f4 Use special markup to warn about international copyright law.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    28
   Internetional copyright low (Berne Convention for the Protection of Literary
c2448e4e25f4 Use special markup to warn about international copyright law.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    29
   and Artistic Works, Article 6bis) preserve some non-property (moral) rights
c2448e4e25f4 Use special markup to warn about international copyright law.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    30
   for authors like:
1337
2bd47e0a87fa Add About and Licence statements.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1334
diff changeset
    31
1896
c2448e4e25f4 Use special markup to warn about international copyright law.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    32
   * author shall have the right to claim authorship of the work
c2448e4e25f4 Use special markup to warn about international copyright law.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    33
   * author shall have the right to object to any distortion, mutilation or
c2448e4e25f4 Use special markup to warn about international copyright law.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    34
     other modification of, or other derogatory action in relation to, the said
c2448e4e25f4 Use special markup to warn about international copyright law.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    35
     work, which would be prejudicial to his honor or reputation
c2448e4e25f4 Use special markup to warn about international copyright law.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    36
c2448e4e25f4 Use special markup to warn about international copyright law.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    37
   You are warned!
1247
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    38
1339
04633ffa1cac Make CHM version from sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1337
diff changeset
    39
Make HTML version from sources.
04633ffa1cac Make CHM version from sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1337
diff changeset
    40
===============================
1247
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    41
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    42
Install docutils package::
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    43
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    44
  $ sudo apt-get install docutils-common   # for Debian
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    45
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    46
and build::
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    47
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    48
  $ make html
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    49
  $ sensible-browser tips-html/index.html
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    50
1642
ae7bc658a208 Check sources at.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1339
diff changeset
    51
Check sources at::
ae7bc658a208 Check sources at.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1339
diff changeset
    52
1843
8ad4fe7443f2 Point to defun.work to grab sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1787
diff changeset
    53
  $ hg clone http://hg.defun.work/tips
8ad4fe7443f2 Point to defun.work to grab sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1787
diff changeset
    54
8ad4fe7443f2 Point to defun.work to grab sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1787
diff changeset
    55
or::
1642
ae7bc658a208 Check sources at.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1339
diff changeset
    56
1843
8ad4fe7443f2 Point to defun.work to grab sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1787
diff changeset
    57
  $ hg clone http://hg.code.sf.net/u/gavenkoa/tips
8ad4fe7443f2 Point to defun.work to grab sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1787
diff changeset
    58
8ad4fe7443f2 Point to defun.work to grab sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1787
diff changeset
    59
or browser online at http://hg.defun.work/tips
1642
ae7bc658a208 Check sources at.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1339
diff changeset
    60
1339
04633ffa1cac Make CHM version from sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1337
diff changeset
    61
Make CHM version from sources.
04633ffa1cac Make CHM version from sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1337
diff changeset
    62
==============================
1247
cc97907e3123 Make HTML version.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    63
1339
04633ffa1cac Make CHM version from sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1337
diff changeset
    64
Install docutils package::
04633ffa1cac Make CHM version from sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1337
diff changeset
    65
04633ffa1cac Make CHM version from sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1337
diff changeset
    66
  $ sudo apt-get install docutils-common   # for Debian
04633ffa1cac Make CHM version from sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1337
diff changeset
    67
04633ffa1cac Make CHM version from sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1337
diff changeset
    68
and build::
04633ffa1cac Make CHM version from sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1337
diff changeset
    69
04633ffa1cac Make CHM version from sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1337
diff changeset
    70
  $ make html
04633ffa1cac Make CHM version from sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1337
diff changeset
    71
04633ffa1cac Make CHM version from sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1337
diff changeset
    72
Enter to ``tips-html`` directory and compile with ``Microsoft's HTML Help SDK``.
04633ffa1cac Make CHM version from sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1337
diff changeset
    73
Under Linux you can use ``Wine`` to run Windows binary.
04633ffa1cac Make CHM version from sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1337
diff changeset
    74