From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
To: Richard Stallman <rms@gnu.org>
Cc: 32722@debbugs.gnu.org, n@flqt.fr, leslie@watter.net,
right.ho@gmail.com, kaushal.modi@gmail.com
Subject: bug#32722: bug#32722: bug#32722: bug#32722: 26.1; Org-publish depend on non-free platform ?
Date: Sat, 29 Sep 2018 16:53:04 +0200 [thread overview]
Message-ID: <87mus0z773.fsf@nicolasgoaziou.fr> (raw)
In-Reply-To: <E1g3tLf-0003Es-KN@fencepost.gnu.org> (Richard Stallman's message of "Sat, 22 Sep 2018 21:38:11 -0400")
Hello,
Richard Stallman <rms@gnu.org> writes:
> This is actually good news. It means Android MobileOrg is almost ok.
> If someone wants to do a little work on Android MobileOrg, so it could
> go into f-droid, we could recommend its use. But the doc should be
> updated.
For the record, I rewrote the section about Org Mobile in the manual.
This removed all instances of "MobileOrg" and "Dropbox". Here it is in
its full glory (please ignore the broken links, which refer to other
parts in the Org manual):
--8<---------------cut here---------------start------------->8---
━━━━━━━━━━━━━━━━━━━━━━━━━
ORG MOBILE
Release 9.2
The Org Mode Developers
━━━━━━━━━━━━━━━━━━━━━━━━━
Table of Contents
─────────────────
1. Setting up the staging area
2. Pushing to the mobile application
3. Pulling from the mobile application
Org Mobile is a protocol for synchronizing Org files between Emacs and
other applications, e.g., on mobile devices. It enables offline-views
and capture support for an Org mode system that is rooted on a “real”
computer. The external application can also record changes to existing
entries.
This appendix describes Org’s support for agenda view formats compatible
with Org Mobile. It also describes synchronizing changes, such as to
notes, between the mobile application and the computer.
To change tags and TODO states in the mobile application, first
customize the variables `org-todo-keywords' and `org-tag-alist'. These
should cover all the important tags and TODO keywords, even if Org files
use only some of them. Though the mobile application is expected to
support in-buffer settings, it is required to understand TODO states
/sets/ (see [BROKEN LINK: *Setting up keywords for individual files])
and /mutually exclusive/ tags (see [BROKEN LINK: *Setting Tags]) only
for those set in these variables.
1 Setting up the staging area
═════════════════════════════
The mobile application needs access to a file directory on a server[1]
to interact with Emacs. Pass its location through the
`org-mobile-directory' variable. If you can mount that directory
locally just set the variable to point to that directory:
┌────
│ (setq org-mobile-directory "~/orgmobile/")
└────
Alternatively, by using TRAMP (see [TRAMP User Manual]),
`org-mobile-directory' may point to a remote directory accessible
through, for example, SSH and SCP:
┌────
│ (setq org-mobile-directory "/scpc:user@remote.host:org/webdav/")
└────
With a public server, consider encrypting the files. Org also requires
OpenSSL installed on the local computer. To turn on encryption, set
the same password in the mobile application and in Emacs. Set the
password in the variable `org-mobile-use-encryption'[2]. Note that
even after the mobile application encrypts the file contents, the file
name remains visible on the file systems of the local computer, the
server, and the mobile device.
[TRAMP User Manual] <info:tramp>
2 Pushing to the mobile application
═══════════════════════════════════
The command `org-mobile-push' copies files listed in
`org-mobile-files' into the staging area. Files include agenda files
(as listed in `org-agenda-files'). Customize `org-mobile-files' to add
other files. File names are staged with paths relative to
`org-directory', so all files should be inside this directory[3].
Push creates a special Org file `agendas.org' with custom agenda views
defined by the user[4].
Finally, Org writes the file `index.org', containing links to other
files. The mobile application reads this file first from the server to
determine what other files to download for agendas. For faster
downloads, it is expected to only read files whose checksums[5] have
changed.
3 Pulling from the mobile application
═════════════════════════════════════
The command `org-mobile-pull' synchronizes changes with the server.
More specifically, it first pulls the Org files for viewing. It then
appends captured entries and pointers to flagged or changed entries to
the file `mobileorg.org' on the server. Org ultimately integrates its
data in an inbox file format, through the following steps:
1. Org moves all entries found in `mobileorg.org'[6] and appends them
to the file pointed to by the variable `org-mobile-inbox-for-pull'.
It should reside neither in the staging area nor on the server. Each
captured entry and each editing event is a top-level entry in the
inbox file.
2. After moving the entries, Org processes changes to the shared files.
Some of them are applied directly and without user interaction.
Examples include changes to tags, TODO state, headline and body
text. Entries requiring further action are tagged as `FLAGGED'. Org
marks entries with problems with an error message in the inbox. They
have to be resolved manually.
3. Org generates an agenda view for flagged entries for user
intervention to clean up. For notes stored in flagged entries, Org
displays them in the echo area when point is on the corresponding
agenda item.
?
Pressing ? displays the entire flagged note in another
window. Org also pushes it to the kill ring. To store flagged
note as a normal note, use ? z C-y C-c C-c. Pressing ? twice
does these things: first it removes the `FLAGGED' tag;
second, it removes the flagged note from the property drawer;
third, it signals that manual editing of the flagged entry is
now finished.
From the agenda dispatcher, ? returns to the view to finish processing
flagged entries. Note that these entries may not be the most recent
since the mobile application searches files that were last pulled. To
get an updated agenda view with changes since the last pull, pull
again.
Footnotes
─────────
[1] For a server to host files, consider using a WebDAV server, such
as [Nextcloud] (<https://nextcloud.com>). Additional help is at this
[FAQ entry]
(<https://orgmode.org/worg/org-faq.html#mobileorg_webdav>).
[2] If Emacs is configured for safe storing of passwords, then
configure the variable `org-mobile-encryption-password'; please read
the docstring of that variable.
[3] Symbolic links in `org-directory' need to have the same name as
their targets.
[4] While creating the agendas, Org mode forces ID properties on all
referenced entries, so that these entries can be uniquely identified
if Org Mobile flags them for further action. To avoid setting
properties configure the variable
`org-mobile-force-id-on-agenda-items' to `nil'. Org mode then relies
on outline paths, assuming they are unique.
[5] Checksums are stored automatically in the file `checksums.dat'.
[6] The file will be empty after this operation.
--8<---------------cut here---------------end--------------->8---
I also used CTAN URL for the minted LaTeX package.
Regards,
--
Nicolas Goaziou
next prev parent reply other threads:[~2018-09-29 14:53 UTC|newest]
Thread overview: 163+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-09-12 14:06 bug#32722: 26.1; Org-publish depend on non-free platform ? Nicolas Floquet
2018-09-12 15:48 ` Eli Zaretskii
2018-09-13 7:33 ` Nicolas Floquet
2018-09-13 7:33 ` Nicolas Floquet
2018-09-13 3:35 ` Richard Stallman
2018-09-13 15:26 ` Glenn Morris
2018-09-13 15:36 ` bug#32722: [O] " Kaushal Modi
2018-09-13 15:36 ` Kaushal Modi
2018-09-13 21:58 ` bug#32722: [O] " Samuel Wales
2018-09-13 21:58 ` Samuel Wales
2018-09-13 21:58 ` Samuel Wales
2018-09-13 21:58 ` bug#32722: " Samuel Wales
2018-09-14 2:55 ` bug#32722: [O] " Richard Stallman
2018-09-14 6:04 ` bug#32722: " Eli Zaretskii
2018-09-16 12:30 ` Adam Porter
2018-09-17 20:21 ` Nick Dokos
2018-09-18 13:12 ` Bernt Hansen
2018-09-14 6:04 ` bug#32722: [O] " Eli Zaretskii
2018-09-18 9:37 ` bug#32722: " Nicolas Goaziou
2018-09-18 11:49 ` Eli Zaretskii
2018-09-18 14:21 ` Nick Dokos
2018-09-18 14:49 ` Kaushal Modi
2018-09-18 11:49 ` bug#32722: [O] " Eli Zaretskii
2018-09-18 12:14 ` bug#32722: [O] bug#32722: " Robert Klein
2018-09-18 12:14 ` bug#32722: " Robert Klein
2018-09-19 3:41 ` bug#32722: [O] " Richard Stallman
2018-09-19 3:41 ` bug#32722: " Richard Stallman
2018-09-19 7:22 ` bug#32722: [O] " Eli Zaretskii
2018-09-19 7:22 ` bug#32722: " Eli Zaretskii
2018-09-18 14:43 ` bug#32722: [O] " Nicolas Floquet
2018-09-18 16:37 ` bug#32722: bug#32722: " Robert Horn
2018-09-18 16:37 ` bug#32722: [O] " Robert Horn
2018-09-18 16:53 ` Eli Zaretskii
2018-09-18 18:53 ` bug#32722: bug#32722: " Robert Klein
2018-09-18 18:53 ` bug#32722: [O] " Robert Klein
2018-09-18 18:57 ` Kaushal Modi
2018-09-18 18:57 ` bug#32722: " Kaushal Modi
2018-09-18 19:29 ` bug#32722: [O] " Kaushal Modi
2018-09-18 19:29 ` Kaushal Modi
2018-09-19 3:39 ` Richard Stallman
2018-09-19 3:39 ` bug#32722: [O] " Richard Stallman
2018-09-19 3:39 ` bug#32722: [O] " Richard Stallman
2018-09-19 3:39 ` bug#32722: " Richard Stallman
2018-09-25 23:04 ` Richard Stallman
2018-09-25 23:04 ` bug#32722: [O] " Richard Stallman
2018-09-18 20:41 ` Glenn Morris
2018-09-18 20:41 ` Glenn Morris
2018-09-18 21:07 ` Nicolas Goaziou
2018-09-18 22:08 ` bug#32722: " Amin Bandali
2018-09-19 21:16 ` bug#32722: " Kaushal Modi
2018-09-20 1:54 ` Richard Stallman
2018-09-20 1:54 ` bug#32722: [O] " Richard Stallman
2018-09-20 4:24 ` bug#32722: " Eli Zaretskii
2018-09-20 4:24 ` bug#32722: [O] " Eli Zaretskii
2018-09-20 10:43 ` bug#32722: bug#32722: " Joe Corneli
2018-09-20 10:43 ` bug#32722: [O] " Joe Corneli
2018-09-21 2:13 ` bug#32722: " Richard Stallman
2018-09-21 10:22 ` Joe Corneli
2018-09-21 10:22 ` bug#32722: [O] " Joe Corneli
2018-09-22 1:52 ` Richard Stallman
2018-09-22 1:52 ` bug#32722: " Richard Stallman
2018-09-21 2:13 ` bug#32722: [O] " Richard Stallman
2018-09-20 5:43 ` Eli Zaretskii
2018-09-20 5:43 ` bug#32722: [O] " Eli Zaretskii
2018-09-20 8:13 ` bug#32722: bug#32722: " Robert Klein
2018-09-20 8:13 ` bug#32722: [O] " Robert Klein
2018-09-20 19:17 ` Nicolas Goaziou
2018-09-20 23:17 ` Adam Porter
2018-09-21 0:39 ` Kaushal Modi
2018-09-21 1:54 ` Adam Porter
2018-09-21 21:30 ` Kaushal Modi
2018-09-20 19:17 ` bug#32722: [O] " Nicolas Goaziou
2018-09-20 20:50 ` Eli Zaretskii
2018-10-22 13:13 ` bug#32722: " Nicolas Goaziou
2018-10-22 13:13 ` Nicolas Goaziou
2018-10-22 13:48 ` Eli Zaretskii
2018-10-22 13:48 ` Eli Zaretskii
2018-09-20 20:50 ` Eli Zaretskii
2018-09-19 21:16 ` bug#32722: [O] " Kaushal Modi
2018-09-18 22:08 ` bug#32722: [O] " Amin Bandali
2018-09-19 3:39 ` Richard Stallman
2018-09-19 3:39 ` Richard Stallman
2018-09-19 7:02 ` Eli Zaretskii
2018-09-20 5:21 ` Adam Porter
2018-09-19 7:02 ` Eli Zaretskii
2018-09-20 17:42 ` Nicolas Goaziou
2018-09-20 20:48 ` Eli Zaretskii
2018-09-20 20:48 ` Eli Zaretskii
2018-09-21 2:18 ` Richard Stallman
2018-09-21 2:18 ` Richard Stallman
2018-09-20 17:42 ` Nicolas Goaziou
2018-09-18 21:07 ` Nicolas Goaziou
2018-09-19 3:39 ` Richard Stallman
2018-09-19 7:04 ` Eli Zaretskii
2018-09-19 7:04 ` Eli Zaretskii
2018-09-20 1:50 ` Richard Stallman
2018-09-20 4:22 ` Eli Zaretskii
2018-09-20 4:22 ` Eli Zaretskii
2018-09-21 2:18 ` Richard Stallman
2018-09-21 2:18 ` Richard Stallman
2019-05-16 15:16 ` Nicolas Floquet
2019-05-16 15:25 ` Nicolas Floquet
2019-06-09 16:54 ` bug#32722: [O] " Amin Bandali
2019-06-09 16:54 ` bug#32722: " Amin Bandali
2019-05-16 15:25 ` Nicolas Floquet
2019-05-16 15:16 ` Nicolas Floquet
2018-09-20 1:50 ` Richard Stallman
2018-09-19 3:39 ` Richard Stallman
2018-09-18 16:53 ` bug#32722: bug#32722: " Eli Zaretskii
2018-09-19 3:40 ` Richard Stallman
2018-09-19 3:40 ` bug#32722: [O] " Richard Stallman
2018-09-24 9:54 ` bug#32722: " Nicolas Floquet
2018-09-24 9:54 ` bug#32722: [O] " Nicolas Floquet
2018-09-19 3:41 ` bug#32722: [O] " Richard Stallman
2018-09-19 3:41 ` bug#32722: " Richard Stallman
2018-09-19 12:29 ` Nicolas Goaziou
2018-09-19 12:29 ` bug#32722: [O] " Nicolas Goaziou
2018-09-20 1:50 ` bug#32722: " Richard Stallman
2018-09-20 1:50 ` bug#32722: [O] " Richard Stallman
2018-09-20 12:40 ` bug#32722: " Nicolas Goaziou
2018-09-20 12:40 ` bug#32722: [O] " Nicolas Goaziou
2018-09-20 14:31 ` bug#32722: " Michael Albinus
2018-09-20 14:31 ` bug#32722: [O] " Michael Albinus
2018-09-20 12:59 ` bug#32722: " Bingo UV
2018-09-21 2:13 ` Richard Stallman
2018-09-21 19:21 ` bug#32722: bug#32722: " Leslie Watter
2018-09-21 19:21 ` bug#32722: [O] " Leslie Watter
2018-09-23 1:38 ` Richard Stallman
2018-09-29 14:53 ` Nicolas Goaziou [this message]
2018-09-29 15:09 ` bug#32722: " Eli Zaretskii
2018-09-29 15:09 ` Eli Zaretskii
2018-09-29 18:33 ` Nicolas Goaziou
2018-09-29 18:33 ` Nicolas Goaziou
2018-09-29 18:58 ` Eli Zaretskii
2018-09-29 23:35 ` bug#32722: " Kyle Meyer
2018-09-30 11:43 ` Eli Zaretskii
2018-09-30 11:43 ` bug#32722: [O] " Eli Zaretskii
2020-05-24 8:03 ` Bastien
2020-05-24 8:03 ` Bastien
2018-09-29 23:35 ` Kyle Meyer
2018-09-29 18:58 ` Eli Zaretskii
2018-09-30 9:27 ` Michael Albinus
2018-09-30 9:27 ` Michael Albinus
2018-10-22 9:39 ` Nicolas Goaziou
2018-10-22 9:39 ` Nicolas Goaziou
2018-10-22 11:07 ` Michael Albinus
2018-10-22 13:17 ` Nicolas Goaziou
2018-10-22 13:17 ` Nicolas Goaziou
2018-10-22 11:07 ` Michael Albinus
2018-09-29 14:53 ` Nicolas Goaziou
2018-09-23 1:38 ` Richard Stallman
2018-09-21 2:13 ` bug#32722: [O] " Richard Stallman
2018-09-20 12:59 ` Bingo UV
2018-09-18 14:43 ` Nicolas Floquet
2018-09-18 9:37 ` bug#32722: [O] " Nicolas Goaziou
2018-09-14 2:55 ` bug#32722: " Richard Stallman
2018-09-13 15:26 ` Glenn Morris
2018-09-13 3:35 ` Richard Stallman
-- strict thread matches above, loose matches on Subject: below --
2018-12-03 10:22 bug#32722: bug#32722: bug#32722: " Van L
2018-12-03 13:37 ` Jonathan Leech-Pepin
2018-12-04 9:41 ` Van L
2018-12-05 0:31 ` Richard Stallman
2018-12-05 11:54 ` Van L
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87mus0z773.fsf@nicolasgoaziou.fr \
--to=mail@nicolasgoaziou.fr \
--cc=32722@debbugs.gnu.org \
--cc=kaushal.modi@gmail.com \
--cc=leslie@watter.net \
--cc=n@flqt.fr \
--cc=right.ho@gmail.com \
--cc=rms@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.