{"id":15042316,"url":"https://github.com/gitgnu/gnu_oddmuse","last_synced_at":"2026-01-18T18:02:27.941Z","repository":{"id":84520934,"uuid":"90389275","full_name":"gitGNU/gnu_oddmuse","owner":"gitGNU","description":null,"archived":false,"fork":false,"pushed_at":"2017-05-05T15:16:37.000Z","size":6550,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-04T01:14:07.040Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitGNU.png","metadata":{"files":{"readme":"README.creole","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2017-05-05T15:16:30.000Z","updated_at":"2022-07-19T18:43:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"a6456326-8b4a-447c-a3c1-49e562e7ff69","html_url":"https://github.com/gitGNU/gnu_oddmuse","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitGNU%2Fgnu_oddmuse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitGNU%2Fgnu_oddmuse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitGNU%2Fgnu_oddmuse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitGNU%2Fgnu_oddmuse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitGNU","download_url":"https://codeload.github.com/gitGNU/gnu_oddmuse/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247103307,"owners_count":20884023,"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-09-24T20:47:07.178Z","updated_at":"2025-04-04T01:14:13.099Z","avatar_url":"https://github.com/gitGNU.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"This is the README file distributed together with the\n[[https://oddmuse.org/|Oddmuse]] script.\n\n== Installing Oddmuse on a Debian System running Apache\n\nThe following instructions require a number of tools. You can make sure\nthey're all installed by issuing the following command as {{{root}}}:\n\n{{{\napt-get install coreutils apache2 sudo wget w3m perl \\\n    libwww-perl libxml-rss-perl diffutils\n}}}\n\nYou probably created an account for yourself. You might have to add this\nuser to the {{{sudo}}} group. Here's how I created my own user as\n{{{root}}}:\n\n{{{\nadduser alex\nusermod -a -G sudo alex\n}}}\n\nNow you can login as {{{alex}}} and do everything else using {{{sudo}}}.\n\nYou need to copy wiki.pl into your cgi-bin directory, and you need to\nmake the script executable. You might also have to change its owner to\nan appropriate user on your system.\n\n{{{\nsudo wget -O /usr/lib/cgi-bin/wiki.pl \\\n  http://git.savannah.gnu.org/cgit/oddmuse.git/plain/wiki.pl\nsudo chmod +x /usr/lib/cgi-bin/wiki.pl\nsudo chown www-data.www-data /usr/lib/cgi-bin/wiki.pl\n}}}\n\nIf you're on SUSE, the user might not be {{{www-data}}} but\n{{{wwwrun}}} without appropriate group:\n\n{{{\nsudo chown wwwrun.root /usr/lib/cgi-bin/wiki.pl\n}}}\n\nYou should be able to test it right now! Visit\n{{{http://localhost/cgi-bin/wiki.pl}}}. If your site is available from\nthe outside, you will be able to use a normal browser. If don't have a\ndomain name yet, you'll probably have to use a text browser like\n{{{w3m}}}.\n\n{{{\nw3m http://localhost/cgi-bin/wiki.pl\n}}}\n\nIf you create pages in this wiki, these will get stored in a temporary\ndirectory. You need change the data directory from {{{\"/tmp/oddmuse\"}}}\nto like {{{\"/var/local/oddmuse\"}}}. The best way to do this without\nchanging {{{wiki.pl}}} is by editing\n{{{/etc/apache2/sites-available/default}}}. Add the following line:\n\n{{{\nSetEnv WikiDataDir /var/local/oddmuse\n}}}\n\nEnable the default site by calling the following command:\n\n{{{\nsudo a2ensite default\n}}}\n\nReload the Apache configuration by calling the following command:\n\n{{{\nsudo service apache2 reload\n}}}\n\nYou need to create the new data directory. You webserver runs CGI\nscripts as {{{www-data}}}. Thus, you need to change the owner and group\nof the directory to {{{www-data}}}.\n\n{{{\nsudo mkdir -p /var/local/oddmuse\nsudo chown www-data.www-data /var/local/oddmuse\n}}}\n\nDone! Visit your wiki and start editing. Click on the edit link (the\nfirst link below the navigation bar, at the bottom of the page). This\nwill allow you to enter some text for this page. Click the Save button\nand you are done.\n\nTo add new pages, edit the homepage and add links to new pages by\nputting their names in {{{[[double square brackets]]}}}.\n\nEnjoy your wiki experience.\n\nVisit https://www.oddmuse.org/ to learn more about the translation\nfiles and modules that are part of this package.\n\n== Apache\n\nIf you think this information doesn't work for you, here are some things\nto check.\n\nApache's config directory is {{{/etc/apache2/apache2.conf}}}. This is\nwhere we get the {{{www-data}}} username from. It says:\n\n{{{\n# These need to be set in /etc/apache2/envvars\nUser ${APACHE_RUN_USER}\nGroup ${APACHE_RUN_GROUP}\n}}}\n\nChecking {{{/etc/apache2/envvars}}} we see the following:\n\n{{{\nexport APACHE_RUN_USER=www-data\nexport APACHE_RUN_GROUP=www-data\n}}}\n\nSo that's what we're using in the {{{chown}}} command in our\ninstructions above.\n\nThe default site is configured in\n{{{/etc/apache2/sites-available/default}}}. In order for it to be\n//enabled//, there must be a symlink from a file in\n{{{/etc/apache2/sites-enabled}}} to the file in\n{{{sites-available}}}. You can enable it using the following command:\n\n{{{\nsudo a2ensite default\n}}}\n\nThis file also lists the directories we've used in our instructions\nabove.\n\n{{{\nScriptAlias /cgi-bin/ /usr/lib/cgi-bin/\n}}}\n\nThis means that {{{http://localhost/cgi-bin/wiki.pl}}} will call\n{{{/usr/lib/cgi-bin/wiki.pl}}}\n\nDon't forget to reload the Apache configuration as shown above, or\nsimply restart it all:\n\n{{{\nsudo service apache2 graceful\n}}}\n\n== License\n\nPermission is granted to copy, distribute and/or modify this document\nunder the terms of the GNU Free Documentation License, Version 1.1 or\nany later version published by the Free Software Foundation.\n\nThis program is free software; you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation; either version 2 of the License, or (at\nyour option) any later version.\n\nThis program is distributed in the hope that it will be useful, but\nWITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU\nGeneral Public License for more details.\n\nBoth the GNU Free Documentation License, and the GNU General Public\nLicense are distributed together with this script. See the files\n[[https://github.com/kensanata/oddmuse/blob/master/FDL|FDL]] and\n[[https://github.com/kensanata/oddmuse/blob/master/GPL|GPL]],\nrespectively.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitgnu%2Fgnu_oddmuse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitgnu%2Fgnu_oddmuse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitgnu%2Fgnu_oddmuse/lists"}