Saku - a clone of P2P anonymous BBS shinGETsu
Python JavaScript Other
Latest commit 502d328 Sep 20, 2016 @WhiteCat6142 WhiteCat6142 committed with fuktommy video tag (#11)
* video tag

* video tag fix

* video tag fix2

* video tag fix3
Permalink
Failed to load latest commit information.
doc debian 8.3 has python3-pil package Feb 29, 2016
file video tag (#11) Sep 20, 2016
jinja2
shingetsu fix mch post (#10) Aug 20, 2016
template
tests
tool fix skip mkrss bug when last-modified is empty Mar 15, 2015
www
.gitignore merge js and css files. Jan 5, 2014
LICENSE add markdown extension Nov 27, 2015
Makefile make makefile faster Apr 14, 2014
README.md debian 8.3 has python3-pil package Feb 29, 2016
saku.py
setup.py add markdown extension Nov 27, 2015

README.md

Saku - a clone of P2P anonymous BBS shinGETsu

Authors

  • (main) Satoshi Fukutomi fuktommy@shingetsu.info
  • sbwhitecap
  • (apollo) replaceable anonymous.
  • (2ch interface) kkka
  • (thumbnail patch) A shinGETsu user.
  • (imghdr patch) A shinGETsu user.
  • (js extensions) shinGETsu users.
  • (markdown extension) WhiteCat6142

Contributers

  • (run_cgi) Python Software Foundation.
  • (Jinja2) the Jinja Team.
  • (MarkupSafe) Armin Ronacher and contributors.
  • (jQuery) The jQuery Foundation.
  • (Twitter Bootstrap) Twitter.
  • (jQuery Lazy) Daniel 'Eisbehr' Kern
  • (Spoiler Alert) Joshua Hull, Jared Volpe, Dwayne Charrington
  • (marked) Christopher Jeffrey

WebSite

Saku stands for "Shingetsu Another Keen Utility". Both the word "saku" and "shingetsu" mean the new moon in Japanese.

Agreement

Agree following terms and join shinGETsu network.

  • Descrive your license in your articles. Or they are open, public and/or free: anyone can use, modify and/or distribute them.
  • Do not use the network for illegality.
  • Do not use the network at the cost of othor peolpe.

Description

  • Saku is a P2P anonymous BBS works on Python.
  • We confirm that Saku works on CPython 3.2 on GNU/Linux. Saku may not work on MacOS(ver.9 or before).
  • The features of shinGETsu are...
    • 2ch.net style interface
    • Wiki style hyperlink
    • IRC style cache
    • Uploader

Saku requires

  • Python (ver.3.2 or later)
  • Jinja2 (ver.2.6) if you install Saku
  • markupsafe (ver.0.19 or later) if you install Saku
  • PIL or Pillow (Python Imaging Libraty) if you need
  • Supervisor if you need

Usage Saku without install

  1. Open port 8000/tcp.
  2. Edit file/saku.ini.
  3. Start with % python ./saku.py -v
  4. Browse http://localhost:8000/.
  5. Stop with ^C.

Usage Saku with install

  1. Install Jinja2.
  2. Open port 8000/tcp.
  3. Compile and install.

    # make install
    

    You can use PREFIX option for make, and use setup.py directly. If your system do not read modules in /usr/bin/local, do

    # ln -s /usr/local/lib/python3.2/site-packages/shingetsu \
            /usr/lib/python3.2/site-packages
    
  4. Configration files are installed into /usr/local/share/doc/saku/sample. You shoud install them:

    # cp init.sample /usr/local/etc/init.d/saku
    # cp saku.ini /usr/local/etc/saku/saku.ini
    

    and so on. If you use Supervisor, install supervisor.sample instead of init.sample. The paths of config files are set in saku.ini, they are in /usr/local/etc/saku by defaults. saku.ini are loaded from following paths and the later settings have a priority.

    * /usr/local/etc/saku/saku.ini
    * /etc/saku/saku.ini
    * ~/.saku/saku.ini
    
  5. Setup user and directories refering config files.

  6. Start with

    # /usr/local/etc/init.d/saku start
    
  7. Browse http://localhost:8000/.

  8. Stop with

    # /usr/local/etc/init.d/saku stop
    
  9. Run /usr/local/bin/saku for user application.

How to Insatall Required Packages on Debian GNU/Linux 8.3

  1. sudo aptitude install python3 python3-jinja2 python3-pil

Acknowledge

  • The design is made referring to Vojta and Winny.
  • I learned how to handle file name from YukiWiki written by Hiroshi Yuki.
  • Module apollo.py is was made referring to apollo.c written by replaceable anonymous.
  • Popup JavaScript was made referring to Kindan-no Tubo by Zero corp.
  • XLST was made reffring to Landscape.