{"id":29190678,"url":"https://github.com/JankariTech/web-app-presentation-viewer","last_synced_at":"2025-07-02T00:10:50.153Z","repository":{"id":222286262,"uuid":"754066101","full_name":"JankariTech/web-app-presentation-viewer","owner":"JankariTech","description":"ownCloud Web extension to view markdown presentation slides","archived":false,"fork":false,"pushed_at":"2025-04-07T04:57:04.000Z","size":1061,"stargazers_count":4,"open_issues_count":13,"forks_count":1,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-06-30T22:11:23.658Z","etag":null,"topics":["frontend","md","owncloud","owncloud-web","reveal-js","revealjs","typescript","vue","vuejs"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JankariTech.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["JankariTech"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"custom":null}},"created_at":"2024-02-07T10:34:57.000Z","updated_at":"2025-04-07T04:57:06.000Z","dependencies_parsed_at":"2024-03-11T05:25:08.725Z","dependency_job_id":"6e0ae0f6-a50b-42ce-9299-3283ae8cd826","html_url":"https://github.com/JankariTech/web-app-presentation-viewer","commit_stats":null,"previous_names":["jankaritech/web-app-presentation-viewer"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/JankariTech/web-app-presentation-viewer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JankariTech%2Fweb-app-presentation-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JankariTech%2Fweb-app-presentation-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JankariTech%2Fweb-app-presentation-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JankariTech%2Fweb-app-presentation-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JankariTech","download_url":"https://codeload.github.com/JankariTech/web-app-presentation-viewer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JankariTech%2Fweb-app-presentation-viewer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263052430,"owners_count":23406106,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["frontend","md","owncloud","owncloud-web","reveal-js","revealjs","typescript","vue","vuejs"],"created_at":"2025-07-02T00:10:48.989Z","updated_at":"2025-07-02T00:10:50.125Z","avatar_url":"https://github.com/JankariTech.png","language":"JavaScript","funding_links":["https://github.com/sponsors/JankariTech"],"categories":["ownCloud Apps and Extensions","OpenCloud Apps and Extensions"],"sub_categories":["Viewers \u0026 Editors"],"readme":"# Markdown Presentation Viewer for OpenCloud \u0026 ownCloud (oCIS)\n\n![cover photo](./images/cover-large.png)\n\nA markdown presentation viewer for [OpenCloud](https://github.com/opencloud-eu/opencloud/) and [oCIS](https://github.com/owncloud/ocis/) using the [reveal.js](https://revealjs.com/) library.\n\nIt allows users to:\n\n- create slide presentations directly from markdown files\n- share the slides using public links\n\n## Demonstration\n\n- [Demonstation page OpenCloud](https://opencloud.in-nepal.de/files/link/public/PHxkrAlpSRaqNNK)\n- [Demonstation page oCIS](https://ocis.in-nepal.de/files/link/public/phDIUqntYOMSfcE)\n- Click on `Open in Presentation Viewer` to view the slides\n\n## Supported oCIS and Web Versions\n\n- [oCIS](https://github.com/owncloud/ocis) (\u003e= 6.x.x) or [OpenCloud](https://github.com/opencloud-eu/opencloud/) (\u003e= 2.0.0)\n\n## App Installation\n\n1. Download the zip file from the [releases page](https://github.com/JankariTech/web-app-presentation-viewer/releases)\n\n   For example: `mdpresentation-viewer-\u003cserver\u003e-x.x.x.zip`\n\n2. Extract the zip file to the `apps` directory of the OpenCloud/oCIS server.\n\n   Apps directory is set using the `WEB_ASSET_APPS_PATH` environment variable.\n\n### App Installation With [OpenCloud](https://github.com/opencloud-eu/opencloud/tree/main/deployments/examples/opencloud_full) or [oCIS Deployment](https://github.com/owncloud/ocis/tree/master/deployments/examples/ocis_full)\n\n1. Copy the `yml` file that corresponds with your server (OpenCloud or oCIS) from [`deployments/`](./deployments/) into the `web_extensions`\nsubfolder.\n2. Add `MDPRESENTATION_VIEWER=:web_extensions/mdpresentation-viewer-\u003cyour-server\u003e.yml` to the `Web Extensions` section of the `.env` file of your installation and append it to the `COMPOSE_FILE` variable.\n    ```env\n    MDPRESENTATION_VIEWER=:web_extensions/mdpresentation-viewer-\u003cyour-server\u003e.yml\n    \n    COMPOSE_FILE=docker-compose.yml${...}${MDPRESENTATION_VIEWER:-}\n    ```\n3. Run `docker compose up` to run the server with the extensions\n\n## Creating Presentation\n\nPlease, refer to the [documentation](https://revealjs.com/markdown/) for more information about creating a presentation using markdown.\n\nThis app has the following default slide separators:\n\n- Horizontal separator: `---` (`← →`)\n- Vertical separator: `--` (`↓ ↑`)\n\n## Development\n\n\u003e [!IMPORTANT] When switching between OpenCloud and oCIS, make sure to clean the browser cache!\n\u003e [!CAUTION] Before commiting changes run `make installOcis` and `make clean`\n\n#### Prerequisites\n\n- [Node.js `v18`](https://nodejs.org/en/)\n- [pnpm `v8`](https://pnpm.io/)\n- [Docker Compose](https://docs.docker.com/compose/)\n- [jq](https://jqlang.org/)\n\n#### 1. Install dependencies:\n\nFor OpenCloud:\n```bash\nmake installOpencloud\n```\n\nFor oCIS:\n```bash\nmake installOcis\n```\n\n#### 2. Build the extension\n\nFor development, build with watch.\n\n```bash\npnpm build:w\n```\n\n#### 3. Load the extension\n\nRun the server with the extension:\n\nFor OpenCloud:\n```bash\ndocker compose -f docker-compose-opencloud.yml up\n```\n\nFor oCIS:\n```bash\ndocker compose -f docker-compose-ocis.yml up\n```\n\nserver URL: [localhost:9200](https://localhost:9200)\n\n## Building Docker Container\n\nFor OpenCloud:\n```bash\ndocker build --build-arg server=Opencloud -t jankaritech/mdpresentation-viewer-opencloud:\u003cversion\u003e .\n```\n\n\nFor Ocis:\n```bash\ndocker build --build-arg server=Ocis -t jankaritech/mdpresentation-viewer-ocis:\u003cversion\u003e .\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJankariTech%2Fweb-app-presentation-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FJankariTech%2Fweb-app-presentation-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJankariTech%2Fweb-app-presentation-viewer/lists"}