diff options
author | Nicolas LÅ“uillet <nicolas@loeuillet.org> | 2016-01-09 17:33:27 +0100 |
---|---|---|
committer | Nicolas LÅ“uillet <nicolas@loeuillet.org> | 2016-01-09 17:33:27 +0100 |
commit | 5ad863c63a023d754998a08ec55f43b3ebe2ede9 (patch) | |
tree | 66172b7256e757e3e5254e243d41df45a7490c57 /docs/en/Developer | |
parent | 1caf557de797a662906779b348759e2937255812 (diff) | |
parent | a42938f42caf91a602617ef4354d17e1bc3f3629 (diff) | |
download | wallabag-5ad863c63a023d754998a08ec55f43b3ebe2ede9.tar.gz wallabag-5ad863c63a023d754998a08ec55f43b3ebe2ede9.tar.zst wallabag-5ad863c63a023d754998a08ec55f43b3ebe2ede9.zip |
Merge pull request #1558 from wallabag/v2-documentation
[v2] documentation cleaning
Diffstat (limited to 'docs/en/Developer')
-rw-r--r-- | docs/en/Developer/create_new_theme.rst | 4 | ||||
-rw-r--r-- | docs/en/Developer/git_repo.rst | 29 | ||||
-rw-r--r-- | docs/en/Developer/write_config_files.rst | 52 |
3 files changed, 0 insertions, 85 deletions
diff --git a/docs/en/Developer/create_new_theme.rst b/docs/en/Developer/create_new_theme.rst deleted file mode 100644 index 5731eb11..00000000 --- a/docs/en/Developer/create_new_theme.rst +++ /dev/null | |||
@@ -1,4 +0,0 @@ | |||
1 | Create new theme | ||
2 | ================ | ||
3 | |||
4 | TODO | ||
diff --git a/docs/en/Developer/git_repo.rst b/docs/en/Developer/git_repo.rst deleted file mode 100644 index 4fa5c608..00000000 --- a/docs/en/Developer/git_repo.rst +++ /dev/null | |||
@@ -1,29 +0,0 @@ | |||
1 | Git repository | ||
2 | ============== | ||
3 | |||
4 | If you wish to contribute to the project by suggesting new features or | ||
5 | by fixing some bugs, please follow the recommendations below regarding | ||
6 | the git repository available at https://github.com/wallabag/wallabag. | ||
7 | |||
8 | Current state | ||
9 | ------------- | ||
10 | |||
11 | To manage the different versions of wallabag, we use Git. | ||
12 | |||
13 | There are multiple branches for the source code of wallabag web app: | ||
14 | |||
15 | - ``master`` branch : this is the stable branch, downloaded by those | ||
16 | who wish to install wallabag for their own use. | ||
17 | - ``dev`` branch : before being added on ``master`` branch, all bug | ||
18 | fixes and new features must go on that branch. This branch is not | ||
19 | recommended for production use. | ||
20 | - ``v2`` branch : this is the branch for a revamp of wallabag. | ||
21 | A whole chapter is to be focused on it. | ||
22 | |||
23 | Workflow | ||
24 | -------- | ||
25 | |||
26 | All the rules for contributing to the git repository are in the | ||
27 | `CONTRIBUTING.md file of | ||
28 | wallabag <https://github.com/wallabag/wallabag/blob/master/CONTRIBUTING.md>`__. | ||
29 | Please read carefully this file before you make any change. | ||
diff --git a/docs/en/Developer/write_config_files.rst b/docs/en/Developer/write_config_files.rst deleted file mode 100644 index c1ea61df..00000000 --- a/docs/en/Developer/write_config_files.rst +++ /dev/null | |||
@@ -1,52 +0,0 @@ | |||
1 | Write config files | ||
2 | ================== | ||
3 | |||
4 | wallabag can use specific site config files to parse website articles. | ||
5 | These files are stored in the | ||
6 | ```inc/3rdparty/site_config/standard`` <https://github.com/wallabag/wallabag/tree/master/inc/3rdparty/site_config/standard>`__ | ||
7 | folder. | ||
8 | |||
9 | The format used for these files is | ||
10 | `XPath <http://www.w3.org/TR/xpath20/>`__. Look at some examples in the | ||
11 | folder. | ||
12 | |||
13 | Automatic config files generation | ||
14 | --------------------------------- | ||
15 | |||
16 | Fivefilters has created a `very useful | ||
17 | tool <http://siteconfig.fivefilters.org/>`__ to create config files. You | ||
18 | just type in the adress of the article to work on with, and you select | ||
19 | the area containing the content you want. | ||
20 | |||
21 | .. figure:: https://lut.im/RNaO7gGe/l9vRnO1b | ||
22 | :alt: siteconfig | ||
23 | |||
24 | siteconfig | ||
25 | | You should confirm this area by trying with other articles. | ||
26 | | When you got the right area, just click on *Download Full-Text RSS | ||
27 | site config* to download your file. | ||
28 | |||
29 | Manual config file generation | ||
30 | ----------------------------- | ||
31 | |||
32 | If Fivefilters tool doesn't work correctly, take a look at the source | ||
33 | (Ctrl + U on Firefox and Chromium). Search for your content and get the | ||
34 | ``class`` or the ``id`` attribute of the area containing what you want. | ||
35 | |||
36 | Once you've got the id or class, you can write for example one or | ||
37 | another of these lines: | ||
38 | |||
39 | :: | ||
40 | |||
41 | body: //div[@class='myclass'] | ||
42 | body: //div[@id='myid'] | ||
43 | |||
44 | Then, test you file. If you got the right content but you want to strip | ||
45 | unnecessary parts, do: | ||
46 | |||
47 | :: | ||
48 | |||
49 | strip: //div[@class='hidden'] | ||
50 | |||
51 | You can look at other options for siteconfig files | ||
52 | `here <http://help.fivefilters.org/customer/portal/articles/223153-site-patterns>`__. | ||