Webshare安装说明文件（中文翻译）

按：觉得东西不错，就翻译了，0.6的，现在是0.8a，还没新的英文文档，法语看不懂。不知道为什么被墙了，访问主页得翻

这个文档与0.6版本保持一致，作为一个临时的基础文件提供，并随着升级进行更新。

WebShare－安装－简体中文

=========================

当你已经下载这个压缩包，你应该找到下面这些内容：

在根目录下：COPYING, README

> index.php 身份验证表单

> start.php 基本的html元素的浏览器

> ident.php 私有的身份验证脚本

> identpublic.php 公共的/自动身份验证脚本

> admin 用户和共享管理员相关程序（译者注：缺少/，也是个文件夹）

> cgi-bin/ CGI脚本，存放于服务器同名文件夹中

> Documents/ 默认的共享目录

> style/ 接口内容的样式（皮肤）存放在子文件夹中

> lang/ 语言文件

> moteur/ 应用程序功能所需的脚本

> moteur/xsl/ XSLT 显示模板

> wstemp/ 用于上传文件的临时文件夹

> wspasswd/ 受保护的文件夹，包含配置文件

> action.php 文件和文件夹的主要操作功能

> script.php Webshare 的核心、通信和菜单

> explorer.php 生成文件夹树的基础脚本

> naviguer.php 生成文件夹内容的基础脚本

> auth.php 验证授权操作的基础脚本（安全基础）

> menus.conf.php 生成右键菜单

> fonctions.php 变量和循环函数

> zip.lib.php 管理压缩包

> apercu.php 用于图片显示的框架

> pic.php 生成缩略图和图片的显示

PHP文件：upload和upload_progress管理文件上传

PHP文件： coller (粘贴), commenter (评论), change_style (接口样式显示), crea_dossier (文件夹创建), crea_fichier (文件上传), crea_fond (背景显示), crea_lien (连接创建), crea_txt (文件创建), enregistrer (保存), exif (exif 信息), ouvrir (打开), rechercher (搜索), renommer (重命名), supprimer (删除), dezipper (解压缩文件), editer (编辑文本文件), ouvrir (open), 所实现的功能对应着各自的名称。

Prive.php 和public.php 脚本实现授权私有用户和公共用户访问。

WebShare 应用程序需要读/写以下在安装目录下文件夹的权限：Documents、wspasswd、wstemp

复制

=====

将文件夹webshare和其内部的所有文件复制到你所需要的目录中。

如果你的服务器能够运行CGI教办呢，复制名叫upload.cgi的脚本到你的CGI文件夹（通常叫做cgi-bin）中,修改权限为“755”(rwxr-xr-x)。另一方面，在上传文件的窗口中将显示一个上传文件大小限制的标识。

配置

====

在这一部分，应用程序已经可以使用了。当你使用浏览器访问Webshare时，你需要使用默认的帐号登录：

用户名：root

密码：root

无论如何，强烈推荐修改这个登录信息，特别是有其他可以访问到你的Webshare文件夹的时候。配置账户（权限和连接），请使用浏览器打开位于webshare目录下的admin目录。这时出现管理员面板登录。你也可以手动创建和编辑配置文件。

自动版本

=========

增加一个新的共享文件夹

-----------------------

同任何fpt软件一样，你必须指定一个服务器和文件夹（共享点）,Webshare将进行连接。

在在现阶段，WebShare v0.6中仅仅实现了本地连接（你只能在安装程序的服务器上创建一个共享文件夹）。

远程模式（ftp）

--------------

在当前阶段，仅仅实现了本地连接。

本地模式

---------

你必须指定你服务器上将使用Webshare共享的文件夹（共享点）。默认下，Webshare安装文件夹下的Documents文件夹将被打开。你可以在其中创建共享点，或者在安装文件夹之外创建，在任何你喜欢的位置创建都可以，但确保你选择的文件夹你拥有足够的权限。也可以为每个用户创建许多共享点。

注意：这个配置取决于你服务器的安全性

确认在Webshare中你选择的文件夹不是服务器上的敏感文件家，或者应用程序专用的文件夹。

下面说明建立连接需要指定的内容：

服务器根目录：（可选，如果留空，根目录将采用默认值）你可以指定任何一个你需要的文件夹。

当你为服务器根目录指定“$mydoc$”时，Webshare下文件夹Documents将称为共享点。

虚拟目录：指定连接的根目录，在服务器根目录下，可以留空。用户将仅能看到这个目录及其子目录和文件。

默认文件夹：用户打开连接的默认位置。一般是虚拟目录的一个子文件夹，用户可以向上返回直到根目录，可以留空。

服务器地址，登录/密码以及端口，如果你使用本地连接则可以留空。

若修改是有效的，消息“已经改变”将在管理员面板上端显示。

通过选择共享点名称，然后点击“删除”，你可以从列表中删除它（此共享点将不在可用）

创建新用户

----------

指定名字/登录帐号/用户密码/组。选择（管理员/组/访问者）中的一个，用户将被赋予的操作权限和文件访问范围。

你能够在需要的时候更新有关权限的修改（读、写、修改等）

重要提示：要为你要连接的服务器至少选择一个共享点，你必须预先指定。

你可以指定用户可见/可用的文件类型，修改过滤器即可。

为用户选择语言、界面类型、排序方式和其他外观方面的样式

鼠标点击应用按钮，配置文件将会更新。

如果你打算开放公用，你需要创建一个名为“visitor”的帐号，并将默认的页面“index.php”转换为“indexpublic.php”。当然那，推荐将这个用户配置为较少权限的用户。

如果更改有效，“更改已经生效”这一信息将显示在管理员控制面板顶部。

需求

-----

对于更高的安全性，如果你确定不再使用管理员，请用你的ftp软件删除软件目录下的admin文件夹，这样帐号将不能修改。

如果你需要常规的管理员功能，保持这个文件夹，请重命名这个文件夹，并且不要忘了在文件.htaccess中对这个文件夹进行授权访问。

手动版本

=========

配置文件采用.INI格式，这个配置位于Webshare安装目录中的/wspasswd/conf.ini中，并包含如下内容。

必须索命在用户和文件定义开始的部分

*对于共享点，名称（name）属性必须预先定义

*对于用户，名称(name)属性必须按实际填写

内容必须按照传统格式填写

变量名=变量值

注意：不要有特殊拼写、空格，也不要有非法字符。注意不要敲错。仅仅使用字符数字作为名称。

可以有许多用户共享和共享点。

举例说明（“//”和后面的评论在真正的文件中不存在）

###########################################################################

[#Maison] // 服务器记录名称

typeServeur= 1 // 1: 本地, 2: FTP(尚未实现)

nomServeur= Home // 服务器名称

rootServeur= /www // 服务器根目录

repServeur= /home // 服务器记录的根文件夹

[Visiteur] // 用户记录名称

typeUser= 3 // 1: 管理员, 2: 群组, 3: Public

nomUser= Visitor // 用户名

logUser= visitor // 登录名

passUser= cd05b04c66 // 密码 (MD5加密)

timeUser= 180 // 会话时限 (尚未实现)

serveur0= Home // 可访问的第一个服务器

serveur1= Home // 可访问的第二个服务器

langUser= English // 语言，必须匹配语言文件

styleUser= Cosy // 外观风格，必须是已经存在的外观风格

arboUser= 0 // 默认事发后显示目录树

visuUser= miniatures // 默认显示方式

triUser= nom // 默认裴絮方式

webUser= 1 // 当打开一个文件夹自动现实web内容

clicl= 0 // 左键点击动作

clicr= 1 // 右键点击动作

clicd= 1 // 双击动作

auth1= on // 用户可以读取文件

auth2= on // 用户可以创建或上传文件

auth3= on // 用户可以修改文件

auth4= on // 用户可以移动或复制文件

auth5= on // 用户可以删除文件

auth6= on // 用户可以更改文件权限

auth7= on // 用户可以加入评论

varsUser= ... // 过滤器用于隐藏一些文件

recoUser= ... // 过滤用于已知扩展名的文件类型

###########################################################################

连接

=====

输入你的登录名进行登录（登录名和密码应与在管理员面板中的输入一致），连如你的帐号。如果有错，将立刻出现“登录失败”的消息。否则应用程序开始装载并且现实浏览器框架。

Webshare －工具

==================

界面

========

根据用户帐号的配置，共享点目录树应该位于浏览窗口的左侧栏，内容则出现在中心区域。

地址栏（在顶端）包含了当前文件夹的路径，主要的工具则位于右侧。状态栏在底部，显示文件夹和文件数量，使用间隔分隔，显示当前用户的账户名。

点击一个文件，在浏览器中打开它。右键菜单会根据所选择的文件给出对应的选项。如果没有权利读写文件，文件名右侧将出现一个锁的图案，此时，文件不能打开。

在目录树面板中，共享点分别显示，标签不能更改，并指示出服务器类型（房子图标表示本地连接，世界地图表示一个远程的ftp，加上叉的表示无法连接）。目录树的节点有一个虚拟根介节点，显示“+”表示可以访问子文件夹，点击“－”则隐藏所有的子文件夹。

如果文件夹"Corbeille"存在标签bin可以显示，但这个选项还没有实现。

在浏览器面板中打开的文件夹在目录树上将高亮显示。

在文件浏览器中，文档显示为一系列图标的列表。

图标表示选中与未选中的状态，文件爱你的名字，大小和类型，还包括日期和评论。也可以在名称pangiban显示一些指示器，如下：

[黄色阻止警告] 只读

[蓝色阻止警告] 只写

[红色阻止警告] 文件已经锁定

[蓝色箭头] 意味着文件是一个web快捷方式

[橘色水泡] 表示文件有一个或多个评论

[黄色星] 表示文件是收藏中（尚未实现）

[红色面板] 表示文件被其他用户修改（尚未实现）

导航

=====

采用左键在文件上点击（默认）执行与文件的操作（例如，打开文件，浏览文件夹）。附加选项可以通过右键菜单（在文件或文件夹上点击右键或双击，默认行为）。

在右键菜单中，第一个选项显示默认操作，可以通过选择类似选项和其他可能执行的选项来执行命令。

拖拽一个元素到文件夹上可以将它移动到这个文件夹下。当前，还不能一次选择多个文件进行这个操作。

右键在面板空白区域点击显示一个和文件夹有关的操作。

并非所有在文件夹中存在的文件都需要显示：

Webshare通过在管理员面板中定义正则表达式过滤器过滤元素。如果文件名或文件名的一部分与定义的过滤器匹配，这个文件将不会被显示。

默认的过滤器包含了各种能够引起安全问题的文件：PHP脚本，HTAccess文件等。

不同的文件显示方式

===================

四种文件显示方式可用：

*缩略图 ：显示缩略图（如果有）和概要信息，

*大图标 ：显示大图标和完整信息

*列表 ：小图标和摘要信息

*详细 ：小图标和完整信息

不同的文件排序方式

===================

五种不同的排序方法可用：

*文件名 ：根据文件名字母顺序排列

*数值 ：基于文件名的数值，如果有的话

*日期 ：基于日期顺序

*大小 ：基于文件大小

*类型 ：基于文件类型

无论采用何种排序方式，文件夹始终在一起并排列在文件之前。

创建一个新文件夹

=================

通过菜单条上的“新文件夹”选项或通过右键菜单执行同样的命令，这时会询问文件夹的名字。只要命名。有效且拥有权限，一个新的文件夹将创建。

创建一个新链接

===============

通过在菜单栏的新链接或右键菜单同名选项创建，之后会询问新链接的名称和链接的地址。只要有效且拥有权限，新链接将被创建。

单击链接快捷方式将在一个新窗口或新标签内打开指定的地址。

如果链接指向一个网站，缩略图会显示网站页面的缩略图（如果网站可用）。

如果链接指向一张图片，缩略图将显示这张图片的缩略图。

如果链接指向另外的元素，图标将显示和目标一样的类型。

如果链接指向一个RSS留，这个流将直接显示在Webshare中。

文件上传

=========

弹出窗口显示一个菜单栏和文件选择框。选择你要上传到服务器上的元素。如果元素是一个压缩包，复选框允许你直接上传这个文件或是在服务器上解压缩。

单击按钮“开始上传”将显示一个进度条显示当前进度，允许你跟踪文件上传的进度。上传结束后，一个或多个文件被加到浏览器面板中。

如果要装载其他元素，点击“加入文件”。下面会出现一个新的文件选择框。你可以增加你需要的文件而不需要等待上传结束。你也可进行其他操作，把上传作为后台任务。

如果你的服务器配置CGI脚本，上传将工作在“降级”模式。在这个模式下，上传大小限制于服务器的默认尺寸，一般是几兆。一个信息栏将在上传弹出窗口上端显示你可以上传的最大文件大小。上传没有进度条也没操作的状态信息。

创建空文本文件

================

选项“新空文本”允许创建一个空文件，这个文件可以进行编辑，这得益于可选的编辑器。一旦命名并生效，且有相应的权限，空文本将被创建。

复制文件和文件夹

=================

选择一个文件或文件夹并打开右键菜单。选择“复制”选项，然后打开目标文件夹，在右键菜单中选择“粘贴”。如果命名并生效，且有足够的权限，文件会被复制，若是文件夹，文件夹和其内容一同被复制。

移动文件和文件夹

=================

选择一个文件或文件夹并打开右键菜单。选择选项“剪切”，然后打开目标文件夹，在右键菜单中选择“粘贴”。如果命名并生效，且有足够的权限，文件会被移动，若是文件夹，文件夹和其内容一同被移动。这个操作可以通过拖拽更快地完成。

重命名文件

===========

选项“重命名”允许重命名文件或文件夹（文件扩展名也可以修改）。如果命名并生效，且有足够的权限，文件会被重命名。

删除文件

=========

在文件或文件夹中的右键菜单中选择“删除”，将弹出一个面板要求你确认。如果有效且有足够的权限，文件或者文件夹将被删除。

回收站选项将在下一个版本实现。被删除的文件在被彻底删除之前会被移动到回收站中等待被恢复。

添加/显示评论

============

选择一个文件或文件夹，在右键菜单中选择“添加评论”。将显示一个文本框，用户可以在其中添加评论。一旦命名且有效，文件名右侧将显示一个气泡图标。如果鼠标移动到这个图标上，可以显示评论预览，点击这个图标会在文本框内显示一个完整的版本。评论也可以在属性面板显示。

编辑文本文件或网页

==================

如果安装了可选编辑器，右键菜单“编辑”就可以使用了。它运行文本编辑器直接在服务器上修改文件或网页。不会在你的终端上有临时记录。一句编辑器的不同，网页可以可视化模式编辑（wysiwyg）或源码（打算在选中使用FCKeditor，更多信息请参考文档）。

显示文件或文件夹属性

====================

选择文件或文件夹，在右键菜单中选择“属性”。

左侧面板将显示并变为属性面板。能够显示的信息包括文件或文件夹的：名称、大小、权限、链接、评论和EXIF信息等。

增加背景图片

=============

在一个图片的右键菜单上选择“背景”。这个图片将被设置为此文件夹的背景（仅仅对这个文件夹有效）。

搜索文件或文件夹

================

在文件夹右键菜单中选择“搜索”，提供用于搜索的名称或表达式（此处可以使用正则表达式）。选择是否大小写敏感，然后开始搜索。左侧面板将显示为搜索面板。以图标。名称和服务器上的位置的方式显示所有的搜索结果。直接点击找到的文件或文件夹打开或显示。

显示图片

=========

Gif、Jpeg或Png图片可以在Webshare中直接打开：点击它或在其右键菜单中选择“查看”。浏览器将被新框架代替并在菜单栏上提供新的选项。

*手动幻灯片：左箭头和右箭头分别用于前后两个方向播放当前文件夹中的图片

*缩放：对图片进行缩小和放大

*幻灯片：自动进行幻灯播放

*打印：打印当前的图片

通过鼠标拖拽也可以移动图像进行浏览。点击位于菜单栏上的红色箭头关闭图片回到浏览界面。

其他图片格式将被下载，并根据扩展名通过推荐的关联的程序打开。附加图片格式会在Webshare未来版本中直接识别而不再进行下载。

打开文件

========

通过点击下载并根据扩展名在指定程序中打开。另一方面，文本文件、网页、flash阿五年间和PDF文件可以在Webshare自动打开。

打开链接

========

链接，有一个箭头表示，可以直接在Webshare打开。你可以很容易浏览你收藏的网站，在菜单栏点击红色箭头返回浏览器。

打开RSS流

=========

RSS流可以通过简单地点击在Webshare中打开。阅读完毕，你需要在菜单栏中点击红色箭头返回浏览器。

锁定/修改文件或文件夹权限

========================

在文件或文件夹的右键菜单中选择“修改属性”。

此时会显示一个包含当前文件权限的面板，包括：读取、写入、执行；以及每个用户类型:管理员、群组、访客、这些都是UNIC的标准的属性。

通过勾选或留空复选框来增加和删除授权。一旦确认且有足够的权限，文件或文件夹属性将被修改。

显示HTML网页

============

html网页可以通过点击直接在Webshare中直接打开，浏览完毕，你需要在菜单栏中点击红色箭头返回浏览器。

播放MP3文件

===========

点击MP3音频文件会在WebShare中运行一个Flash播放器，并且会自动播放。这个播放器可以进行播放，停止，切换暂停等操作，通过控制按钮和横向进度条可以完成这个功能。垂直栏可以进行音量调节。

保存文件

========

点击右键菜单“保存”选项可以直接保存选中的文件。

保存所有文件夹下的文件

======================

右键菜单中的“保存所有”选项能够将当前文件夹下的完整内容压缩成zip压缩文件整体下载（不包括子文件夹内容）。

打印文件夹中的内容

==================

文件夹右键菜单的“打印”选项将开始打印这个文件夹中的所有内容（不包括子文件夹内容）。当文件夹中包含成百的图片而你又想打印整个相册的时候，这个功能十分实用。

===========================================

请参考网站 http://www.webshare.fr/