Git Product home page Git Product logo

text's Introduction

Nextcloud Text

GitHub Workflow Status Start contributing

๐Ÿ“‘ Collaborative document editing!

Features

  • ๐Ÿ“ Simple focused writing: No distractions, only the formatting you need.
  • ๐Ÿ™‹ Work together: Share and collaborate with friends and colleagues, no matter if they use Nextcloud or not!
  • ๐Ÿ’พ Open format: Files are saved as Markdown, so you can edit them from any other text app too.
  • โœŠ Strong foundation: We use ๐Ÿˆ tiptap which is based on ๐Ÿฆ‰ ProseMirror โ€“ huge thanks to them!

Nextcloud Text is the default text editor since Nextcloud 17. To start editing just open an existing markdown or plaintext file or create a new one.

Configuration

The rich workspaces in the file list can be disabled either by the users in the files app settings or globally by the admin with the following occ command:

occ config:app:set text workspace_available --value=0

๐Ÿ— Development setup

Currently this app requires the master branch of the Viewer app.

  1. โ˜ Clone this app into the apps folder of your Nextcloud: git clone https://github.com/nextcloud/text.git
  2. ๐Ÿ‘ฉโ€๐Ÿ’ป In the folder of the app, run the command make to install dependencies and build the Javascript.
  3. โœ… Enable the app through the app management of your Nextcloud
  4. ๐ŸŽ‰ Partytime! Help fix some issues and review pull requests ๐Ÿ‘

๐Ÿง™ Advanced development stuff

To build the Javascript whenever you make changes, instead of the full make you can also run npm run build. Or run npm run watch to rebuild on every file save.

๐Ÿž Testing the app

Currently this app uses three different kinds of tests:

For testing the backend (PHP) Psalm and PHPUnit are used, you can run the testcases (placed in tests/) using the composer scripts psalm and test:unit.

For testing the frontend jest is used for unittests, whereas cypress is used for end2end testing. The unittests are also placed in tests/, the cypress tests are placed in cypress/. You can run the tests using the package scripts npm run test (jest), and respective npm run test:cypress (cypress).

Please note the cypress tests require a nextcloud server running, the if no running server is detected a docker container will be started, this requires the current user to be in the docker group. Or you might set the CYPRESS_baseUrl environment variable for a custom nextcloud server.

text's People

Contributors

juliushaertl avatar dependabot[bot] avatar dependabot-preview[bot] avatar nextcloud-bot avatar max-nextcloud avatar azul avatar mejo- avatar jancborchardt avatar nextcloud-command avatar rullzer avatar nickvergessen avatar skjnldsv avatar luka-nextcloud avatar npmbuildbot[bot] avatar szaimen avatar christophwurst avatar morrisjobke avatar valdnet avatar danxuliu avatar come-nc avatar pvince81 avatar raudius avatar gary-kim avatar ashuio avatar rakekniven avatar georgehrke avatar zzkt avatar alexanderschau avatar kesselb avatar susnux avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.