Content-space.de

The WikiBlog of Michael Hamann about changing technologies and more

User Tools

Site Tools


projekte:dokufs

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
projekte:dokufs [2009/02/27 01:22] michituxprojekte:dokufs [2012/01/28 15:57] (current) – Some typos fixed michitux
Line 1: Line 1:
 ====== DokuFS ====== ====== DokuFS ======
- 
-//Dieser Artikel ist in Englisch geschrieben, da dieses Projekt ein internationales Publikum und ausschließlich Benutzer mit fortgeschrittenen Linuxkenntnissen anspricht.// 
  
 DokuFS is a filesystem that allows, with the help of [[wp>Filesystem_in_Userspace|Fuse]], to mount a [[doku>wiki:DokuWiki|DokuWiki]] over [[wp>XML-RPC]] into you local filesystem on Linux. DokuFS is a filesystem that allows, with the help of [[wp>Filesystem_in_Userspace|Fuse]], to mount a [[doku>wiki:DokuWiki|DokuWiki]] over [[wp>XML-RPC]] into you local filesystem on Linux.
  
-You are then able to browse the filesystem and to create, edit or delete files, that means to create, edit or delete pages on the Wiki you have mounted. Deleting, moving and copying of whole namespaces should work, too.+You are then able to browse the filesystem and to create, edit or delete files, that means to create, edit or delete pages or media files on the Wiki you have mounted. Deleting, moving and copying of whole namespaces should work, too (however the history of pages is not moved). 
 + 
 +All pages have the extension .dw so you can easily handle syntax highlighting (syntax highlighting for vim is included in the unfortunately discontinued [[https://github.com/chimeric/dokuwikixmlrpc|DokuVimKi]] project, though you don't need the rest of DokuVimKi when using DokuFS).
  
-All pages have the extension .dw so you can easily handle syntax highlighting (syntax highlighting for vim is included in [[http://www.chimeric.de/projects/dokuwiki/dokuvimki|DokuVimKi]], though you don't need the rest of DokuVimKi when using DokuFS). The creation of other files but those with the extension .dw isn't allowed (temporary files of some editors are handled by DokuFS). In a later version when the XML-RPC-API of DokuWiki supports media managementthe up- and download of media-files might be supported, too.+DokuFS supports two modes -- one for pages and one for media filesIn the mode for pages the creation of other files but those with the extension .dw isn't allowed (temporary files of VIM and Emacs are handled in memory). In the mode for media files every file is simply uploaded to the DokuWikiso basically all file types are allowed that are supported by your DokuWiki installation.
  
-Every 5 minutes, the recent changes of the Wiki are pulled and the directory-structure is updated. Once a page is downloaded it will be in a cache (with a memory limit) so that only the first read/size-request will be slow.+Every 5 minutes, the recent changes of the Wiki are pulled and the directory structure is updated. Once a page is downloaded it will be in a cache (with a memory limit) so that only the first read/size-request will be slow.
  
 ===== Some notes on the current version ===== ===== Some notes on the current version =====
Line 39: Line 39:
 ===== Installation ===== ===== Installation =====
  
-First of all you need a working [[http://www.ruby-lang.org|Ruby]]-installation and of course DokuWiki with enabled XML-RPC-backend.+DokuFS runs on Linux, it might work on Mac OS X and from all I know it doesn't work on Windows.
  
-The most tricky part is the installation of [[http://rubyforge.org/projects/fusefs/|FuseFS]]. The only Linux distributions I know that have packages or to be more correct: build-files for FuseFS, are [[http://packages.gentoo.org/package/dev-ruby/fusefs|Gentoo]] and [[http://aur.archlinux.org/packages.php?ID=4051|Arch Linux (AUR)]]. In all other cases there are instructions in README.txt which is distributed with FuseFS.+First of all you need a working [[http://www.ruby-lang.org|Ruby]]-installation and of course DokuWiki with enabled XML-RPC-backend (note that you need to enable it and set a user that can access the wiki over XML-RPC, allowing access for all users is **not** recommended).
  
-Then you can download {{:projekte:dokufs:dokufs.rb|dokufs.rb}} and make it executable with <code bash>chmod +x dokufs.rb</code>. You might want to put DokuFS in one of your directories in $PATH, this might be ~/bin/.+You need [[http://rubyforge.org/projects/fusefs/|FuseFS]] in order to use DokuFS. In Debian and Ubuntu (and derivates of them) it is provided in a package named ''libfusefs-ruby''. In Gentoo there is a package named [[http://packages.gentoo.org/package/dev-ruby/fusefs|fusefs]] and in ArchLinux it is in the [[http://aur.archlinux.org/packages.php?ID=4051|AUR]]. In all other cases there are instructions in README.txt which is distributed with FuseFS. 
 + 
 +You can download the latest version of DokuFS from its [[https://github.com/michitux/dokufs|git repository]]. You just need the file ''dokufs.rb'' and then you should make it executable with <code bash>chmod +x dokufs.rb</code>. You might want to put DokuFS in one of your directories in $PATH, this might be ~/bin/.
  
 ===== Usage ===== ===== Usage =====
Line 70: Line 72:
 If there are any further questions or requests, you may contact me using comments here or you can send me an email at michael <at> content-space.de. Jabber is available, too, the address is the same as my email-address. If there are any further questions or requests, you may contact me using comments here or you can send me an email at michael <at> content-space.de. Jabber is available, too, the address is the same as my email-address.
  
-{{tag>dokuwiki fuse filesystem ruby}} + 
-~~LINKBACK~~ + 
-~~DISCUSSION~~+
projekte/dokufs.txt · Last modified: 2012/01/28 15:57 by michitux