Personal CMS - BCWB (XSL, FileFlat) Files

Readme.Ru.txt

BCWB: Ñèñòåìà óïðàâëåíèÿ ñîäåðæàíèåì äëÿ âèçèòíûõ âåá-êàðò
Copyright © 2004 Dmitry Sheiko
Ñàéò ïðîåêòà: http://bcwb.cmsdevelopment.com


ÎÃËÀÂËÅÍÈÅ

ÎÃËÀÂËÅÍÈÅ			1
ÂÑÒÓÏËÅÍÈÅ			1
ÏÐÅÈÌÓÙÅÑÒÂÀ			2
ÑÈÑÒÅÌÍÛÅ ÒÐÅÁÎÂÀÍÈß		2
ÈÍÑÒÀËËßÖÈß È ÓÑÒÀÍÎÂÊÀ		2
ÍÀ×ÀËÎ ÐÀÁÎÒÛ (Hello world!)	3
ÑÎÇÄÀÍÈÅ ØÀÁËÎÍÎÂ ÏÐÅÄÑÒÀÂËÅÍÈß	3
ÑÏÅÖÈÀËÜÍÛÅ ÂÎÇÌÎÆÍÎÑÒÈ		4
ÂÎÇÌÎÆÍÛÅ ÍÅÏÎËÀÄÊÈ		4
ÇÀÊËÞ×ÅÍÈÅ			4


ÂÑÒÓÏËÅÍÈÅ

Ïðåæäå âñåãî, ìíå õîòåëîñü ïîáëàãîäàðèòü Âàñ çà ïðîÿâëåííûé èíòåðåñ ê ìîåé ðàçðàáîòêå. BCWB – ñâîáîäíî ðàñïðîñòðàíÿåìîå â ñîîòâåòñòâèè ñ óñëîâèÿìè ëèöåíçèè GNU (ñì. ôàéë Licence.Ru  â êîìïëåêòå ïîñòàâêè) ïðîãðàììíîå îáåñïå÷åíèå ñ îòêðûòûì êîäîì (Open Source).  Äàííàÿ ïðîãðàììà ïðåäñòàâëÿåò ñîáîé WYSIWYG-ñèñòåìó óïðàâëåíèÿ ñîäåðæàíèåì (CMS) äëÿ âèçèòíûé âåá-êàðò, ïåðñîíàëüíûõ ñàéòîâ, ïðîìî-ñàéòîâ, VIP-ñàéòîâ è ïðî÷èõ íåáîëüøèõ âåá-ïðîåêòîâ. ß äëèòåëüíîå âðåìÿ çàíèìàþñü ðàçðàáîòêîé ðàçëè÷íûõ ñèñòåì óïðàâëåíèÿ âåá-êîíòåíòîì êîðïîðàòèâíûõ èíôîðìàöèîííûõ ïðîñòðàíñòâ. Îäíàêî èíñòàëëèðîâàòü ëþáóþ èç ïîäîáíûõ ñèñòåì äëÿ ðåàëèçàöèè ñîáñòâåííîãî ïåðñîíàëüíîãî ñàéòà íå ïðåäñòàâëÿåòñÿ ìíå ðåíòàáåëüíûì. Ýòî âñå ðàâíî, ÷òî ñòðåëÿòü èç ïóøêè ïî âîðîáüÿì. Ïîýòîìó ÿ ðàçðàáîòàë ìèíèàòþðíóþ WCM-ñèñòåìó, ñ ìèíèìàëüíûìè ñèñòåìíûìè òðåáîâàíèÿìè. BCWB äàæå íå òðåáóåò íàëè÷èÿ áàçû äàííûõ (!). Íî â òîæå âðåìÿ ìíå õîòåëîñü ñäåëàòü äàííóþ ñèñòåìó ìàêñèìàëüíî ãèáêîé è óíèâåðñàëüíîé.  ðåçóëüòàòå ÿ âûáðàë â êà÷åñòâå íîñèòåëÿ äàííûõ ôîðìàò XML, à â êà÷åñòâå óïðàâëåíèÿ ïðåäñòàâëåíèåì äàííûõ XSLT (http://www.w3.org/TR/xslt).  ðåçóëüòàòå ñàéòó, ñîáðàííîìó â BCWB, ìîæíî çàäàòü ëþáóþ ôîðìó ïðåäñòàâëåíèÿ ñ ïîìîùüþ áîãàòûõ ôóíêöèîíàëüíûõ âîçìîæíîñòåé XSLT, âêëþ÷àÿ âåêòîðíî-ãðàôè÷åñêîå ïðåäñòàâëåíèå â ôîðìàòå SVG (http://www.w3.org/TR/SVG11/). Êðîìå òîãî, XML óíèâåðñàëåí, è âû ìîæåòå óïðàâëÿòü â BCWB ñîäåðæàíèåì ñàéòà, îòîáðàæàåìîãî, ñêàæåì, â Macromedia Flash. È, áåçóñëîâíî,  ïîäîáíàÿ ñèñòåìà äîëæíà áûëà áû óäîâëåòâîðÿòü ôóíêöèîíàëüíûì òðåáîâàíèÿì ïåðñîíàëüíîãî ñàéòà. Âñå ýòè çàäà÷è óñïåøíî ðåøàåò BCWB.  

Áîëåå ïîäðîáíóþ èíôîðìàöèþ î BCWB Âû ñìîæåòå ïîëó÷èòü íà ìîåì ñàéòå www.cmsdevelopment.com

ÏÐÅÈÌÓÙÅÑÒÂÀ 

·	Ìèíèìàëüíûå òðåáîâàíèÿ ê õîñòèíã-ïðîâàéäåðó (Apache+PHP+200KB äèñêîâîãî ïðîñòðàíñòâà ïîä BCWB + ðàçìåð ñîäåðæàíèÿ Âàøåãî ñàéòà). Ýêîíîìèÿ íà íåäîðîãîì òàðèôíîì ïëàíå äëÿ Âàøåãî ñàéòà.
·	Ëåãêîñòü â óïðàâëåíèè ñîäåðæàíèåì. Â ñèñòåìå ðåàëèçîâàíî ïðÿìîå âèçóàëüíîå (WYSIWYG) ðåäàêòèðîâàíèå ñòðàíèö ñàéòà. Èìååòñÿ èíòåðôåéñ äîáàâëåíèÿ è çàãðóçêè èçîáðàæåíèé, ôàéëîâ, ñîçäàíèÿ ñêðûòûõ âëîæåííûõ ñòðàíèö.
·	Êà÷åñòâåííàÿ àäðåñàöèÿ ñòðàíèö. URL êàæäîãî äîêóìåíòà êîððåêòíî îòðàæàåò åãî èåðàðõè÷åñêóþ ïðèíàäëåæíîñòü.
·	Ìîäóëüíîñòü. Âû ìîæåòå ñàìîñòîÿòåëüíî çàäàòü íåîáõîäèìîå Âàì ÷èñëî êîíòåíò-áëîêîâ íà ñòðàíèöå â ñîïðîâîäèòåëüíîì XSLT-øàáëîíå.
·	Óíèâåðñàëüíûé ÿçûê (XSLT) óïðàâëåíèÿ ôîðìàòèðîâàíèå îòîáðàæåíèÿ äàííûõ.
·	Ïëàòôîðìà íåçàâèñèìûé ôîðìàò ïðåäñòàâëåíèÿ äàííûõ. Âîçìîæíîñòü ïóáëèêàöèè  â SGV/SMIL, Flash, PDF.

ÑÈÑÒÅÌÍÛÅ ÒÐÅÁÎÂÀÍÈß

Ñåðâåð:
- 	Apache Web Server / ñ âêëþ÷åííûì mod_rewrite / (http://www.apache.org)
-	PHP version 4.1.x  (http://www.php.net)
-	Ðåêîìåíäóåòñÿ Sablotron (http://www.gingerall.com/) (xslt ðàñøèðåíèå äëÿ PHP) 

Ñèñòåìà êîððåêòíî ðàáîòàåò êàê íà ïëàòôîðìå UNIX, òàê è ïîä óïðàâëåíèåì Windows
-- ÈÑÏÛÒÀÍÈß ÏÐÎÂÎÄÈËÈÑÜ ÍÀ ÑÅÐÂÅÐÀÕ ÕÎÑÒÈÍÃ-ÏÐÎÂÀÉÄÅÐÀ http://n1.by

Êëèåíò: 
     
-	MS Internet Explorer 5.x (ðåêîìåíäóåòñÿ âåðñèÿ 6)

ÈÍÑÒÀËËßÖÈß È ÓÑÒÀÍÎÂÊÀ

ÂÍÈÌÀÒÅËÜÍÎ ÑËÅÄÓÉÒÅ ÈÍÑÒÐÓÊÖÈßÌ È ÂÛ, ÂÎÇÌÎÆÍÎ, ÑÎÁÅÐÅÒÅ ÑÂÎÞ ÂÈÇÈÒÍÓÞ ÂÅÁ-ÊÀÐÒÓ ÇÀ Ñ×ÈÒÀÍÍÛÅ ÌÈÍÓÒÛ.


Ñîçäàéòå äîìåí (ñàáäîìåí) äëÿ ïðîåêòèðóåìîãî ñàéòà. Ðàñïàêóéòå â åãî HTTPDOCS-ïàïêó àðõèâ bcwb.zip. Èçìåíèòå çíà÷åíèÿ êîíôèãóðàöèîííûõ ïåðåìåííûõ â ôàéëå config.inc.php. 

$http_path – http-àäðåñ ñàéòà (çàêà÷èâàÿ ñëåøåì) 
$default_charset – êîäèðîâêà
$FEEDBACK_EMAIL – âàø email
$admin_login – ëîãèí äëÿ óïðàâëåíèÿ ñîäåðæàíèåì
$admin_password – ïàðîëü äëÿ óïðàâëåíèÿ ñîäåðæàíèåì
$admin_subdomain – èìÿ ñàáäîìåíà äëÿ àâòîðèçàöèè â îáëàñòè àäìèíèñòðèðîâàíèÿ (ïî óìîë÷àíèþ “login”)

Òåïåðü íåîáõîäèìî óñòàíîâèòü ïðàâà äîñòóïà íà ïàïêó dcontent è íàõîäÿùèåñÿ â íåé ôàéëû 777, à òàêæå íà ôàéë script/structure.inc.php àòðèáóò 777.

ÍÀ×ÀËÎ ÐÀÁÎÒÛ (Hello world!)

Íàáåðèòå â àäðåñíîé ñòðîêå áðàóçåðà URL äëÿ Âàøåãî áóäóùåãî ñàéòà. Åñëè Âû âåðíî âûïîëíèëè èíñòàëëÿöèþ, òî óâèäèòå ñòðàíèöó “Hello World!”. Äëÿ âíåñåíèÿ ñòðóêòóðû è ñîäåðæàíèÿ ñàéòà ñëåäóåò ïåðåéòè â àäìèíèñòðàòèâíóþ îáëàñòü. Äëÿ ýòîãî äîáåðèòå ê àäðåñó Âàøåãî ñàéòà “login” è íàæìèòå Enter. Íà çàïðîñ àâòîðèçàöèîííûõ äàííûõ ñëåäóåò ââåñòè òå äàííûå, ÷òî Âû óêàçàëè â config.inc.php.  ñëó÷àå óñïåøíîé àâòîðèçàöèè Âû óâèäèòå ìåíþ ñèñòåìû. Äëÿ ðåäàêòèðîâàíèÿ ñîäåðæàíèÿ òåêóùåé ñòðàíèöû âûáåðèòå «Ðåäàêòèðîâàòü», äëÿ äîáàâëåíèÿ íîâîé ñòðàíèöû íàæìèòå «Äîáàâèòü ðàçäåë», äëÿ ñîçäàíèÿ âëîæåííîé ñòðàíèöû â òåêóùåì ðàçäåëå íàæìèòå «Ñîçäàòü ïîäðàçäåë». Äëÿ ïðîñìîòðà ñòðóêòóðû ñàéòà ìîæíî âûáðàòü ïåðåõîä «Ñòðóêòóðà».  õîäå ðåäàêòèðîâàíèÿ ñòðàíèöû Âû ìîæåòå âîñïîëüçîâàòüñÿ ìåíþ âèçóàëüíîãî ðåäàêòîðà (êíîïêà «+»). Êíîïêà «èçîáðàæåíèå»  ïîçâîëÿåò âñòàâèòü è çàãðóçèòü èçîáðàæåíèå ñ äèñêà, êíîïêà «ôàéë» ïîçâîëÿåò çàãðóçèòü ôàéë è âñòàâèòü â ñîäåðæàíèå ññûëêó íà íåãî, «äîêóìåíò»  - ïîçâîëÿåò ñîçäàòü ññûëêó íà âëîæåííóþ ñòðàíèöó, íåîòîáðàæàåìóþ â ìåíþ. Äëÿ ðåäàêòèðîâàíèÿ âëîæåííîé ñòðàíèöû ñëåäóåò ïåðåéòè ïî ññûëêå. 

BCWB ÷àñòè÷íî ïîääåðæèâàåò ñèíòàêñèñ ðàçìåòêè ññûëîê Wacko Wiki  (http://wiki.oversite.ru). Âû ìîæåòå çàäàâàòü íîâûå ññûëêè â ñèíòàêñèñå: ((variable Ñîäåðæàíèå ññûëêè))

ÑÎÇÄÀÍÈÅ ØÀÁËÎÍÎÂ ÏÐÅÄÑÒÀÂËÅÍÈß

Âû ìîæåòå ñîçäàòü íåîãðàíè÷åííîå êîëè÷åñòâî ñîáñòâåííûõ XSLT-øàáëîíîâ, è íàçíà÷àòü èõ ñòðàíèöàì ñàéòà. Øàáëîíû ðàçìåùàþòñÿ â ïàïêå dcontent. (ñì. øàáëîíû ïðèìåðîâ) Ïîñëå äîáàâëåíèÿ â ïàïêó ôàéëà ñ ðàñøèðåíèåì .xsl îí îòîáðàçèòüñÿ â âûïàäàþùåì ñïèñêå ïðè ðåäàêòèðîâàíèè ñòðàíèöû.

Âû ìîæåòå ñàìîñòîÿòåëüíî çàäàâàòü ôîðìàò îòîáðàæåíèÿ ñòðàíèö ñàéòà. Îäíàêî, Âàì ïðèäåòñÿ âíåñòè â êàæäûé øàáëîí ñïåöèàëüíûå òåãè BCWB:

<BCWB form=”start” /> - îòêðûòèå ôîðìû â íà÷àëå äîêóìåíòà
<BCWB form=”finish” /> - çàêðûòèå â êîíöå äîêóìåíòà
<BCWB content=”header” /> - óêàçàòåëü íà çàãîëîâîê ñòðàíèöû
<BCWB content=”ëþáàÿ_ïåðåìåííàÿ” /> - óêàçàòåëü íà áëîê ñîäåðæàíèÿ
<BCWB content=”ëþáàÿ_ïåðåìåííàÿ” /> - äîïîëíèòåëüíûé óêàçàòåëü íà áëîê ñîäåðæàíèÿ
..

Ïðè íåîáõîäèìîñòè ðàçìåùåíèÿ Feedback-ôîðì âîñïîëüçóéòåñü ñîîòâåòñòâóþùèì ïðèìåðîì XSLT-øàáëîíà. Ôóíêöèÿ, âûïîëíÿþùàÿ ïîñûëêó Email ðàñïîëîæåíà â ôàéëå include/startup/common_functions.inc.php.

Âû ìîæåòå èñïîëüçîâàòü â XSLT-øàáëîíå ðàçìåòêó SVG, ÷òî ïîçâîëèò îðãàíèçîâàòü ìàñøòàáèðóåìîå ãðàôè÷åñêîå ïðåäñòàâëåíèå ñòðàíèöû.

Îôèöèàëüíàÿ èíôîðìàöèÿ î XSLT http://www.w3.org/TR/xslt
Îôèöèàëüíàÿ èíôîðìàöèÿ î SVG http://www.w3.org/TR/SVG11/
Ïðèìåðû èñïîëüçîâàíèÿ XSLT http://www.zvon.org/download2.php/XSLTutorial?title=XSLT+Tutorial
Ïðèìåðû èñïîëüçîâàíèÿ SVG http://www.zvon.org/download2.php/svgReference?title=SVG+Reference


ÑÏÅÖÈÀËÜÍÛÅ ÂÎÇÌÎÆÍÎÑÒÈ

Âû ìîæåòå óïðàâëÿòü ñîäåðæàíèåì Flash-ñàéòà ÷åðåç BCWB. Äëÿ ýòîãî óêàæèòå â config.inc.php çíà÷åíèå $http_path = “http://yoursite.com/noxsl/” .  ðåæèìå ïðåäñòàâëåíèÿ äàííûõ BCWB áóäåò âûâîäèòü XML-ñòðóêòóðó, óê êîòîðîé âû ñìîæåòå îáðàòèòüñÿ èç Flash (ñì. http://macromedia.com)

Äëÿ çàäàíèÿ ñèñòåìå êîððåêòíîãî çàãîëîâêà äëÿ ñïåöèàëèçèðîâàííîãî òèïà äîêóìåíòà èñïîëüçóåòñÿ ïðåôèêñ â ïåðåìåííîé (URL) ñòðàíèöû.  Íàïðèìåð, http://site.com/svg_about/

Âû ìîæåòå îðãàíèçîâàòü äîïîëíèòåëüíûé ôîðìàò îòîáðàæåíèÿ äëÿ ëþáîé ñòðàíèöû. Íàïðèìåð, «âåðñèÿ äëÿ ïå÷àòè». Äëÿ ýòîãî ê ññûëêå òåêóùåé ñòðàíèöû ñëåäóåò äîáàâèòü çà ñëåøåì èìÿ XSLT-øàáëîíà.


ÂÎÇÌÎÆÍÛÅ ÍÅÏÎËÀÄÊÈ

Åñëè áðàóçåð ñîîáùàåò î íåíàéäåííîé ñòðàíèöå, ïîïðîáóéòå óêàçàòü â .htaccess ïîëíûé ìàðøðóò ê ñêðèïòó index.php. Ïðîâåðüòå çíà÷åíèå $root_path.

 ñèñòåìå BCWB èìååòñÿ êîíâåðòåð HTML2XHTML, îáðàáàòûâàþùèé äàííûå èç WYSIWYG ôîðì. Îäíàêî ñëîæíûå HTML êîíñòðóêöèè êîíâåðòåð ìîæåò ïðîèãíîðèðîâàòü.  òàêîì ñëó÷àå ñèñòåìà âîçâðàòèò îøèáêó XHTML è Âàì ïðèäåòñÿ  ñîçäàòü ñòðàíèöó ïî íîâîé, èçáåãàÿ ñëîæíûõ êîíñòðóêöèé HTML.

ÇÀÊËÞ×ÅÍÈÅ

ß áûë áû Âàì ïðèçíàòåëåí çà íîâûå ÿçûêîâûå ëîêàëèçàöèè èíòåðôåéñà (/lang/ÿçûê.inc.php). À òàêæå, ÿ ñ óäîâîëüñòâèåì ïðèìó è ðàçìåùó íà öåíòðàëüíîì ñàéòå BCWB ññûëêè íà èíòåðåñíûå ïðîåêòû, ñîáðàííûå íà ïëàòôîðìå BCWB. Êîíå÷íî æå, ïðèâåòñòâóåòñÿ è ññûëêà íà Âàøåì ñàéòå <a href=”http://bcwb.cmsdevelopment.com”>Powered by BCWB</a>.


******************************************
* BCWB URL: http://bcwb.cmsdevelopment.com  *
******************************************

Æåëàþ âñÿ÷åñêèõ óñïåõîâ âî âñåõ Âàøèõ òâîð÷åñêèõ íà÷èíàíèÿõ!

-- Äìèòðèé Øåéêî (sheiko@cmsdevelopment.com)