emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
To: Richard Stallman <rms@gnu.org>
Cc: 32722@debbugs.gnu.org, n@flqt.fr, 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__25862.6168863431$1538232762$gmane$org@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

  parent reply	other threads:[~2018-09-29 14:54 UTC|newest]

Thread overview: 89+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <531a7f93882cc0d5d09700457d06ea082f47569b.camel@flqt.fr>
2018-09-13  3:35 ` bug#32722: 26.1; Org-publish depend on non-free platform ? Richard Stallman
     [not found] ` <83zhwmlnst.fsf@gnu.org>
2018-09-13  7:33   ` Nicolas Floquet
     [not found] ` <E1g0IPY-000465-4I@fencepost.gnu.org>
2018-09-13 15:26   ` Glenn Morris
     [not found]   ` <tqd0thctb6.fsf@fencepost.gnu.org>
2018-09-13 15:36     ` Kaushal Modi
2018-09-13 21:58       ` Samuel Wales
2018-09-13 21:58       ` bug#32722: " Samuel Wales
2018-09-13 21:58       ` Samuel Wales
2018-09-14  2:55       ` bug#32722: " Richard Stallman
     [not found]       ` <E1g0eGJ-0002Ws-Gt@fencepost.gnu.org>
2018-09-14  6:04         ` Eli Zaretskii
2018-09-16 12:30           ` Adam Porter
2018-09-17 20:21             ` Nick Dokos
2018-09-18 13:12               ` Bernt Hansen
     [not found]         ` <83sh2ck42e.fsf@gnu.org>
2018-09-18  9:37           ` Nicolas Goaziou
2018-09-18 11:49             ` Eli Zaretskii
2018-09-18 14:21               ` Nick Dokos
2018-09-18 14:49                 ` Kaushal Modi
     [not found]             ` <83zhwff2k8.fsf@gnu.org>
2018-09-18 12:14               ` bug#32722: " Robert Klein
2018-09-19  3:41                 ` Richard Stallman
2018-09-19  7:22                 ` Eli Zaretskii
2018-09-18 14:43             ` Nicolas Floquet
     [not found]             ` <dbc243f2281e5b97b59d543f8e29559b1ffdc38f.camel@flqt.fr>
2018-09-18 16:37               ` bug#32722: " Robert Horn
     [not found]               ` <m3tvmm4v8m.fsf@panix.com>
2018-09-18 16:53                 ` Eli Zaretskii
     [not found]                 ` <83efdqg32d.fsf@gnu.org>
2018-09-18 18:53                   ` bug#32722: " Robert Klein
2018-09-18 20:41                   ` Glenn Morris
     [not found]                   ` <vain32bksv.fsf_-_@fencepost.gnu.org>
2018-09-18 21:07                     ` Nicolas Goaziou
2018-09-19  3:39                     ` Richard Stallman
     [not found]                     ` <87lg7yfraw.fsf@nicolasgoaziou.fr>
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
     [not found]                           ` <E1g2oAo-0000ao-2k@fencepost.gnu.org>
2018-09-20  4:24                             ` Eli Zaretskii
2018-09-20 10:43                             ` bug#32722: " Joe Corneli
     [not found]                             ` <CAN+qofnbqV8MT0wmKNokXv0S8f9PnXcpK1RdsH-8Zb2i8ckNPw@mail.gmail.com>
2018-09-21  2:13                               ` Richard Stallman
2018-09-21 10:22                                 ` Joe Corneli
     [not found]                                 ` <m2zhwbup3a.fsf@dhcp-90-218.inf.ed.ac.uk>
2018-09-22  1:52                                   ` Richard Stallman
2018-09-20  5:43                           ` Eli Zaretskii
     [not found]                           ` <83h8ikenbc.fsf@gnu.org>
2018-09-20  8:13                             ` bug#32722: " 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
     [not found]                             ` <87in30geqo.fsf@nicolasgoaziou.fr>
2018-09-20 20:50                               ` Eli Zaretskii
     [not found]                               ` <835zyzevvt.fsf@gnu.org>
2018-10-22 13:13                                 ` Nicolas Goaziou
     [not found]                                 ` <87d0s2yvi4.fsf@nicolasgoaziou.fr>
2018-10-22 13:48                                   ` Eli Zaretskii
2018-09-19  3:39                       ` Richard Stallman
2018-09-19  7:02                       ` Eli Zaretskii
2018-09-20  5:21                         ` Adam Porter
     [not found]                       ` <831s9qezqo.fsf@gnu.org>
2018-09-20 17:42                         ` Nicolas Goaziou
     [not found]                         ` <87muscgj51.fsf@nicolasgoaziou.fr>
2018-09-20 20:48                           ` Eli Zaretskii
2018-09-21  2:18                           ` Richard Stallman
     [not found]                     ` <E1g2TLB-000734-Os@fencepost.gnu.org>
2018-09-19  7:04                       ` Eli Zaretskii
     [not found]                       ` <83zhwedl2v.fsf@gnu.org>
2018-09-20  1:50                         ` Richard Stallman
     [not found]                         ` <E1g2o79-0008S6-UV@fencepost.gnu.org>
2018-09-20  4:22                           ` Eli Zaretskii
     [not found]                           ` <83lg7wer1z.fsf@gnu.org>
2018-09-21  2:18                             ` Richard Stallman
     [not found]                             ` <E1g3B16-0004U1-2g@fencepost.gnu.org>
2019-05-16 15:16                               ` Nicolas Floquet
     [not found]                               ` <c20679912a5c2644bf6e62a65b7c4da118d988f5.camel@flqt.fr>
2019-05-16 15:25                                 ` Nicolas Floquet
     [not found]                                 ` <3554abc2df1167f5b052b021670bbd09fae6dd6f.camel@flqt.fr>
2019-06-09 16:54                                   ` bug#32722: " Amin Bandali
     [not found]                   ` <20180918205329.2e12c16f@happy.intern.roklein.de>
2018-09-18 18:57                     ` bug#32722: bug#32722: " Kaushal Modi
2018-09-18 19:29                       ` Kaushal Modi
2018-09-19  3:39                         ` Richard Stallman
2018-09-19  3:39                     ` Richard Stallman
2018-09-25 23:04                     ` Richard Stallman
2018-09-19  3:40                 ` Richard Stallman
2018-09-24  9:54                 ` Nicolas Floquet
2018-09-19  3:41               ` Richard Stallman
2018-09-19 12:29                 ` Nicolas Goaziou
     [not found]                 ` <87h8ilfz6o.fsf@nicolasgoaziou.fr>
2018-09-20  1:50                   ` Richard Stallman
     [not found]                   ` <E1g2o6s-0008PG-JL@fencepost.gnu.org>
2018-09-20 12:40                     ` Nicolas Goaziou
2018-09-20 12:59                     ` Bingo UV
2018-09-21  2:13                       ` Richard Stallman
2018-09-21 19:21                         ` bug#32722: bug#32722: " Leslie Watter
     [not found]                         ` <CAKoz4gnvbc1tTGW57c_7cVN0gF2KrgAjYRT+kwp29fMOYX3RCA@mail.gmail.com>
2018-09-23  1:38                           ` Richard Stallman
     [not found]                           ` <E1g3tLf-0003Es-KN@fencepost.gnu.org>
2018-09-29 14:53                             ` Nicolas Goaziou [this message]
     [not found]                             ` <87mus0z773.fsf@nicolasgoaziou.fr>
2018-09-29 15:09                               ` Eli Zaretskii
     [not found]                               ` <83in2o5oi3.fsf@gnu.org>
2018-09-29 18:33                                 ` Nicolas Goaziou
2018-09-29 18:58                                   ` Eli Zaretskii
     [not found]                                   ` <83ftxs5dvw.fsf@gnu.org>
2018-09-29 23:35                                     ` bug#32722: " Kyle Meyer
2018-09-30 11:43                                       ` Eli Zaretskii
     [not found]                                       ` <83y3bj43d8.fsf@gnu.org>
2020-05-24  8:03                                         ` bug#32722: [O] " Bastien
2018-09-30  9:27                               ` Michael Albinus
2018-10-22  9:39                                 ` Nicolas Goaziou
     [not found]                                 ` <87r2giz5ey.fsf@nicolasgoaziou.fr>
2018-10-22 11:07                                   ` Michael Albinus
     [not found]                                   ` <871s8is0i6.fsf@gmx.de>
2018-10-22 13:17                                     ` Nicolas Goaziou
     [not found]                     ` <87worggx5b.fsf@nicolasgoaziou.fr>
2018-09-20 14:31                       ` Michael Albinus
2018-12-03 10:22 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

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='87mus0z773.fsf__25862.6168863431$1538232762$gmane$org@nicolasgoaziou.fr' \
    --to=mail@nicolasgoaziou.fr \
    --cc=32722@debbugs.gnu.org \
    --cc=kaushal.modi@gmail.com \
    --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 public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).