New file structure

See also
  • Extensible architecture for Wikka components - #446
This is a page to discuss the draft of the new file structure of Wikka.

The new file structure should follow these general principles:

Initial proposal

3rdparty/ 				<----------core 3rd party components
actions/ 				<----------default actions
.......myaction/			<----------example of default action folder
..............css/			<----------myaction's stylesheets
..............inc/			<----------myaction's dependencies
..............js/			<----------myaction's JS
..............myaction.php		<---------- myaction's code
docs/ 					<----------core documentation
formatters/				<----------default formatters
handlers/				<----------default handlers
lang/					<----------core language files
libs/					<----------core libraries
plugins/				<----------PLUGIN TREE (will *not* be overwritten during an upgrade)
.......actions/ 			<----------plugin actions (user-installable)
..............myaction/			<----------customized myaction (overrides the default one)
.....................css/
.....................inc/
.....................js/
.....................myaction.php
..............newaction/		<----------plugin action (user-installable)
.....................css/
.....................inc/
.....................lang/		<----------newaction's language files 
.....................js/
.....................newaction.php
.......formatters/ 			<----------plugin formatters (user-installable)
.......handlers/			<----------plugin handlers (user-installable)
.......templates/			<----------plugin themes (user-installable)
.....................fancy/
............................css/
............................js/
............................footer.inc.php
............................header.inc.php
.....................steampunk/
............................css/
............................js/
............................footer.inc.php
............................header.inc.php
setup/					<----------core installation files
.......sql/				<----------default tables definition
templates/				<----------core themes (bundled with the engine)
.......default/				<----------main default theme
..............css/			<----------default stylesheets are moved inside the main default theme folder
.....................wikka.css
..............js/
..............footer.inc.php 
..............header.inc.php
.......modern/				<----------Wikka may bundle a few extra themes that will be maintained by the Wikka Devs
..............css/
.....................wikka.css
..............js/
..............footer.inc.php
..............header.inc.php
Comments
Comment by BastoR
2009-05-18 10:34:34
I think its too different. Example:
I will change one *.css Order; I must searche into all directory for *.css Files.
I have a Side/article with template, 3 actions, 2 plugin etc.
Which code determines the endresult? Whats the ranking?
Comment by DarTar
2009-05-18 13:27:18
BastoR, the only stylesheet you will need to change and maintain is the one under templates/. The (optional) css for components such as actions, handlers etc. are not supposed to override the main styling of the wiki, but to provide basic support for the layout of these components when this is strictly necessary.
Comment by BastoR
2009-05-19 07:29:45
Ah, ok, Thanks :-)
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki