Hi everybody, I've started using xWiki a few weeks ago and now I want to make it look the way I want. So I'm trying to create my own skin. I read the Admin guide<http://www.xwiki.org/xwiki/bin/view/AdminGuide/Skins>about it, plus other mails but I have to say it's not an easy task. I don't really know where to start because I don't understand all the css files. xwiki10b1 has 23 css files but I think only 11 are used. Am I right ( style.css; elements.css; classes.css; xwiki.css; wiki.css; page.css; rss.css; screenlayout.css; microformats.css; presentation.css; colorsblack.css;) ? If yes, what are the other ones used for (chw.css, colorsblue.css, customcoloes.css, style1.css...) ? Why is page.css empty, is it the one to fill ? In other words, which css should I change if I want another layout, another font, colours.... Thanks for you help, Antonio
On Mar 14, 2007, at 4:19 PM, Antonio Goncalves wrote:
Hi everybody,
I've started using xWiki a few weeks ago and now I want to make it look the way I want. So I'm trying to create my own skin. I read the Admin guide about it, plus other mails but I have to say it's not an easy task. I don't really know where to start because I don't understand all the css files. xwiki10b1 has 23 css files but I think only 11 are used. Am I right ( style.css; elements.css; classes.css; xwiki.css; wiki.css; page.css; rss.css; screenlayout.css; microformats.css; presentation.css; colorsblack.css;) ? If yes, what are the other ones used for (chw.css, colorsblue.css, customcoloes.css , style1.css...) ? Why is page.css empty, is it the one to fill ? In other words, which css should I change if I want another layout, another font, colours....
I guess there are some leftovers of old skins in the xwiki10b1 skin :-( We need to clean it. I don't know more unfortunately about which css file is used or not. We also need someone to write a tutorial on how to create a new skin. The easiest is to base your skin on an existing skin and just change what you want. This is what I did for mavenbook.org and it was easy. -Vincent
Because I'm in the process of discovering xWiki layout, finding which style is used where, what file to use, which template to change.... I'll be more than happy to help someone in writing a tutorial about how to create a new skin. If someone more knowledgeable than me is inspired, I can be his/her right arm. Antonio 2007/3/14, Vincent Massol <[email protected]>:
On Mar 14, 2007, at 4:19 PM, Antonio Goncalves wrote:
Hi everybody,
I've started using xWiki a few weeks ago and now I want to make it look the way I want. So I'm trying to create my own skin. I read the Admin guide <http://www.xwiki.org/xwiki/bin/view/AdminGuide/Skins>about it, plus other mails but I have to say it's not an easy task. I don't really know where to start because I don't understand all the css files. xwiki10b1 has 23 css files but I think only 11 are used. Am I right ( style.css; elements.css; classes.css; xwiki.css; wiki.css; page.css; rss.css; screenlayout.css; microformats.css; presentation.css; colorsblack.css;) ? If yes, what are the other ones used for (chw.css, colorsblue.css, customcoloes.css , style1.css...) ? Why is page.css empty, is it the one to fill ? In other words, which css should I change if I want another layout, another font, colours....
I guess there are some leftovers of old skins in the xwiki10b1 skin :-( We need to clean it. I don't know more unfortunately about which css file is used or not.
We also need someone to write a tutorial on how to create a new skin.
The easiest is to base your skin on an existing skin and just change what you want. This is what I did for mavenbook.org and it was easy.
-Vincent
-- You receive this message as a subscriber of the [email protected] list. To unsubscribe: mailto:[email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
Vincent Massol wrote:
I guess there are some leftovers of old skins in the xwiki10b1 skin :-( We need to clean it. I don't know more unfortunately about which css file is used or not.
We also need someone to write a tutorial on how to create a new skin.
The easiest is to base your skin on an existing skin and just change what you want. This is what I did for mavenbook.org and it was easy.
-Vincent
I second that. For "selling" XWiki in companies it will be enough to change logo and two interface colors according to company's design guidelines.
On 3/14/07, Antonio Goncalves <[email protected]> wrote:
Hi everybody,
I've started using xWiki a few weeks ago and now I want to make it look the way I want. So I'm trying to create my own skin. I read the Admin guide <http://www.xwiki.org/xwiki/bin/view/AdminGuide/Skins> about it, plus other mails but I have to say it's not an easy task. I don't really know where to start because I don't understand all the css files. xwiki10b1 has 23 css files but I think only 11 are used. Am I right ( style.css; elements.css; classes.css; xwiki.css; wiki.css; page.css; rss.css; screenlayout.css; microformats.css; presentation.css; colorsblack.css;) ? If yes, what are the other ones used for (chw.css, colorsblue.css, customcoloes.css , style1.css...) ? Why is page.css empty, is it the one to fill ? In other words, which css should I change if I want another layout, another font, colours....
History: 1. At first, the skin was written in a few (~5) css files, where all the css properties were put together. (early variants of the 'default' skin) 2. Then came the idea of separating the different components of the skin: basic elements, layout, colors, etc. Some of the files from 1/ were split, part of the css was moved around. This happened along with working for the new skin ('xwiki10'), so old content was reorganized and new content was added. Together with the fact that very little time was available, the whole process ended in the mess you see in the current skin. 2b. At the same time, there was the idea of making a XWiki.Skin class, containing some options for colors, margins, widths, and to generate the skin based on these variables. For example, there should have been a 'padding' property which should have been used for panels, menu, page content... It was working for a while in the 'xwiki10' skin. The skin was supposed to be customized (well, based on the same general layout) using a skin wizard. 3. When work for the current skin ('xwiki10b1') started, even more css rules were created and added. 4. In the (near) future, the skin will be cleaned up, resulting in a clear separation of file purpose, no more deprecated code, and the ability to change easily the skin. 5. In the distant future, xwiki plugins will be able to register new css files, which won't be stored in the skins directory, but either as files in the jar/xar, or as attachments to a page. Core files: - style.css = top level style file. It's purpose is to include all the other files. If there is any other css in there, it shouldn't. - elements.css = intended to provide general design rules regarding the html elements. For example, default font size and family for headings, underline for links, etc. It should not provide color properties. - classes.css = like elements.css, but formats elements having a similar semantic meaning (after all, a class should have a semantic name, and not a random id). As examples, .underline, .hidden, .sep, .wikicreatelink, or .heading-1-1. This should only contain general classes, for specific elements see presentation.css - screenlayout.css = the place where the general layout of the interface is specified. This file should contain rules regarding position, dimension and display mode for the major elements of the interface (header, side panels, menu, footer...) - presentation.css = refinement of screenlayout.css. This is where borders, margins, paddings are set, font styling for objects not in elements.css or classes.css, along with some specific elements of the layout which are not affecting the general layout (where is the profile picture displayed, how is the comment auther displayed, etc.) - colors*.css = the place where the skin gets painted. Without this file, the skin should be black and white only (except the blue links). Font color, background, border color, Special purpose files: - rss.css = a few rules to format how profile rss is displayed - microformats.css = stylesheet to format the different microformats-enabled pages (user profile, blog, calendar...) - chwSkin.css = formatting for the Chart Wizard (soon to be re-released) - tdwSkin.css = formatting of the Table Datasource Wizard (part of Chart Wizard) - print.css = formatting for the @media print. Currently kind of empty and useless, it must be written once the albatross skin is ready. Deprecated (soon to be removed) - wiki.css = it was supposed to format wiki generated syntax, like .wikilink and .heading-1-1 - xwiki.css = it was one of the few files holding css (stage 1) - ie.css = some old hacks to make the 'default' skin work in IE too. - styel1/2/3.css = variants of the 'default' skin, with green, pink and ~yellow colors. - temp.css = used for some tests; generally a buffer before splitting rules among the other files. Possibly usable files, if somebody makes the skin wizard. - customlayout.css = a dynamic version of screenlayout.css, using properties defined in a skin object. Should be parsed by velocity. - customcolors.css = same, but for colors. Hope this helps. Sergiu -- http://purl.org/net/sergiu
Thanks Sergiu, that really helps to clarify things. I was using Firebug to try to understand which css property was inherited by which style and sometimes you can get lost. When you say that in the near future the skin will be cleaned up, do you have it planed ? Is it going to be for the 1.0 ? BTW I just have a comment about what you said about the css files. I can understand why css styles are splited in different files, but wouldn't you want <h1> to have the same style of .heading-1 and therefore be in the same file ? Like <h2> for heading-1-1, <b> for bold and so on. For my skin I was going to do that because I don't want to have the same css code repeated in several files. Thanks again Antonio 2007/3/14, Sergiu Dumitriu <[email protected]>:
On 3/14/07, Antonio Goncalves <[email protected]> wrote:
Hi everybody,
I've started using xWiki a few weeks ago and now I want to make it look the way I want. So I'm trying to create my own skin. I read the Admin guide <http://www.xwiki.org/xwiki/bin/view/AdminGuide/Skins>about it, plus other mails but I have to say it's not an easy task. I don't really know where to start because I don't understand all the css files. xwiki10b1 has 23 css files but I think only 11 are used. Am I right ( style.css; elements.css; classes.css; xwiki.css; wiki.css; page.css; rss.css; screenlayout.css; microformats.css; presentation.css; colorsblack.css;) ? If yes, what are the other ones used for (chw.css, colorsblue.css, customcoloes.css , style1.css...) ? Why is page.css empty, is it the one to fill ? In other words, which css should I change if I want another layout, another font, colours....
History: 1. At first, the skin was written in a few (~5) css files, where all the css properties were put together. (early variants of the 'default' skin) 2. Then came the idea of separating the different components of the skin: basic elements, layout, colors, etc. Some of the files from 1/ were split, part of the css was moved around. This happened along with working for the new skin ('xwiki10'), so old content was reorganized and new content was added. Together with the fact that very little time was available, the whole process ended in the mess you see in the current skin. 2b. At the same time, there was the idea of making a XWiki.Skin class, containing some options for colors, margins, widths, and to generate the skin based on these variables. For example, there should have been a 'padding' property which should have been used for panels, menu, page content... It was working for a while in the 'xwiki10' skin. The skin was supposed to be customized (well, based on the same general layout) using a skin wizard. 3. When work for the current skin ('xwiki10b1') started, even more css rules were created and added. 4. In the (near) future, the skin will be cleaned up, resulting in a clear separation of file purpose, no more deprecated code, and the ability to change easily the skin. 5. In the distant future, xwiki plugins will be able to register new css files, which won't be stored in the skins directory, but either as files in the jar/xar, or as attachments to a page.
Core files:
- style.css = top level style file. It's purpose is to include all the other files. If there is any other css in there, it shouldn't. - elements.css = intended to provide general design rules regarding the html elements. For example, default font size and family for headings, underline for links, etc. It should not provide color properties. - classes.css = like elements.css, but formats elements having a similar semantic meaning (after all, a class should have a semantic name, and not a random id). As examples, .underline, .hidden, .sep, .wikicreatelink, or .heading-1-1. This should only contain general classes, for specific elements see presentation.css - screenlayout.css = the place where the general layout of the interface is specified. This file should contain rules regarding position, dimension and display mode for the major elements of the interface (header, side panels, menu, footer...) - presentation.css = refinement of screenlayout.css. This is where borders, margins, paddings are set, font styling for objects not in elements.css or classes.css, along with some specific elements of the layout which are not affecting the general layout (where is the profile picture displayed, how is the comment auther displayed, etc.) - colors*.css = the place where the skin gets painted. Without this file, the skin should be black and white only (except the blue links). Font color, background, border color,
Special purpose files: - rss.css = a few rules to format how profile rss is displayed - microformats.css = stylesheet to format the different microformats-enabled pages (user profile, blog, calendar...) - chwSkin.css = formatting for the Chart Wizard (soon to be re-released) - tdwSkin.css = formatting of the Table Datasource Wizard (part of Chart Wizard) - print.css = formatting for the @media print. Currently kind of empty and useless, it must be written once the albatross skin is ready.
Deprecated (soon to be removed) - wiki.css = it was supposed to format wiki generated syntax, like .wikilink and .heading-1-1 - xwiki.css = it was one of the few files holding css (stage 1) - ie.css = some old hacks to make the 'default' skin work in IE too. - styel1/2/3.css = variants of the 'default' skin, with green, pink and ~yellow colors. - temp.css = used for some tests; generally a buffer before splitting rules among the other files.
Possibly usable files, if somebody makes the skin wizard. - customlayout.css = a dynamic version of screenlayout.css, using properties defined in a skin object. Should be parsed by velocity. - customcolors.css = same, but for colors.
Hope this helps. Sergiu
-- You receive this message as a subscriber of the [email protected] list. To unsubscribe: mailto:[email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
Guys, What would be real cool would be to gather this information on xwiki.org :) Antonio, if this is something you can help with that'd be great as I know Sergiu is busy fixing bugs and implementing features for 1.0 Beta 6... Thanks -Vincent On Mar 15, 2007, at 1:57 PM, Antonio Goncalves wrote:
Thanks Sergiu, that really helps to clarify things. I was using Firebug to try to understand which css property was inherited by which style and sometimes you can get lost. When you say that in the near future the skin will be cleaned up, do you have it planed ? Is it going to be for the 1.0 ?
BTW I just have a comment about what you said about the css files. I can understand why css styles are splited in different files, but wouldn't you want <h1> to have the same style of .heading-1 and therefore be in the same file ? Like <h2> for heading-1-1, <b> for bold and so on. For my skin I was going to do that because I don't want to have the same css code repeated in several files.
Thanks again
Antonio
2007/3/14, Sergiu Dumitriu <[email protected]>:
On 3/14/07, Antonio Goncalves <[email protected] > wrote: Hi everybody,
I've started using xWiki a few weeks ago and now I want to make it look the way I want. So I'm trying to create my own skin. I read the Admin guide about it, plus other mails but I have to say it's not an easy task. I don't really know where to start because I don't understand all the css files. xwiki10b1 has 23 css files but I think only 11 are used. Am I right ( style.css; elements.css; classes.css; xwiki.css; wiki.css; page.css; rss.css; screenlayout.css; microformats.css; presentation.css; colorsblack.css;) ? If yes, what are the other ones used for (chw.css, colorsblue.css, customcoloes.css , style1.css...) ? Why is page.css empty, is it the one to fill ? In other words, which css should I change if I want another layout, another font, colours....
History: 1. At first, the skin was written in a few (~5) css files, where all the css properties were put together. (early variants of the 'default' skin) 2. Then came the idea of separating the different components of the skin: basic elements, layout, colors, etc. Some of the files from 1/ were split, part of the css was moved around. This happened along with working for the new skin ('xwiki10'), so old content was reorganized and new content was added. Together with the fact that very little time was available, the whole process ended in the mess you see in the current skin. 2b. At the same time, there was the idea of making a XWiki.Skin class, containing some options for colors, margins, widths, and to generate the skin based on these variables. For example, there should have been a 'padding' property which should have been used for panels, menu, page content... It was working for a while in the 'xwiki10' skin. The skin was supposed to be customized (well, based on the same general layout) using a skin wizard. 3. When work for the current skin ('xwiki10b1') started, even more css rules were created and added. 4. In the (near) future, the skin will be cleaned up, resulting in a clear separation of file purpose, no more deprecated code, and the ability to change easily the skin. 5. In the distant future, xwiki plugins will be able to register new css files, which won't be stored in the skins directory, but either as files in the jar/xar, or as attachments to a page.
Core files:
- style.css = top level style file. It's purpose is to include all the other files. If there is any other css in there, it shouldn't. - elements.css = intended to provide general design rules regarding the html elements. For example, default font size and family for headings, underline for links, etc. It should not provide color properties. - classes.css = like elements.css, but formats elements having a similar semantic meaning (after all, a class should have a semantic name, and not a random id). As examples, .underline, .hidden, .sep, .wikicreatelink, or .heading-1-1. This should only contain general classes, for specific elements see presentation.css - screenlayout.css = the place where the general layout of the interface is specified. This file should contain rules regarding position, dimension and display mode for the major elements of the interface (header, side panels, menu, footer...) - presentation.css = refinement of screenlayout.css. This is where borders, margins, paddings are set, font styling for objects not in elements.css or classes.css, along with some specific elements of the layout which are not affecting the general layout (where is the profile picture displayed, how is the comment auther displayed, etc.) - colors*.css = the place where the skin gets painted. Without this file, the skin should be black and white only (except the blue links). Font color, background, border color,
Special purpose files: - rss.css = a few rules to format how profile rss is displayed - microformats.css = stylesheet to format the different microformats-enabled pages (user profile, blog, calendar...) - chwSkin.css = formatting for the Chart Wizard (soon to be re- released) - tdwSkin.css = formatting of the Table Datasource Wizard (part of Chart Wizard) - print.css = formatting for the @media print. Currently kind of empty and useless, it must be written once the albatross skin is ready.
Deprecated (soon to be removed) - wiki.css = it was supposed to format wiki generated syntax, like .wikilink and .heading-1-1 - xwiki.css = it was one of the few files holding css (stage 1) - ie.css = some old hacks to make the 'default' skin work in IE too. - styel1/2/3.css = variants of the 'default' skin, with green, pink and ~yellow colors. - temp.css = used for some tests; generally a buffer before splitting rules among the other files.
Possibly usable files, if somebody makes the skin wizard. - customlayout.css = a dynamic version of screenlayout.css, using properties defined in a skin object. Should be parsed by velocity. - customcolors.css = same, but for colors.
Hope this helps. Sergiu
-- You receive this message as a subscriber of the xwiki- [email protected] mailing list. To unsubscribe: mailto: [email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/ wws
-- You receive this message as a subscriber of the xwiki- [email protected] mailing list. To unsubscribe: mailto:[email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/ wws
I'm not the best "presentation layer" guy (god I've struggled so much with HTML and CSS) but I can do that. I will create a few pages explaining how skining works (Sergiu I might ask you more questions though). I'm leaving tonight for a long week-end at the mountain (still hoping to find some snow) and I'll start the job mid of next week. Antonio 2007/3/15, Vincent Massol <[email protected]>:
Guys,
What would be real cool would be to gather this information on xwiki.org:) Antonio, if this is something you can help with that'd be great as I know Sergiu is busy fixing bugs and implementing features for 1.0 Beta 6...
Thanks -Vincent
On Mar 15, 2007, at 1:57 PM, Antonio Goncalves wrote:
Thanks Sergiu, that really helps to clarify things. I was using Firebug to try to understand which css property was inherited by which style and sometimes you can get lost. When you say that in the near future the skin will be cleaned up, do you have it planed ? Is it going to be for the 1.0?
BTW I just have a comment about what you said about the css files. I can understand why css styles are splited in different files, but wouldn't you want <h1> to have the same style of .heading-1 and therefore be in the same file ? Like <h2> for heading-1-1, <b> for bold and so on. For my skin I was going to do that because I don't want to have the same css code repeated in several files.
Thanks again
Antonio
2007/3/14, Sergiu Dumitriu <[email protected]>:
On 3/14/07, Antonio Goncalves <[email protected] > wrote:
Hi everybody,
I've started using xWiki a few weeks ago and now I want to make it look the way I want. So I'm trying to create my own skin. I read the Admin guide <http://www.xwiki.org/xwiki/bin/view/AdminGuide/Skins>about it, plus other mails but I have to say it's not an easy task. I don't really know where to start because I don't understand all the css files. xwiki10b1 has 23 css files but I think only 11 are used. Am I right ( style.css; elements.css; classes.css; xwiki.css; wiki.css; page.css; rss.css; screenlayout.css; microformats.css; presentation.css; colorsblack.css;) ? If yes, what are the other ones used for (chw.css, colorsblue.css, customcoloes.css , style1.css...) ? Why is page.css empty, is it the one to fill ? In other words, which css should I change if I want another layout, another font, colours....
History: 1. At first, the skin was written in a few (~5) css files, where all the css properties were put together. (early variants of the 'default' skin) 2. Then came the idea of separating the different components of the skin: basic elements, layout, colors, etc. Some of the files from 1/ were split, part of the css was moved around. This happened along with working for the new skin ('xwiki10'), so old content was reorganized and new content was added. Together with the fact that very little time was available, the whole process ended in the mess you see in the current skin. 2b. At the same time, there was the idea of making a XWiki.Skin class, containing some options for colors, margins, widths, and to generate the skin based on these variables. For example, there should have been a 'padding' property which should have been used for panels, menu, page content... It was working for a while in the 'xwiki10' skin. The skin was supposed to be customized (well, based on the same general layout) using a skin wizard. 3. When work for the current skin ('xwiki10b1') started, even more css rules were created and added. 4. In the (near) future, the skin will be cleaned up, resulting in a clear separation of file purpose, no more deprecated code, and the ability to change easily the skin. 5. In the distant future, xwiki plugins will be able to register new css files, which won't be stored in the skins directory, but either as files in the jar/xar, or as attachments to a page.
Core files:
- style.css = top level style file. It's purpose is to include all the other files. If there is any other css in there, it shouldn't. - elements.css = intended to provide general design rules regarding the html elements. For example, default font size and family for headings, underline for links, etc. It should not provide color properties. - classes.css = like elements.css, but formats elements having a similar semantic meaning (after all, a class should have a semantic name, and not a random id). As examples, .underline, .hidden, .sep, .wikicreatelink, or .heading-1-1. This should only contain general classes, for specific elements see presentation.css - screenlayout.css = the place where the general layout of the interface is specified. This file should contain rules regarding position, dimension and display mode for the major elements of the interface (header, side panels, menu, footer...) - presentation.css = refinement of screenlayout.css. This is where borders, margins, paddings are set, font styling for objects not in elements.css or classes.css, along with some specific elements of the layout which are not affecting the general layout (where is the profile picture displayed, how is the comment auther displayed, etc.) - colors*.css = the place where the skin gets painted. Without this file, the skin should be black and white only (except the blue links). Font color, background, border color,
Special purpose files: - rss.css = a few rules to format how profile rss is displayed - microformats.css = stylesheet to format the different microformats-enabled pages (user profile, blog, calendar...) - chwSkin.css = formatting for the Chart Wizard (soon to be re-released)
- tdwSkin.css = formatting of the Table Datasource Wizard (part of Chart Wizard) - print.css = formatting for the @media print. Currently kind of empty and useless, it must be written once the albatross skin is ready.
Deprecated (soon to be removed) - wiki.css = it was supposed to format wiki generated syntax, like .wikilink and .heading-1-1 - xwiki.css = it was one of the few files holding css (stage 1) - ie.css = some old hacks to make the 'default' skin work in IE too. - styel1/2/3.css = variants of the 'default' skin, with green, pink and ~yellow colors. - temp.css = used for some tests; generally a buffer before splitting rules among the other files.
Possibly usable files, if somebody makes the skin wizard. - customlayout.css = a dynamic version of screenlayout.css, using properties defined in a skin object. Should be parsed by velocity. - customcolors.css = same, but for colors.
Hope this helps. Sergiu
-- You receive this message as a subscriber of the [email protected] mailing list. To unsubscribe: mailto: [email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
-- You receive this message as a subscriber of the [email protected] list. To unsubscribe: mailto:[email protected]<[email protected]> For general help: mailto:[email protected]?subject=help<[email protected]?subject=help> ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
-- You receive this message as a subscriber of the [email protected] list. To unsubscribe: mailto:[email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
Hi, I've added a CSS Files<http://www.xwiki.org/xwiki/bin/view/AdminGuide/CSS+files>page with the comment that Sergiu sent. I'll be adding more information later on. Antonio 2007/3/15, Antonio Goncalves <[email protected]>:
I'm not the best "presentation layer" guy (god I've struggled so much with HTML and CSS) but I can do that. I will create a few pages explaining how skining works (Sergiu I might ask you more questions though). I'm leaving tonight for a long week-end at the mountain (still hoping to find some snow) and I'll start the job mid of next week.
Antonio
2007/3/15, Vincent Massol <[email protected]>:
Guys,
What would be real cool would be to gather this information on xwiki.org:) Antonio, if this is something you can help with that'd be great as I know Sergiu is busy fixing bugs and implementing features for 1.0 Beta 6...
Thanks -Vincent
On Mar 15, 2007, at 1:57 PM, Antonio Goncalves wrote:
Thanks Sergiu, that really helps to clarify things. I was using Firebug to try to understand which css property was inherited by which style and sometimes you can get lost. When you say that in the near future the skin will be cleaned up, do you have it planed ? Is it going to be for the 1.0 ?
BTW I just have a comment about what you said about the css files. I can understand why css styles are splited in different files, but wouldn't you want <h1> to have the same style of .heading-1 and therefore be in the same file ? Like <h2> for heading-1-1, <b> for bold and so on. For my skin I was going to do that because I don't want to have the same css code repeated in several files.
Thanks again
Antonio
2007/3/14, Sergiu Dumitriu <[email protected]>:
On 3/14/07, Antonio Goncalves <[email protected] > wrote:
Hi everybody,
I've started using xWiki a few weeks ago and now I want to make it look the way I want. So I'm trying to create my own skin. I read the Admin guide <http://www.xwiki.org/xwiki/bin/view/AdminGuide/Skins>about it, plus other mails but I have to say it's not an easy task. I don't really know where to start because I don't understand all the css files. xwiki10b1 has 23 css files but I think only 11 are used. Am I right ( style.css; elements.css; classes.css; xwiki.css; wiki.css; page.css; rss.css; screenlayout.css; microformats.css; presentation.css; colorsblack.css;) ? If yes, what are the other ones used for ( chw.css, colorsblue.css, customcoloes.css , style1.css...) ? Why is page.css empty, is it the one to fill ? In other words, which css should I change if I want another layout, another font, colours....
History: 1. At first, the skin was written in a few (~5) css files, where all the css properties were put together. (early variants of the 'default' skin)
2. Then came the idea of separating the different components of the skin: basic elements, layout, colors, etc. Some of the files from 1/ were split, part of the css was moved around. This happened along with working for the new skin ('xwiki10'), so old content was reorganized and new content was added. Together with the fact that very little time was available, the whole process ended in the mess you see in the current skin. 2b. At the same time, there was the idea of making a XWiki.Skin class, containing some options for colors, margins, widths, and to generate the skin based on these variables. For example, there should have been a 'padding' property which should have been used for panels, menu, page content... It was working for a while in the 'xwiki10' skin. The skin was supposed to be customized (well, based on the same general layout) using a skin wizard. 3. When work for the current skin ('xwiki10b1') started, even more css rules were created and added. 4. In the (near) future, the skin will be cleaned up, resulting in a clear separation of file purpose, no more deprecated code, and the ability to change easily the skin. 5. In the distant future, xwiki plugins will be able to register new css files, which won't be stored in the skins directory, but either as files in the jar/xar, or as attachments to a page.
Core files:
- style.css = top level style file. It's purpose is to include all the other files. If there is any other css in there, it shouldn't. - elements.css = intended to provide general design rules regarding the html elements. For example, default font size and family for headings, underline for links, etc. It should not provide color properties. - classes.css = like elements.css, but formats elements having a similar semantic meaning (after all, a class should have a semantic name, and not a random id). As examples, .underline, .hidden, .sep, .wikicreatelink, or .heading-1-1. This should only contain general classes, for specific elements see presentation.css - screenlayout.css = the place where the general layout of the interface is specified. This file should contain rules regarding position, dimension and display mode for the major elements of the interface (header, side panels, menu, footer...) - presentation.css = refinement of screenlayout.css. This is where borders, margins, paddings are set, font styling for objects not in elements.css or classes.css, along with some specific elements of the layout which are not affecting the general layout (where is the profile picture displayed, how is the comment auther displayed, etc.) - colors*.css = the place where the skin gets painted. Without this file, the skin should be black and white only (except the blue links). Font color, background, border color,
Special purpose files: - rss.css = a few rules to format how profile rss is displayed - microformats.css = stylesheet to format the different microformats-enabled pages (user profile, blog, calendar...) - chwSkin.css = formatting for the Chart Wizard (soon to be re-released) - tdwSkin.css = formatting of the Table Datasource Wizard (part of Chart Wizard) - print.css = formatting for the @media print. Currently kind of empty and useless, it must be written once the albatross skin is ready.
Deprecated (soon to be removed) - wiki.css = it was supposed to format wiki generated syntax, like .wikilink and .heading-1-1 - xwiki.css = it was one of the few files holding css (stage 1) - ie.css = some old hacks to make the 'default' skin work in IE too. - styel1/2/3.css = variants of the 'default' skin, with green, pink and ~yellow colors. - temp.css = used for some tests; generally a buffer before splitting rules among the other files.
Possibly usable files, if somebody makes the skin wizard. - customlayout.css = a dynamic version of screenlayout.css, using properties defined in a skin object. Should be parsed by velocity. - customcolors.css = same, but for colors.
Hope this helps. Sergiu
-- You receive this message as a subscriber of the [email protected] mailing list. To unsubscribe: mailto: [email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
-- You receive this message as a subscriber of the [email protected] mailing list. To unsubscribe: mailto:[email protected]<[email protected]> For general help: mailto:[email protected]?subject=help<[email protected]?subject=help> ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
-- You receive this message as a subscriber of the [email protected] mailing list. To unsubscribe: mailto:[email protected] For general help: mailto: [email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
Thanks Antonio that's great! 2 small comments: 1) on the main Skin page it seems you have removed the <server> or <yourserver> text I had put in the different URL. You've probably done that unintentionnally or you've use the WYSIWYG editor and there's a bug... 2) on the CSS Files page, you've used "xWiki" instead of "XWiki" :-) If you don't beat me I'll fix those later tonight. Thanks -Vincent On Mar 22, 2007, at 11:30 AM, Antonio Goncalves wrote:
Hi, I've added a CSS Files page with the comment that Sergiu sent. I'll be adding more information later on.
Antonio
2007/3/15, Antonio Goncalves <[email protected]>: I'm not the best "presentation layer" guy (god I've struggled so much with HTML and CSS) but I can do that. I will create a few pages explaining how skining works (Sergiu I might ask you more questions though). I'm leaving tonight for a long week-end at the mountain (still hoping to find some snow) and I'll start the job mid of next week.
Antonio
2007/3/15, Vincent Massol <[email protected]>: Guys,
What would be real cool would be to gather this information on xwiki.org :) Antonio, if this is something you can help with that'd be great as I know Sergiu is busy fixing bugs and implementing features for 1.0 Beta 6...
Thanks -Vincent
On Mar 15, 2007, at 1:57 PM, Antonio Goncalves wrote:
Thanks Sergiu, that really helps to clarify things. I was using Firebug to try to understand which css property was inherited by which style and sometimes you can get lost. When you say that in the near future the skin will be cleaned up, do you have it planed ? Is it going to be for the 1.0 ?
BTW I just have a comment about what you said about the css files. I can understand why css styles are splited in different files, but wouldn't you want <h1> to have the same style of .heading-1 and therefore be in the same file ? Like <h2> for heading-1-1, <b> for bold and so on. For my skin I was going to do that because I don't want to have the same css code repeated in several files.
Thanks again
Antonio
2007/3/14, Sergiu Dumitriu <[email protected]>:
On 3/14/07, Antonio Goncalves <[email protected] > wrote: Hi everybody,
I've started using xWiki a few weeks ago and now I want to make it look the way I want. So I'm trying to create my own skin. I read the Admin guide about it, plus other mails but I have to say it's not an easy task. I don't really know where to start because I don't understand all the css files. xwiki10b1 has 23 css files but I think only 11 are used. Am I right ( style.css; elements.css; classes.css; xwiki.css; wiki.css; page.css; rss.css; screenlayout.css; microformats.css; presentation.css; colorsblack.css;) ? If yes, what are the other ones used for (chw.css, colorsblue.css, customcoloes.css , style1.css...) ? Why is page.css empty, is it the one to fill ? In other words, which css should I change if I want another layout, another font, colours....
History: 1. At first, the skin was written in a few (~5) css files, where all the css properties were put together. (early variants of the 'default' skin) 2. Then came the idea of separating the different components of the skin: basic elements, layout, colors, etc. Some of the files from 1/ were split, part of the css was moved around. This happened along with working for the new skin ('xwiki10'), so old content was reorganized and new content was added. Together with the fact that very little time was available, the whole process ended in the mess you see in the current skin. 2b. At the same time, there was the idea of making a XWiki.Skin class, containing some options for colors, margins, widths, and to generate the skin based on these variables. For example, there should have been a 'padding' property which should have been used for panels, menu, page content... It was working for a while in the 'xwiki10' skin. The skin was supposed to be customized (well, based on the same general layout) using a skin wizard. 3. When work for the current skin ('xwiki10b1') started, even more css rules were created and added. 4. In the (near) future, the skin will be cleaned up, resulting in a clear separation of file purpose, no more deprecated code, and the ability to change easily the skin. 5. In the distant future, xwiki plugins will be able to register new css files, which won't be stored in the skins directory, but either as files in the jar/xar, or as attachments to a page.
Core files:
- style.css = top level style file. It's purpose is to include all the other files. If there is any other css in there, it shouldn't. - elements.css = intended to provide general design rules regarding the html elements. For example, default font size and family for headings, underline for links, etc. It should not provide color properties. - classes.css = like elements.css, but formats elements having a similar semantic meaning (after all, a class should have a semantic name, and not a random id). As examples, .underline, .hidden, .sep, .wikicreatelink, or .heading-1-1. This should only contain general classes, for specific elements see presentation.css - screenlayout.css = the place where the general layout of the interface is specified. This file should contain rules regarding position, dimension and display mode for the major elements of the interface (header, side panels, menu, footer...) - presentation.css = refinement of screenlayout.css. This is where borders, margins, paddings are set, font styling for objects not in elements.css or classes.css, along with some specific elements of the layout which are not affecting the general layout (where is the profile picture displayed, how is the comment auther displayed, etc.) - colors*.css = the place where the skin gets painted. Without this file, the skin should be black and white only (except the blue links). Font color, background, border color,
Special purpose files: - rss.css = a few rules to format how profile rss is displayed - microformats.css = stylesheet to format the different microformats-enabled pages (user profile, blog, calendar...) - chwSkin.css = formatting for the Chart Wizard (soon to be re- released) - tdwSkin.css = formatting of the Table Datasource Wizard (part of Chart Wizard) - print.css = formatting for the @media print. Currently kind of empty and useless, it must be written once the albatross skin is ready.
Deprecated (soon to be removed) - wiki.css = it was supposed to format wiki generated syntax, like .wikilink and .heading-1-1 - xwiki.css = it was one of the few files holding css (stage 1) - ie.css = some old hacks to make the 'default' skin work in IE too. - styel1/2/3.css = variants of the 'default' skin, with green, pink and ~yellow colors. - temp.css = used for some tests; generally a buffer before splitting rules among the other files.
Possibly usable files, if somebody makes the skin wizard. - customlayout.css = a dynamic version of screenlayout.css, using properties defined in a skin object. Should be parsed by velocity. - customcolors.css = same, but for colors.
Hope this helps. Sergiu
-- You receive this message as a subscriber of the xwiki- [email protected] mailing list. To unsubscribe: mailto: [email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http:// www.objectweb.org/wws
-- You receive this message as a subscriber of the xwiki- [email protected] mailing list. To unsubscribe: mailto:[email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http:// www.objectweb.org/wws
-- You receive this message as a subscriber of the xwiki- [email protected] mailing list. To unsubscribe: mailto:[email protected] For general help: mailto: [email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/ wws
-- You receive this message as a subscriber of the xwiki- [email protected] mailing list. To unsubscribe: mailto:[email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/ wws
Hi Vincent, 1) I've used the WYSIWIG to create a link to the new page. I don't know what you mean by <server> or <yourserver>. One thing is sure, I didn't do it :o) 2) I've just changed it. I'm adding another page for the css layout<http://www.xwiki.org/xwiki/bin/view/AdminGuide/CSSLayout>(this one will have to be double checked because I'm not really sure) 2007/3/22, Vincent Massol <[email protected]>:
Thanks Antonio that's great!
2 small comments:
1) on the main Skin page it seems you have removed the <server> or <yourserver> text I had put in the different URL. You've probably done that unintentionnally or you've use the WYSIWYG editor and there's a bug...
2) on the CSS Files page, you've used "xWiki" instead of "XWiki" :-)
If you don't beat me I'll fix those later tonight.
Thanks -Vincent
On Mar 22, 2007, at 11:30 AM, Antonio Goncalves wrote:
Hi, I've added a CSS Files<http://www.xwiki.org/xwiki/bin/view/AdminGuide/CSS+files>page with the comment that Sergiu sent. I'll be adding more information later on.
Antonio
2007/3/15, Antonio Goncalves <[email protected]>:
I'm not the best "presentation layer" guy (god I've struggled so much with HTML and CSS) but I can do that. I will create a few pages explaining how skining works (Sergiu I might ask you more questions though). I'm leaving tonight for a long week-end at the mountain (still hoping to find some snow) and I'll start the job mid of next week.
Antonio
2007/3/15, Vincent Massol <[email protected]>:
Guys,
What would be real cool would be to gather this information on xwiki.org :) Antonio, if this is something you can help with that'd be great as I know Sergiu is busy fixing bugs and implementing features for 1.0 Beta 6...
Thanks -Vincent
On Mar 15, 2007, at 1:57 PM, Antonio Goncalves wrote:
Thanks Sergiu, that really helps to clarify things. I was using Firebug to try to understand which css property was inherited by which style and sometimes you can get lost. When you say that in the near future the skin will be cleaned up, do you have it planed ? Is it going to be for the 1.0 ?
BTW I just have a comment about what you said about the css files. I can understand why css styles are splited in different files, but wouldn't you want <h1> to have the same style of .heading-1 and therefore be in the same file ? Like <h2> for heading-1-1, <b> for bold and so on. For my skin I was going to do that because I don't want to have the same css code repeated in several files.
Thanks again
Antonio
2007/3/14, Sergiu Dumitriu <[email protected]>:
On 3/14/07, Antonio Goncalves <[email protected] > wrote:
Hi everybody,
I've started using xWiki a few weeks ago and now I want to make it look the way I want. So I'm trying to create my own skin. I read the Admin guide <http://www.xwiki.org/xwiki/bin/view/AdminGuide/Skins>about it, plus other mails but I have to say it's not an easy task. I don't really know where to start because I don't understand all the css files. xwiki10b1 has 23 css files but I think only 11 are used. Am I right ( style.css; elements.css; classes.css; xwiki.css; wiki.css; page.css; rss.css; screenlayout.css; microformats.css; presentation.css; colorsblack.css;) ? If yes, what are the other ones used for (chw.css, colorsblue.css, customcoloes.css , style1.css...) ? Why is page.css empty, is it the one to fill ? In other words, which css should I change if I want another layout, another font, colours....
History: 1. At first, the skin was written in a few (~5) css files, where all the css properties were put together. (early variants of the 'default' skin)
2. Then came the idea of separating the different components of the skin: basic elements, layout, colors, etc. Some of the files from 1/ were split, part of the css was moved around. This happened along with working for the new skin ('xwiki10'), so old content was reorganized and new content was added. Together with the fact that very little time was available, the whole process ended in the mess you see in the current skin. 2b. At the same time, there was the idea of making a XWiki.Skinclass, containing some options for colors, margins, widths, and to generate the skin based on these variables. For example, there should have been a 'padding' property which should have been used for panels, menu, page content... It was working for a while in the 'xwiki10' skin. The skin was supposed to be customized (well, based on the same general layout) using a skin wizard. 3. When work for the current skin ('xwiki10b1') started, even more css rules were created and added. 4. In the (near) future, the skin will be cleaned up, resulting in a clear separation of file purpose, no more deprecated code, and the ability to change easily the skin. 5. In the distant future, xwiki plugins will be able to register new css files, which won't be stored in the skins directory, but either as files in the jar/xar, or as attachments to a page.
Core files:
- style.css = top level style file. It's purpose is to include all the other files. If there is any other css in there, it shouldn't. - elements.css = intended to provide general design rules regarding the html elements. For example, default font size and family for headings, underline for links, etc. It should not provide color properties. - classes.css = like elements.css, but formats elements having a similar semantic meaning (after all, a class should have a semantic name, and not a random id). As examples, .underline, .hidden, .sep, .wikicreatelink, or .heading-1-1. This should only contain general classes, for specific elements see presentation.css - screenlayout.css = the place where the general layout of the interface is specified. This file should contain rules regarding position, dimension and display mode for the major elements of the interface (header, side panels, menu, footer...) - presentation.css = refinement of screenlayout.css. This is where borders, margins, paddings are set, font styling for objects not in elements.css or classes.css, along with some specific elements of the layout which are not affecting the general layout (where is the profile picture displayed, how is the comment auther displayed, etc.) - colors*.css = the place where the skin gets painted. Without this file, the skin should be black and white only (except the blue links). Font color, background, border color,
Special purpose files: - rss.css = a few rules to format how profile rss is displayed - microformats.css = stylesheet to format the different microformats-enabled pages (user profile, blog, calendar...) - chwSkin.css = formatting for the Chart Wizard (soon to be re-released) - tdwSkin.css = formatting of the Table Datasource Wizard (part of Chart Wizard) - print.css = formatting for the @media print. Currently kind of empty and useless, it must be written once the albatross skin is ready.
Deprecated (soon to be removed) - wiki.css = it was supposed to format wiki generated syntax, like .wikilink and .heading-1-1 - xwiki.css = it was one of the few files holding css (stage 1) - ie.css = some old hacks to make the 'default' skin work in IE too.
- styel1/2/3.css = variants of the 'default' skin, with green, pink and ~yellow colors. - temp.css = used for some tests; generally a buffer before splitting rules among the other files.
Possibly usable files, if somebody makes the skin wizard. - customlayout.css = a dynamic version of screenlayout.css, using properties defined in a skin object. Should be parsed by velocity. - customcolors.css = same, but for colors.
Hope this helps. Sergiu
-- You receive this message as a subscriber of the [email protected] mailing list. To unsubscribe: mailto: [email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
-- You receive this message as a subscriber of the [email protected] mailing list. To unsubscribe: mailto:[email protected]<[email protected]> For general help: mailto:[email protected]?subject=help<[email protected]?subject=help> ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
-- You receive this message as a subscriber of the [email protected] mailing list. To unsubscribe: mailto:[email protected] For general help: mailto: [email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
-- You receive this message as a subscriber of the [email protected] list. To unsubscribe: mailto:[email protected]<[email protected]> For general help: mailto:[email protected]?subject=help<[email protected]?subject=help> ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
On Mar 22, 2007, at 4:30 PM, Antonio Goncalves wrote:
Hi Vincent,
1) I've used the WYSIWIG to create a link to the new page. I don't know what you mean by <server> or <yourserver>. One thing is sure, I didn't do it :o)
Go to the page history and compare your change with the previous changes. You'll see what I mean. We need to raise this in jira as this looks like a bug of the WYSIWYG editor Thanks -Vincent
2) I've just changed it. I'm adding another page for the css layout (this one will have to be double checked because I'm not really sure)
2007/3/22, Vincent Massol <[email protected]>: Thanks Antonio that's great!
2 small comments:
1) on the main Skin page it seems you have removed the <server> or <yourserver> text I had put in the different URL. You've probably done that unintentionnally or you've use the WYSIWYG editor and there's a bug...
2) on the CSS Files page, you've used "xWiki" instead of "XWiki" :-)
If you don't beat me I'll fix those later tonight.
Thanks -Vincent
On Mar 22, 2007, at 11:30 AM, Antonio Goncalves wrote:
Hi, I've added a CSS Files page with the comment that Sergiu sent. I'll be adding more information later on.
Antonio
2007/3/15, Antonio Goncalves <[email protected]>: I'm not the best "presentation layer" guy (god I've struggled so much with HTML and CSS) but I can do that. I will create a few pages explaining how skining works (Sergiu I might ask you more questions though). I'm leaving tonight for a long week-end at the mountain (still hoping to find some snow) and I'll start the job mid of next week.
Antonio
2007/3/15, Vincent Massol <[email protected]>: Guys,
What would be real cool would be to gather this information on xwiki.org :) Antonio, if this is something you can help with that'd be great as I know Sergiu is busy fixing bugs and implementing features for 1.0 Beta 6...
Thanks -Vincent
On Mar 15, 2007, at 1:57 PM, Antonio Goncalves wrote:
Thanks Sergiu, that really helps to clarify things. I was using Firebug to try to understand which css property was inherited by which style and sometimes you can get lost. When you say that in the near future the skin will be cleaned up, do you have it planed ? Is it going to be for the 1.0 ?
BTW I just have a comment about what you said about the css files. I can understand why css styles are splited in different files, but wouldn't you want <h1> to have the same style of .heading-1 and therefore be in the same file ? Like <h2> for heading-1-1, <b> for bold and so on. For my skin I was going to do that because I don't want to have the same css code repeated in several files.
Thanks again
Antonio
2007/3/14, Sergiu Dumitriu <[email protected]>:
On 3/14/07, Antonio Goncalves <[email protected] > wrote: Hi everybody,
I've started using xWiki a few weeks ago and now I want to make it look the way I want. So I'm trying to create my own skin. I read the Admin guide about it, plus other mails but I have to say it's not an easy task. I don't really know where to start because I don't understand all the css files. xwiki10b1 has 23 css files but I think only 11 are used. Am I right ( style.css; elements.css; classes.css; xwiki.css; wiki.css; page.css; rss.css; screenlayout.css; microformats.css; presentation.css; colorsblack.css;) ? If yes, what are the other ones used for (chw.css, colorsblue.css, customcoloes.css , style1.css...) ? Why is page.css empty, is it the one to fill ? In other words, which css should I change if I want another layout, another font, colours....
History: 1. At first, the skin was written in a few (~5) css files, where all the css properties were put together. (early variants of the 'default' skin) 2. Then came the idea of separating the different components of the skin: basic elements, layout, colors, etc. Some of the files from 1/ were split, part of the css was moved around. This happened along with working for the new skin ('xwiki10'), so old content was reorganized and new content was added. Together with the fact that very little time was available, the whole process ended in the mess you see in the current skin. 2b. At the same time, there was the idea of making a XWiki.Skin class, containing some options for colors, margins, widths, and to generate the skin based on these variables. For example, there should have been a 'padding' property which should have been used for panels, menu, page content... It was working for a while in the 'xwiki10' skin. The skin was supposed to be customized (well, based on the same general layout) using a skin wizard. 3. When work for the current skin ('xwiki10b1') started, even more css rules were created and added. 4. In the (near) future, the skin will be cleaned up, resulting in a clear separation of file purpose, no more deprecated code, and the ability to change easily the skin. 5. In the distant future, xwiki plugins will be able to register new css files, which won't be stored in the skins directory, but either as files in the jar/xar, or as attachments to a page.
Core files:
- style.css = top level style file. It's purpose is to include all the other files. If there is any other css in there, it shouldn't. - elements.css = intended to provide general design rules regarding the html elements. For example, default font size and family for headings, underline for links, etc. It should not provide color properties. - classes.css = like elements.css, but formats elements having a similar semantic meaning (after all, a class should have a semantic name, and not a random id). As examples, .underline, .hidden, .sep, .wikicreatelink, or .heading-1-1. This should only contain general classes, for specific elements see presentation.css - screenlayout.css = the place where the general layout of the interface is specified. This file should contain rules regarding position, dimension and display mode for the major elements of the interface (header, side panels, menu, footer...) - presentation.css = refinement of screenlayout.css. This is where borders, margins, paddings are set, font styling for objects not in elements.css or classes.css, along with some specific elements of the layout which are not affecting the general layout (where is the profile picture displayed, how is the comment auther displayed, etc.) - colors*.css = the place where the skin gets painted. Without this file, the skin should be black and white only (except the blue links). Font color, background, border color,
Special purpose files: - rss.css = a few rules to format how profile rss is displayed - microformats.css = stylesheet to format the different microformats-enabled pages (user profile, blog, calendar...) - chwSkin.css = formatting for the Chart Wizard (soon to be re- released) - tdwSkin.css = formatting of the Table Datasource Wizard (part of Chart Wizard) - print.css = formatting for the @media print. Currently kind of empty and useless, it must be written once the albatross skin is ready.
Deprecated (soon to be removed) - wiki.css = it was supposed to format wiki generated syntax, like .wikilink and .heading-1-1 - xwiki.css = it was one of the few files holding css (stage 1) - ie.css = some old hacks to make the 'default' skin work in IE too. - styel1/2/3.css = variants of the 'default' skin, with green, pink and ~yellow colors. - temp.css = used for some tests; generally a buffer before splitting rules among the other files.
Possibly usable files, if somebody makes the skin wizard. - customlayout.css = a dynamic version of screenlayout.css, using properties defined in a skin object. Should be parsed by velocity. - customcolors.css = same, but for colors.
Hope this helps. Sergiu
-- You receive this message as a subscriber of the xwiki- [email protected] mailing list. To unsubscribe: mailto: [email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http:// www.objectweb.org/wws
-- You receive this message as a subscriber of the xwiki- [email protected] mailing list. To unsubscribe: mailto:[email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http:// www.objectweb.org/wws
-- You receive this message as a subscriber of the xwiki- [email protected] mailing list. To unsubscribe: mailto:[email protected] For general help: mailto: [email protected]?subject=help ObjectWeb mailing lists service home page: http:// www.objectweb.org/wws
-- You receive this message as a subscriber of the xwiki- [email protected] mailing list. To unsubscribe: mailto:[email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http:// www.objectweb.org/wws
-- You receive this message as a subscriber of the xwiki- [email protected] mailing list. To unsubscribe: mailto:[email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/ wws
Ok, I've put the page back to normal. I tried to reproduced this bug but I couldn't. I don't know what I did to make <server> and <yourserver> disapear. 2007/3/22, Vincent Massol <[email protected]>:
On Mar 22, 2007, at 4:30 PM, Antonio Goncalves wrote:
Hi Vincent,
1) I've used the WYSIWIG to create a link to the new page. I don't know what you mean by <server> or <yourserver>. One thing is sure, I didn't do it :o)
Go to the page history and compare your change with the previous changes. You'll see what I mean.
We need to raise this in jira as this looks like a bug of the WYSIWYG editor
Thanks -Vincent
2) I've just changed it. I'm adding another page for the css layout<http://www.xwiki.org/xwiki/bin/view/AdminGuide/CSSLayout>(this one will have to be double checked because I'm not really sure)
2007/3/22, Vincent Massol <[email protected]>:
Thanks Antonio that's great!
2 small comments:
1) on the main Skin page it seems you have removed the <server> or <yourserver> text I had put in the different URL. You've probably done that unintentionnally or you've use the WYSIWYG editor and there's a bug...
2) on the CSS Files page, you've used "xWiki" instead of "XWiki" :-)
If you don't beat me I'll fix those later tonight.
Thanks -Vincent
On Mar 22, 2007, at 11:30 AM, Antonio Goncalves wrote:
Hi, I've added a CSS Files<http://www.xwiki.org/xwiki/bin/view/AdminGuide/CSS+files>page with the comment that Sergiu sent. I'll be adding more information later on.
Antonio
2007/3/15, Antonio Goncalves <[email protected]>:
I'm not the best "presentation layer" guy (god I've struggled so much with HTML and CSS) but I can do that. I will create a few pages explaining how skining works (Sergiu I might ask you more questions though). I'm leaving tonight for a long week-end at the mountain (still hoping to find some snow) and I'll start the job mid of next week.
Antonio
2007/3/15, Vincent Massol <[email protected]>:
Guys,
What would be real cool would be to gather this information on xwiki.org :) Antonio, if this is something you can help with that'd be great as I know Sergiu is busy fixing bugs and implementing features for 1.0 Beta 6...
Thanks -Vincent
On Mar 15, 2007, at 1:57 PM, Antonio Goncalves wrote:
Thanks Sergiu, that really helps to clarify things. I was using Firebug to try to understand which css property was inherited by which style and sometimes you can get lost. When you say that in the near future the skin will be cleaned up, do you have it planed ? Is it going to be for the 1.0 ?
BTW I just have a comment about what you said about the css files. I can understand why css styles are splited in different files, but wouldn't you want <h1> to have the same style of .heading-1 and therefore be in the same file ? Like <h2> for heading-1-1, <b> for bold and so on. For my skin I was going to do that because I don't want to have the same css code repeated in several files.
Thanks again
Antonio
2007/3/14, Sergiu Dumitriu <[email protected]>:
On 3/14/07, Antonio Goncalves <[email protected] > wrote:
Hi everybody,
I've started using xWiki a few weeks ago and now I want to make it look the way I want. So I'm trying to create my own skin. I read the Admin guide <http://www.xwiki.org/xwiki/bin/view/AdminGuide/Skins>about it, plus other mails but I have to say it's not an easy task. I don't really know where to start because I don't understand all the css files. xwiki10b1 has 23 css files but I think only 11 are used. Am I right ( style.css; elements.css; classes.css; xwiki.css; wiki.css; page.css; rss.css; screenlayout.css; microformats.css; presentation.css; colorsblack.css;) ? If yes, what are the other ones used for (chw.css, colorsblue.css, customcoloes.css , style1.css...) ? Why is page.css empty, is it the one to fill ? In other words, which css should I change if I want another layout, another font, colours....
History: 1. At first, the skin was written in a few (~5) css files, where all the css properties were put together. (early variants of the 'default' skin) 2. Then came the idea of separating the different components of the skin: basic elements, layout, colors, etc. Some of the files from 1/ were split, part of the css was moved around. This happened along with working for the new skin ('xwiki10'), so old content was reorganized and new content was added. Together with the fact that very little time was available, the whole process ended in the mess you see in the current skin. 2b. At the same time, there was the idea of making a XWiki.Skinclass, containing some options for colors, margins, widths, and to generate the skin based on these variables. For example, there should have been a 'padding' property which should have been used for panels, menu, page content... It was working for a while in the 'xwiki10' skin. The skin was supposed to be customized (well, based on the same general layout) using a skin wizard. 3. When work for the current skin ('xwiki10b1') started, even more css rules were created and added. 4. In the (near) future, the skin will be cleaned up, resulting in a clear separation of file purpose, no more deprecated code, and the ability to change easily the skin. 5. In the distant future, xwiki plugins will be able to register new css files, which won't be stored in the skins directory, but either as files in the jar/xar, or as attachments to a page.
Core files:
- style.css = top level style file. It's purpose is to include all the other files. If there is any other css in there, it shouldn't. - elements.css = intended to provide general design rules regarding the html elements. For example, default font size and family for headings, underline for links, etc. It should not provide color properties. - classes.css = like elements.css, but formats elements having a similar semantic meaning (after all, a class should have a semantic name, and not a random id). As examples, .underline, .hidden, .sep, .wikicreatelink, or .heading-1-1. This should only contain general classes, for specific elements see presentation.css - screenlayout.css = the place where the general layout of the interface is specified. This file should contain rules regarding position, dimension and display mode for the major elements of the interface (header, side panels, menu, footer...) - presentation.css = refinement of screenlayout.css. This is where borders, margins, paddings are set, font styling for objects not in elements.css or classes.css, along with some specific elements of the layout which are not affecting the general layout (where is the profile picture displayed, how is the comment auther displayed, etc.) - colors*.css = the place where the skin gets painted. Without this file, the skin should be black and white only (except the blue links). Font color, background, border color,
Special purpose files: - rss.css = a few rules to format how profile rss is displayed - microformats.css = stylesheet to format the different microformats-enabled pages (user profile, blog, calendar...) - chwSkin.css = formatting for the Chart Wizard (soon to be re-released) - tdwSkin.css = formatting of the Table Datasource Wizard (part of Chart Wizard) - print.css = formatting for the @media print. Currently kind of empty and useless, it must be written once the albatross skin is ready.
Deprecated (soon to be removed) - wiki.css = it was supposed to format wiki generated syntax, like .wikilink and .heading-1-1 - xwiki.css = it was one of the few files holding css (stage 1) - ie.css = some old hacks to make the 'default' skin work in IE too. - styel1/2/3.css = variants of the 'default' skin, with green, pink and ~yellow colors. - temp.css = used for some tests; generally a buffer before splitting rules among the other files.
Possibly usable files, if somebody makes the skin wizard. - customlayout.css = a dynamic version of screenlayout.css, using properties defined in a skin object. Should be parsed by velocity. - customcolors.css = same, but for colors.
Hope this helps. Sergiu
-- You receive this message as a subscriber of the [email protected] mailing list. To unsubscribe: mailto: [email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
-- You receive this message as a subscriber of the [email protected] mailing list. To unsubscribe: mailto:[email protected]<[email protected]> For general help: mailto:[email protected]?subject=help<[email protected]?subject=help> ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
-- You receive this message as a subscriber of the [email protected] mailing list. To unsubscribe: mailto:[email protected] For general help: mailto: [email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
-- You receive this message as a subscriber of the [email protected] mailing list. To unsubscribe: mailto:[email protected]<[email protected]> For general help: mailto:[email protected]?subject=help<[email protected]?subject=help> ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
-- You receive this message as a subscriber of the [email protected] list. To unsubscribe: mailto:[email protected]<[email protected]> For general help: mailto:[email protected]?subject=help<[email protected]?subject=help> ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
-- You receive this message as a subscriber of the [email protected] list. To unsubscribe: mailto:[email protected] For general help: mailto:[email protected]?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
Hello all, I am trying to download the xwiki source distribution, however, I haven't used SVN repository before and I am confused. I saw that under xwiki there are 3 subdirectories: branches, tags, and trunk. In branches I saw \bin\xwiki\branches\XWIKI_1_0, but in tags I found \bin\xwiki\tags\XWIKI_1_0_BETA_5. Which one should I important in my Eclipse? Also when I looked at the lib subdirectory I saw that a few jars are marked as 'UNKNOWN', e.g. alexa, etc Will the project run without them or where can I take those from? Thanks, Darina
Hi Darina, On Mar 15, 2007, at 5:43 PM, Dicheva, Darina wrote:
Hello all,
I am trying to download the xwiki source distribution, however, I haven't used SVN repository before and I am confused. I saw that under xwiki there are 3 subdirectories: branches, tags, and trunk. In branches I saw \bin\xwiki\branches\XWIKI_1_0, but in tags I found \bin\xwiki\tags\XWIKI_1_0_BETA_5.
Which one should I important in my Eclipse? Also when I looked at the lib subdirectory I saw that a few jars are marked as 'UNKNOWN', e.g. alexa, etc Will the project run without them or where can I take those from?
The following might help you: - http://www.xwiki.org/xwiki/bin/view/Community/SourceRepository - http://www.xwiki.org/xwiki/bin/view/Community/Building Thanks -Vincent
Thanks a lot, Vincent! I just don't know how didn't I see that part of the documentation; everything is spelt out so clearly there, and I was trying to do everything manually (I almost did it apart from the last step :-) Cheers, Darina ________________________________ From: Vincent Massol [mailto:[email protected]] Sent: Thursday, March 15, 2007 12:52 PM To: [email protected] Subject: Re: [xwiki-users] Downloading xwiki source distribution Hi Darina, On Mar 15, 2007, at 5:43 PM, Dicheva, Darina wrote: Hello all, I am trying to download the xwiki source distribution, however, I haven't used SVN repository before and I am confused. I saw that under xwiki there are 3 subdirectories: branches, tags, and trunk. In branches I saw \bin\xwiki\branches\XWIKI_1_0, but in tags I found \bin\xwiki\tags\XWIKI_1_0_BETA_5. Which one should I important in my Eclipse? Also when I looked at the lib subdirectory I saw that a few jars are marked as 'UNKNOWN', e.g. alexa, etc Will the project run without them or where can I take those from? The following might help you: - http://www.xwiki.org/xwiki/bin/view/Community/SourceRepository - http://www.xwiki.org/xwiki/bin/view/Community/Building Thanks -Vincent
participants (5)
-
Antonio Goncalves -
Dicheva, Darina -
Sergiu Dumitriu -
Vincent Massol -
Zeljko Trogrlic