{"id":18779313,"url":"https://github.com/zostay/yukki","last_synced_at":"2025-04-13T10:33:56.644Z","repository":{"id":56838193,"uuid":"1502347","full_name":"zostay/Yukki","owner":"zostay","description":"Yet Uhnother Wiki - git-based wiki with workgroups","archived":false,"fork":false,"pushed_at":"2017-11-09T02:48:01.000Z","size":1663,"stargazers_count":7,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-06-21T19:51:19.657Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zostay.png","metadata":{"files":{"readme":"README.md","changelog":"Changes","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-03-20T05:56:24.000Z","updated_at":"2024-06-21T19:51:19.657Z","dependencies_parsed_at":"2022-09-12T11:51:30.764Z","dependency_job_id":null,"html_url":"https://github.com/zostay/Yukki","commit_stats":null,"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zostay%2FYukki","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zostay%2FYukki/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zostay%2FYukki/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zostay%2FYukki/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zostay","download_url":"https://codeload.github.com/zostay/Yukki/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223582992,"owners_count":17168781,"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":[],"created_at":"2024-11-07T20:19:36.281Z","updated_at":"2024-11-07T20:19:36.799Z","avatar_url":"https://github.com/zostay.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/zostay/Yukki.svg?branch=master)](https://travis-ci.org/zostay/Yukki)\n[![Coverage Status](https://coveralls.io/repos/zostay/Yukki/badge.svg?branch=master)](https://coveralls.io/r/zostay/Yukki?branch=master)\n[![GitHub issues](https://img.shields.io/github/issues/zostay/Yukki.svg)](https://github.com/zostay/Yukki/issues)\n[![Kwalitee status](http://cpants.cpanauthors.org/dist/Yukki.png)](http://cpants.charsbar.org/dist/overview/Yukki)\n\n# NAME\n\nYukki::Manual::Installation - installation instructions\n\n# VERSION\n\nversion 0.991\\_006\n\n# SYNOPSIS\n\n     # Install the module\n     perl -MCPAN -e 'install Yukki'\n    \n     # OR better, install cpanm and run...\n     cpanm Yukki\n\n     # Setup your wiki's installation folder\n     yukki-setup mysite\n     cd mysite\n\n     # Setup the repositories\n     yukki-git-init main\n     yukki-git-init yukki git://github.com/zostay/yukki-help.git\n\n     # Add a user\n     yukki-add-user\n\n     # Start the server\n     yukki.psgi\n\n# DESCRIPTION\n\nThe [\"SYNOPSIS\"](#synopsis) pretty well sums up the highlights of installation. The rest of this document discusses what each piece does and how to customize it further.\n\n# INSTALLATION\n\nThe code can be installed like any other CPAN module. By using [App::cpanminus](https://metacpan.org/pod/App::cpanminus) or [CPAN](https://metacpan.org/pod/CPAN), you will get all the dependencies downloaded and installed automatically for you.\n\n# SITE SETUP\n\nTo setup your site, you run the `yukki-setup` script:\n\n    yukki-setup mysite\n\nThis will create a directory named `mysite` in the current folder and will copy into a skeleton installation that you may customize to suit the needs of your wiki site.\n\nIn it you will find these files and directories:\n\n- `etc/yukki.conf`. This is the configuraiton file for your application. You will want to read this to make sure it is correct before continuing. The default install includes two repositories. The one named \"main\" is intended to be a repository for you to use to suite your needs. The one named \"yukki\" contains a repository of online help for the wiki software itself.\n- `repositories`. This directory might not exist until [\"REPOSITORY INITIALIZATION\"](#repository-initialization) is finished, but it will contain local copies o fthe git repositories that contain the wiki's files.\n- `root/script`. This contains all the JavaScript files served by your site. You may add to these or customize to suit your needs.\n- `root/style`. This contains all the CSS stylseheets served by your site. You may add to these or customize to suit your needs.\n- `root/template`. This contains all the templates used to render the pages for your site. You may customize these to suit your needs.\n- `var/db/users`. This is the directory that will contain your user database. At this point, users are stored as a colleciton of [YAML](https://metacpan.org/pod/YAML) formatted files.\n\n# CONFIGURATION FILE\n\nMost of these commands (all except `yukki-setup`) look for a file named `etc/yukki.conf` in the current working directory. If this file is not found, the script checks for an environment variable named `YUKKI_CONFIG`, which should point to a [YAML](https://metacpan.org/pod/YAML) formatted configuration for your wiki site.\n\nIf no file is found, the script will stop and complain of an error.\n\nSee [Yukki::Settings](https://metacpan.org/pod/Yukki::Settings) and [Yukki::Web::Settings](https://metacpan.org/pod/Yukki::Web::Settings) for a complete list of configuration directives.\n\n# REPOSITORY INITIALIZATION\n\nOnce the site directory is setup, you will need to initialize each of the git repositories that will contain the files stored by the wiki.\n\nThis is most easily performed by running:\n\n    yukki-git-init foobar\n\nfor each of the repositories. This will create a git repository that contains a single commit containing a master index file. The name of this file and the branch that it belongs to is named in the [\"CONFIGURATION FILE\"](#configuration-file).\n\nIn addition to running this command, you may choose to run:\n\n    yukki-git-init foobar git://path/to/romote\n\nInstead of initailizing an empty reposotiry, it will clone the named remote repository into a local mirror. This is useful if you want to sync a repository between different sites. (As of this writing, Yukki provides no help for this, but git already provides all the tools you need to do it.)\n\nThis latter command is similar to running:\n\n    git clone --mirror git://path/to/remote repositories/foobar.git\n\n# CREATE USERS\n\nFinally, to use Yukki, you will need one or more users with access to get into your wiki. The simple way to do this is to run:\n\n    yukki-add-user\n\nThe script will ask you for information to create each user. You can then lookup the user files and edit them if you need to make later modifications.\n\n# AUTHOR\n\nAndrew Sterling Hanenkamp \u003chanenkamp@cpan.org\u003e\n\n# COPYRIGHT AND LICENSE\n\nThis software is copyright (c) 2017 by Qubling Software LLC.\n\nThis is free software; you can redistribute it and/or modify it under\nthe same terms as the Perl 5 programming language system itself.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzostay%2Fyukki","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzostay%2Fyukki","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzostay%2Fyukki/lists"}