Mercurial > libervia-backend
annotate doc/libervia-cli/blog.rst @ 4177:0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Tue, 05 Dec 2023 13:14:55 +0100 |
| parents | 6929dabf3a7e |
| children | cf0ea77f9537 |
| rev | line source |
|---|---|
| 2946 | 1 .. highlight:: sh |
| 2 | |
| 3 ================================ | |
| 4 blog: (micro)blogging management | |
| 5 ================================ | |
| 6 | |
| 7 Blog commands are high level tools to handle an XMPP blog. | |
| 8 They are using the generic pubsub arguments | |
| 9 | |
|
4174
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
10 |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
11 .. _libervia_cli_blog_common_pub: |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
12 |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
13 Common Publishing Options |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
14 ========================= |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
15 |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
16 The `set` and `edit` commands support a range of options for customizing blog post creation and editing. Some notable options include: |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
17 |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
18 ``--no-id-suffix`` |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
19 |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
20 This option removes the randomly generated suffix from the auto-generated, user-friendly ID. The suffix is initially added to ensure unique IDs, especially useful when two posts have similar titles. Use this option with caution, as it may lead to ID conflicts and potential overwriting of existing posts. |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
21 |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
22 .. warning:: |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
23 |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
24 Use this option judiciously to avoid unintended overwriting of blog posts. |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
25 |
|
4177
0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
Goffi <goffi@goffi.org>
parents:
4174
diff
changeset
|
26 ``--alt-link URL [MEDIA_TYPE]`` |
|
0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
Goffi <goffi@goffi.org>
parents:
4174
diff
changeset
|
27 |
|
0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
Goffi <goffi@goffi.org>
parents:
4174
diff
changeset
|
28 Add an alternative link to a blog post, such as a corresponding HTTP page. The *URL* |
|
0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
Goffi <goffi@goffi.org>
parents:
4174
diff
changeset
|
29 parameter is mandatory, while *MEDIA_TYPE* is optional. Incorporate ``{service}``, |
|
0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
Goffi <goffi@goffi.org>
parents:
4174
diff
changeset
|
30 ``{node}``, and ``{item}`` as template values within the URL. These will be replaced |
|
0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
Goffi <goffi@goffi.org>
parents:
4174
diff
changeset
|
31 with the actual values when the item is published. To use curly braces literally, |
|
0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
Goffi <goffi@goffi.org>
parents:
4174
diff
changeset
|
32 double them: ``{{`` and ``}}``. |
|
0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
Goffi <goffi@goffi.org>
parents:
4174
diff
changeset
|
33 |
|
0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
Goffi <goffi@goffi.org>
parents:
4174
diff
changeset
|
34 example |
|
0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
Goffi <goffi@goffi.org>
parents:
4174
diff
changeset
|
35 ------- |
|
0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
Goffi <goffi@goffi.org>
parents:
4174
diff
changeset
|
36 |
|
0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
Goffi <goffi@goffi.org>
parents:
4174
diff
changeset
|
37 Louise wants to add a link to her public facing HTML blog in her item:: |
|
0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
Goffi <goffi@goffi.org>
parents:
4174
diff
changeset
|
38 |
|
0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
Goffi <goffi@goffi.org>
parents:
4174
diff
changeset
|
39 $ li blog set --alt-link https://example.org/blog/{node}/{item} |
|
0f1a4ffcd419
doc (cli/blog): Document new `--alt-link` option
Goffi <goffi@goffi.org>
parents:
4174
diff
changeset
|
40 |
| 2946 | 41 set |
| 42 === | |
| 43 | |
| 44 publish a blog item. | |
| 45 | |
| 46 :ref:`pubsub_common` commands are used to specify the destination item. | |
| 47 | |
| 48 ``stdin`` is used to get the body of the blog post. | |
| 49 | |
|
4174
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
50 Also see :ref:`libervia_cli_blog_common_pub`. |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
51 |
|
3951
4b8776eb6826
doc (blog, pubsub): documentation on new e2ee arguments for pubsub, and shared secrets handling:
Goffi <goffi@goffi.org>
parents:
3873
diff
changeset
|
52 |e2e_arg| |
|
4b8776eb6826
doc (blog, pubsub): documentation on new e2ee arguments for pubsub, and shared secrets handling:
Goffi <goffi@goffi.org>
parents:
3873
diff
changeset
|
53 |
|
3975
c4418949aa37
doc (encryption, cli): document Pubsub Targeted Encryption:
Goffi <goffi@goffi.org>
parents:
3966
diff
changeset
|
54 |pte_arg| |
|
c4418949aa37
doc (encryption, cli): document Pubsub Targeted Encryption:
Goffi <goffi@goffi.org>
parents:
3966
diff
changeset
|
55 |
|
3966
9f85369294f3
doc (encryption, cli): pubsub signing documentation:
Goffi <goffi@goffi.org>
parents:
3951
diff
changeset
|
56 |sign_arg| |
|
9f85369294f3
doc (encryption, cli): pubsub signing documentation:
Goffi <goffi@goffi.org>
parents:
3951
diff
changeset
|
57 |
| 2946 | 58 examples |
| 59 -------- | |
| 60 | |
| 61 Create a blog post with a body, a subject, 2 tags, and with comments allowed:: | |
| 62 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
63 $ echo "This is post body" | li blog set -T "This is a test message" -t test -t li -C |
| 2946 | 64 |
| 65 Create a blog post with rich content using `markdown` syntax, and no subject:: | |
| 66 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
67 $ echo "This is a **rich** body" | li blog set -S markdown |
| 2946 | 68 |
| 69 get | |
| 70 === | |
| 71 | |
|
2954
5e72efd2f95d
doc: minor fixes + use ".pot" extension instead of ".po" for template in README4TRANSLATORS
Goffi <goffi@goffi.org>
parents:
2946
diff
changeset
|
72 get command retrieves one or more blog post(s) from specified location (by default the |
| 2946 | 73 personal blog of the profile). |
| 74 | |
|
3021
8ec35cf13f66
doc: added, overview, configuration and Primitivus documentation + some small modifications
Goffi <goffi@goffi.org>
parents:
2999
diff
changeset
|
75 output can be customised to only retrieve some keys, or to use a specific template. For |
|
8ec35cf13f66
doc: added, overview, configuration and Primitivus documentation + some small modifications
Goffi <goffi@goffi.org>
parents:
2999
diff
changeset
|
76 instance, the following command retrieves only the title and publication date of the |
|
8ec35cf13f66
doc: added, overview, configuration and Primitivus documentation + some small modifications
Goffi <goffi@goffi.org>
parents:
2999
diff
changeset
|
77 personal blog of the profile:: |
|
8ec35cf13f66
doc: added, overview, configuration and Primitivus documentation + some small modifications
Goffi <goffi@goffi.org>
parents:
2999
diff
changeset
|
78 |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
79 $ li blog get -k title -k published |
| 2946 | 80 |
| 81 :ref:`pubsub_common` commands are used to specify the blog location. | |
| 82 | |
| 83 examples | |
| 84 -------- | |
| 85 | |
| 86 Retrieve personal blog of the profile using `fancy` output with a verbosity of 1 (to show | |
| 87 publication date):: | |
| 88 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
89 $ li blog get -O fancy -v |
| 2946 | 90 |
| 91 Retrieve *title* and *publication date* of last 3 blog posts from the blog at | |
| 92 https://www.goffi.org:: | |
| 93 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
94 $ li blog get -m 3 -u https://www.goffi.org -k title -k published |
| 2946 | 95 |
| 96 Retrieve last 2 posts of personal blog, and output them in browser using default | |
| 97 template:: | |
| 98 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
99 $ li blog get -m 2 -O template --oo browser |
| 2946 | 100 |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
101 .. _libervia-cli_blog_edit: |
|
3041
72583524cfd3
doc (jp): jp commands are now fully documented:
Goffi <goffi@goffi.org>
parents:
3021
diff
changeset
|
102 |
| 2946 | 103 edit |
| 104 ==== | |
| 105 | |
| 106 With edit command you can create a new blog post or modify an existing one using your | |
| 107 local editor (the one set in ``$EDITOR``). You'll edit 2 things: the body of the post, and | |
| 108 the metadata which contain things like title, comments infos, or tags. | |
| 109 | |
| 110 For some common editors (like **vim** or **Emacs**), the editor will be automatially | |
| 111 opened using a split screen with *body* in one side, and metadata on the other. If the | |
| 112 editor is not supported or doesn't support split screen, you'll edit first the *body*, then | |
|
3536
0985c47ffd96
doc: config file is now `libervia.conf` (even if `sat.conf` still works, for now)
Goffi <goffi@goffi.org>
parents:
3488
diff
changeset
|
113 the *metadata*. You can also specify editor and arguments in ``libervia.conf``, see |
| 2946 | 114 `configuration <edit_conf_>`_ below |
| 115 | |
| 116 If you don't change anything or publish an empty blog post, the edition will be cancelled. | |
| 117 | |
|
3177
f4914ce9d47d
jp (blog/edit): added `--no-publish` argument.
Goffi <goffi@goffi.org>
parents:
3041
diff
changeset
|
118 In the metadata (see `below <edit_metadata_>`_ for details), you can use ``"publish": |
|
f4914ce9d47d
jp (blog/edit): added `--no-publish` argument.
Goffi <goffi@goffi.org>
parents:
3041
diff
changeset
|
119 false`` to forbid the publication (or set it with ``--no-publish argument``). In this |
|
f4914ce9d47d
jp (blog/edit): added `--no-publish` argument.
Goffi <goffi@goffi.org>
parents:
3041
diff
changeset
|
120 case, when you'll save your modification and quit your editor, the blog post will not be |
|
f4914ce9d47d
jp (blog/edit): added `--no-publish` argument.
Goffi <goffi@goffi.org>
parents:
3041
diff
changeset
|
121 published but saved locally in a draft. To continue your work later, just start your |
|
f4914ce9d47d
jp (blog/edit): added `--no-publish` argument.
Goffi <goffi@goffi.org>
parents:
3041
diff
changeset
|
122 edition with the ``-D, --current`` option like this:: |
| 2946 | 123 |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
124 $ li blog edit -D |
| 2946 | 125 |
| 126 Note that item location must be re-specified if it has been used to create the draft, so | |
| 127 you'll have to reproduce the arguments to specify service, node or item (or the URL), | |
| 128 other data like tags will be restored from draft file of metadata. | |
| 129 | |
| 130 You can specify the syntax by using ``-S SYNTAX, --syntax SYNTAX``. If not specified, the | |
| 131 syntax set in your parameters will be used. | |
| 132 | |
| 133 When you edit a blog post, it is often useful to activate the ``-P, --preview`` option, | |
| 134 this will launch a web browser and refresh the page each time you save a modification in | |
| 135 your editor. By default, the browser registered as default in your system will be used, | |
| 136 and a new tab will be opened on each modification. This is not ideal, and we recommand to | |
| 137 set you configuration to activate automatic refreshing of the page instead, see `preview | |
| 138 configuration <edit_preview_>`_ below to see how to do. | |
| 139 | |
|
2999
85d8e9a7284b
doc (jp/blog): added note for --preview
Goffi <goffi@goffi.org>
parents:
2996
diff
changeset
|
140 .. note:: |
|
85d8e9a7284b
doc (jp/blog): added note for --preview
Goffi <goffi@goffi.org>
parents:
2996
diff
changeset
|
141 |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
142 If --preview doesn't work, use ``li blog preview`` (see below) to get error messages. |
|
2999
85d8e9a7284b
doc (jp/blog): added note for --preview
Goffi <goffi@goffi.org>
parents:
2996
diff
changeset
|
143 On GNU/Linux, Be sure that inotify Python module is installed correctly. |
|
85d8e9a7284b
doc (jp/blog): added note for --preview
Goffi <goffi@goffi.org>
parents:
2996
diff
changeset
|
144 |
|
4174
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
145 Also see :ref:`libervia_cli_blog_common_pub`. |
|
6929dabf3a7e
doc (cli/blog): documentation of the new `--no-id-suffix` option.
Goffi <goffi@goffi.org>
parents:
4037
diff
changeset
|
146 |
|
3951
4b8776eb6826
doc (blog, pubsub): documentation on new e2ee arguments for pubsub, and shared secrets handling:
Goffi <goffi@goffi.org>
parents:
3873
diff
changeset
|
147 |e2e_arg| |
|
4b8776eb6826
doc (blog, pubsub): documentation on new e2ee arguments for pubsub, and shared secrets handling:
Goffi <goffi@goffi.org>
parents:
3873
diff
changeset
|
148 |
|
3975
c4418949aa37
doc (encryption, cli): document Pubsub Targeted Encryption:
Goffi <goffi@goffi.org>
parents:
3966
diff
changeset
|
149 |pte_arg| |
|
c4418949aa37
doc (encryption, cli): document Pubsub Targeted Encryption:
Goffi <goffi@goffi.org>
parents:
3966
diff
changeset
|
150 |
|
3966
9f85369294f3
doc (encryption, cli): pubsub signing documentation:
Goffi <goffi@goffi.org>
parents:
3951
diff
changeset
|
151 |sign_arg| |
|
9f85369294f3
doc (encryption, cli): pubsub signing documentation:
Goffi <goffi@goffi.org>
parents:
3951
diff
changeset
|
152 |
| 2946 | 153 examples |
| 154 -------- | |
| 155 | |
| 156 Edit a new blog post with comments on your personal blog, using default syntax and preview:: | |
| 157 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
158 $ li blog edit -P --comments |
| 2946 | 159 |
| 160 Modifiy a draft previously saved using the ``"publish": false`` metadata:: | |
| 161 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
162 $ li blog edit -D |
| 2946 | 163 |
| 164 Correct a typo in your last published blog post:: | |
| 165 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
166 $ li blog edit --last-item |
| 2946 | 167 |
| 168 Edit the blog item at an HTTPS URL using XHTML syntax:: | |
| 169 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
170 $ li blog edit -u https://www.example.net/some_xmpp_blog_article.html -S xhtml |
| 2946 | 171 |
| 172 Create a new blog post on a XMPP blog node using its HTTPS URL (supposing here that | |
| 173 https://example.net is a XMPP blog node):: | |
| 174 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
175 $ li blog edit -u https://www.example.net |
| 2946 | 176 |
| 177 .. _edit_metadata: | |
| 178 | |
| 179 metadata | |
| 180 -------- | |
| 181 | |
| 182 Metadata is set using a JSON object. The key you can use are: | |
| 183 | |
| 184 publish | |
| 185 boolean indicating if item can be published. Set to ``false`` if you want to work on a | |
| 186 draft and to avoid accidental publication. | |
| 187 | |
| 188 atom_id | |
| 189 atom entry identifier. This should not be modified manually. | |
| 190 | |
| 191 published | |
| 192 time of initial publication (unix time). This should not be modified manually. | |
| 193 | |
| 194 language | |
| 195 language of the content | |
| 196 | |
| 197 comments | |
| 198 array of URIs to the comments node, if any. | |
| 199 | |
| 200 tag | |
| 201 array of tags, if any | |
| 202 | |
| 203 author | |
| 204 human readable name of the entry author | |
| 205 | |
| 206 author_jid | |
| 207 jid of the author. This should notbe modified manually. | |
| 208 | |
| 209 author_jid_verified | |
| 210 true if the pubsub service confirmed that author_jid is the one of the publisher. It is | |
| 211 useless to modify this variable. | |
| 212 | |
| 213 title | |
| 214 the title of the message | |
| 215 | |
| 216 title_rich | |
| 217 the rich title of the message, in current text syntax. It will be automatically | |
| 218 converted to xhtml. | |
| 219 | |
| 220 .. _edit_conf: | |
| 221 | |
| 222 configuration | |
| 223 ------------- | |
| 224 | |
| 225 editor | |
| 226 ^^^^^^ | |
| 227 | |
| 228 Local editor used is by default the one set in ``$EDITOR`` environment variable, but you | |
|
3536
0985c47ffd96
doc: config file is now `libervia.conf` (even if `sat.conf` still works, for now)
Goffi <goffi@goffi.org>
parents:
3488
diff
changeset
|
229 can specify one in ``libervia.conf``. To do so, you have to set the name of an editor |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
230 executable in the ``editor`` option in ``[li]`` section. |
| 2946 | 231 |
| 232 You can specify the args to use by using ``blog_editor_args`` option. Use | |
| 233 ``{content_file}`` to get the path of the main content file (the body of the blog post), | |
| 234 and ``{metadata_file}`` to get the path of the json metadata. | |
| 235 | |
| 236 .. sourcecode:: cfg | |
| 237 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
238 [li] |
| 2946 | 239 editor = kate |
| 240 blog_editor_args = {content_file} {metadata_file} | |
| 241 | |
| 242 .. _edit_preview: | |
| 243 | |
| 244 preview | |
| 245 ^^^^^^^ | |
| 246 | |
| 247 To set the preview, you can use the options ``blog_preview_open_cmd`` and | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
248 ``blog_preview_update_cmd`` in your ``[li]`` section. the former is the command to use to |
| 2946 | 249 open your browser when edition starts, and the later is the command to use when a |
| 250 modification is saved. In both cases you may use ``{url}`` to set the location of local HTML file. | |
| 251 | |
|
2954
5e72efd2f95d
doc: minor fixes + use ".pot" extension instead of ".po" for template in README4TRANSLATORS
Goffi <goffi@goffi.org>
parents:
2946
diff
changeset
|
252 This can be used to activate automatic refreshing of the page. |
| 2946 | 253 |
| 254 For **Konqueror**, you can use its D-Bus API to do refreshing. Ensure that ``qdbus`` is | |
|
3536
0985c47ffd96
doc: config file is now `libervia.conf` (even if `sat.conf` still works, for now)
Goffi <goffi@goffi.org>
parents:
3488
diff
changeset
|
255 installed on your system, and enter the following lines in your ``libervia.conf``: |
| 2946 | 256 |
| 257 .. sourcecode:: cfg | |
| 258 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
259 [li] |
| 2946 | 260 blog_preview_open_cmd = konqueror {url} |
| 261 blog_preview_update_cmd = /bin/sh -c "qdbus $(qdbus org.kde.konqueror\*) /konqueror/MainWindow_1 reload" | |
| 262 | |
| 263 For **Firefox**, you may use ``xdotool`` on X11. Once you have installed this tool, enter the | |
|
3536
0985c47ffd96
doc: config file is now `libervia.conf` (even if `sat.conf` still works, for now)
Goffi <goffi@goffi.org>
parents:
3488
diff
changeset
|
264 following lines in your ``libervia.conf``: |
| 2946 | 265 |
| 266 .. sourcecode:: cfg | |
| 267 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
268 [li] |
| 2946 | 269 blog_preview_open_cmd = firefox -new-tab {url} |
| 270 blog_preview_update_cmd = /bin/sh -c "WID=$(xdotool search --name 'Mozilla Firefox' | head -1); xdotool windowactivate $WID; xdotool key F5" | |
| 271 | |
| 272 This *xdotool* technique can be adapted to other browsers. | |
| 273 | |
| 274 syntax extensions | |
| 275 ^^^^^^^^^^^^^^^^^^ | |
| 276 | |
| 277 A dictionary with a mapping from syntax name to file extension can be used. This can be | |
| 278 useful to activate the right syntax highlighting in your editor. There is a default | |
| 279 mapping which can be overriden. | |
| 280 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
281 The mapping is set in the ``syntax_ext_dict`` option of the ``[li]`` section of your |
|
3536
0985c47ffd96
doc: config file is now `libervia.conf` (even if `sat.conf` still works, for now)
Goffi <goffi@goffi.org>
parents:
3488
diff
changeset
|
282 ``libervia.conf`` file. For instance, if your prefer do your ``.markdown`` for temp files |
| 2946 | 283 instead of the default ``.md``, you can use this: |
| 284 | |
| 285 .. sourcecode:: cfg | |
| 286 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
287 [li] |
| 2946 | 288 syntax_ext_dict = {"markdown": "markdown"} |
| 289 | |
|
2954
5e72efd2f95d
doc: minor fixes + use ".pot" extension instead of ".po" for template in README4TRANSLATORS
Goffi <goffi@goffi.org>
parents:
2946
diff
changeset
|
290 the first ``markdown`` is the name of the syntax (could be an other syntax like ``xhtml``), |
| 2946 | 291 while the second if the file extension. |
| 292 | |
|
3563
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
293 rename |
|
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
294 ====== |
|
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
295 |
|
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
296 Move a item to a new ID. This works the same as :ref:`li-pubsub_rename`, the only |
|
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
297 difference is that node defaults to microblog default namespace. |
|
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
298 |
|
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
299 example |
|
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
300 ------- |
|
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
301 |
|
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
302 After a typo, a use want to rename the blog item with ID ``my_great_tittle_123a`` to |
|
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
303 ``my_great_title_123a``:: |
|
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
304 |
|
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
305 $ li blog rename -i my_great_tittle_123a my_great_title_123a |
|
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
306 |
|
3872
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
307 repeat |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
308 ====== |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
309 |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
310 Re-publish a blog item on profile's blog. |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
311 |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
312 This is similar to may be called in other networks "share" or "boot", the goal is mainly |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
313 to send this post of interest to our subscribers to make it more visible. |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
314 |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
315 It only needs arguments to get item to repeat location. |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
316 |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
317 example |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
318 ------- |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
319 |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
320 Pierre wants to repeat a blog post from Louise to make it more visible:: |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
321 |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
322 $ li blog repeat -s louise@example.org -n urn:xmpp:microblog:0 -i culture-new-caledonia-456f |
|
76fb0739cc9c
doc (cli/blog): `repeat` documentation:
Goffi <goffi@goffi.org>
parents:
3563
diff
changeset
|
323 |
| 2946 | 324 preview |
| 325 ======= | |
| 326 | |
| 327 This command will show the specified file in browser, and refresh it when changes are | |
|
2954
5e72efd2f95d
doc: minor fixes + use ".pot" extension instead of ".po" for template in README4TRANSLATORS
Goffi <goffi@goffi.org>
parents:
2946
diff
changeset
|
328 detected. Configuration is the same as for `edit preview <edit_preview_>`_. This can be |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
329 used if you have already started an edition with ``li blog edit`` but forgot to use the ``-P, --preview`` arguments. |
| 2946 | 330 |
|
3563
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
331 example |
|
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
332 ------- |
| 2946 | 333 |
|
3563
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
334 Preview the draft at ``~/.local/share/libervia/blog/some_name/blog_something.md``:: |
| 2946 | 335 |
|
3563
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
336 $ li blog preview ~/.local/share/libervia/blog/some_name/blog_something.md |
| 2946 | 337 |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
338 .. _libervia-cli_blog_import: |
|
3041
72583524cfd3
doc (jp): jp commands are now fully documented:
Goffi <goffi@goffi.org>
parents:
3021
diff
changeset
|
339 |
| 2946 | 340 import |
| 341 ====== | |
| 342 | |
| 343 With this command you can import an external blog in a XMPP blog at the specified pubsub | |
| 344 location. | |
| 345 | |
| 346 The import is done using an *importer* name and a *location* which depends of the importer | |
| 2996 | 347 (it can be a path to a file, an URL to a blog, or something else). Let empty to get list |
| 348 of importers, and specify only importer name to get its description. | |
| 2946 | 349 |
| 350 By default, found images are re-uploaded to XMPP server, if you want to keep original | |
| 351 URLs, use the ``--no-images-upload`` option. | |
| 352 | |
| 353 Alternatively, you can re-upload images except for a specific host with ``--upload-ignore-host UPLOAD_IGNORE_HOST``. The images for the specified host will keep there original URLs while other will be uploaded to XMPP server. | |
| 354 | |
| 355 You shoud specify original blog host using ``--host HOST`` argument, this is used notably | |
| 356 to reconstruct relative URLs of media. | |
| 357 | |
| 358 Importers may have specific options, you can set them using the ``-o NAME VALUE, --option NAME VALUE`` argument. Check the importer description for details. | |
| 359 | |
| 360 examples: | |
| 361 --------- | |
| 362 | |
| 363 List available importers:: | |
| 364 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
365 $ li blog import |
| 2946 | 366 |
| 367 Get description of ``dotclear`` importer:: | |
| 368 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
369 $ li blog import dotclear |
| 2946 | 370 |
|
4037
524856bd7b19
massive refactoring to switch from camelCase to snake_case:
Goffi <goffi@goffi.org>
parents:
3975
diff
changeset
|
371 import a Dotclear blog:: |
| 2946 | 372 |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
373 $ li blog import dotclear /path/to/dotclear.dump |
| 2946 | 374 |
|
4037
524856bd7b19
massive refactoring to switch from camelCase to snake_case:
Goffi <goffi@goffi.org>
parents:
3975
diff
changeset
|
375 import a Dotclear blog without uploading images:: |
| 2946 | 376 |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3177
diff
changeset
|
377 $ li blog import --no-images-upload dotclear /path/to/dotclear.dump |
|
3873
8b76caa89aa0
doc (cli/pubsub, cli/blog): `attachments` subcommands documentation:
Goffi <goffi@goffi.org>
parents:
3872
diff
changeset
|
378 |
|
8b76caa89aa0
doc (cli/pubsub, cli/blog): `attachments` subcommands documentation:
Goffi <goffi@goffi.org>
parents:
3872
diff
changeset
|
379 attachments |
|
8b76caa89aa0
doc (cli/pubsub, cli/blog): `attachments` subcommands documentation:
Goffi <goffi@goffi.org>
parents:
3872
diff
changeset
|
380 =========== |
|
8b76caa89aa0
doc (cli/pubsub, cli/blog): `attachments` subcommands documentation:
Goffi <goffi@goffi.org>
parents:
3872
diff
changeset
|
381 |
|
8b76caa89aa0
doc (cli/pubsub, cli/blog): `attachments` subcommands documentation:
Goffi <goffi@goffi.org>
parents:
3872
diff
changeset
|
382 Subcommands to add or remove data attached to pubsub items. Please check |
|
8b76caa89aa0
doc (cli/pubsub, cli/blog): `attachments` subcommands documentation:
Goffi <goffi@goffi.org>
parents:
3872
diff
changeset
|
383 :ref:`libervia-cli_blog_attachments`. |