Matthieu Gallien d75d635411 prepare 3.9.0-rc4 %!s(int64=2) %!d(string=hai) anos
..
_shared_assets 545a406997 Latest refinements %!s(int64=8) %!d(string=hai) anos
dev fe102f359c Build current documentation %!s(int64=8) %!d(string=hai) anos
images 39faeffe09 Add screenshots of the latest features. %!s(int64=4) %!d(string=hai) anos
scripts db24f60ae3 License: Adjust license of GPLv2 source files to GPLv2+ %!s(int64=9) %!d(string=hai) anos
CMakeLists.txt abac2c327e Fix cmake build of documentation %!s(int64=7) %!d(string=hai) anos
Makefile fe102f359c Build current documentation %!s(int64=8) %!d(string=hai) anos
README.md c3ff24faca Update README.md %!s(int64=3) %!d(string=hai) anos
advancedusage.rst fe102f359c Build current documentation %!s(int64=8) %!d(string=hai) anos
architecture.rst d42d3c057f Implement URI handler for local file editing %!s(int64=3) %!d(string=hai) anos
autoupdate.rst 804cef2bff Update autoupdater doc with info about the macOS autoupdater %!s(int64=3) %!d(string=hai) anos
building.rst ec64246dc7 Only build app bundle if requested %!s(int64=4) %!d(string=hai) anos
conf.py d75d635411 prepare 3.9.0-rc4 %!s(int64=2) %!d(string=hai) anos
conffile.rst 71dbd1103f Update documentation. %!s(int64=3) %!d(string=hai) anos
conflicts.rst c4e8211687 Change ownCloud reference to Nextcloud %!s(int64=5) %!d(string=hai) anos
envvars.rst 090d02a65f Documented the usage of environment variables. %!s(int64=9) %!d(string=hai) anos
faq.rst 2844c925eb Show a tray message when a folder watcher becomes unreliable #6119 %!s(int64=7) %!d(string=hai) anos
glossary.rst 78bfae45ae Mac OS X is now macOS %!s(int64=7) %!d(string=hai) anos
index.rst 4fa6fff1a9 Doc: Explaining conflict files and resolving them #6396 %!s(int64=7) %!d(string=hai) anos
installing.rst 95df4b98be Bump up minimum macOS version %!s(int64=3) %!d(string=hai) anos
introduction.rst 55067c55a7 Update improvements and news in the documentation %!s(int64=4) %!d(string=hai) anos
logo-blue.pdf 914df32587 Documentation: Fix PDF logo, version number %!s(int64=10) %!d(string=hai) anos
lowdiskspace.rst fe102f359c Build current documentation %!s(int64=8) %!d(string=hai) anos
navigating.rst 331b675571 docs: Replace "preceded" with "followed" %!s(int64=3) %!d(string=hai) anos
nextcloudcmd.rst 360100844c Update nextcloudcmd.rst %!s(int64=2) %!d(string=hai) anos
options.rst f4b1ba45b8 Document --background %!s(int64=4) %!d(string=hai) anos
troubleshooting.rst 71dbd1103f Update documentation. %!s(int64=3) %!d(string=hai) anos
visualtour.rst 2b598d1820 Double-clicking tray icon opens currently-selected user's local folder (if available) %!s(int64=3) %!d(string=hai) anos

README.md

Desktop client documentation

The main nextcloud Documentation is found at https://github.com/nextcloud/documentation

The rst files from the current stable branch will be parsed with sphinx to be used at https://docs.nextcloud.com/desktop/latest/

Dependencies

You will need to have Sphinx, which comes packaged with Python 3.

In addition, run the following to install PdfLatex and Doxygen.

  • On Linux:

    $ sudo apt install doxygen python texlive-latex-base texlive-latex-extra
    

    Note: You may use something other than apt depending on your distribution.

  • On macOS (via Homebrew):

    % brew install basictex doxygen python
    

How to build the documentation

In your repositories directory:

$ git clone https://github.com/nextcloud/desktop.git
$ cd desktop
$ cd doc
$ sphinx-build -b html -D html_theme='nextcloud_com' -d _build/doctrees   . _build/html/com

The documentation html files will be at desktop/docs/_build/html/com.