Working with Sakai 11 skin

89 views
Skip to first unread message

sa...@st.ug.edu.gh

unread,
Oct 30, 2017, 1:18:11 PM10/30/17
to Sakai Users Group
Hi All,

I recently installed sakai 11 and will really love it if someone could point me to documentation on customizing/editing/creating skins. I have been cracking my head at this but I think I'm 
going about it the wrong way. Are there any requirements in using morpheus-master/sass to compile skins. Any assistance here will be greatly appreciated.

Thank you

Neal Caidin

unread,
Oct 30, 2017, 1:27:41 PM10/30/17
to sa...@st.ug.edu.gh, Sakai Users Group

--
You received this message because you are subscribed to the Google Groups "Sakai Users Group" group.
To unsubscribe from this group and stop receiving emails from it, send an email to sakai-user+unsubscribe@apereo.org.
To post to this group, send email to sakai...@apereo.org.
Visit this group at https://groups.google.com/a/apereo.org/group/sakai-user/.

Neal Caidin

unread,
Oct 31, 2017, 1:14:46 PM10/31/17
to Sakai Administrator, sakai-dev, sakai-user
Hi ,

I don't know the answer to your questions. I don't know much about how to configure the skin, just where to find the documentation ;-).

I'm looping back in sakai-user and sakai-dev. 

Please see below.

-- Neal


On Tue, Oct 31, 2017 at 10:44 AM, Sakai Administrator <sa...@st.ug.edu.gh> wrote:
Hi Neal,

I have looked at the link you sent me. Do I have to install sass on my server and use it to convert the .scss files to css, edit and then recompile 
the .css file to .scss? 

I ask so because I followed the instructions in the link, made some changes particularly to colors in say _defaults.scss (using "vi _defaults.scss" command) and used 
mvn clean install -P compile-skin
but still no effect.

Even tried editing _customization.scss still with no luck.
Am I missing something or going about this all wrong?

Sakai Administrator

unread,
Oct 31, 2017, 1:48:00 PM10/31/17
to Neal Caidin, sakai-dev, sakai-user
Thanks for your effort Neal.

However is your statement "Please see below" supposed to point/draw my attention to something? If so, what is it because there is nothing
else below that statement.

Thanks

Neal Caidin

unread,
Oct 31, 2017, 2:04:51 PM10/31/17
to Sakai Administrator, sakai-dev, sakai-user
Your questions which I could not answer:

> I have looked at the link you sent me. Do I have to install sass on my server and use it to convert the .scss files to css, edit and then recompile 
the .css file to .scss? 

> I ask so because I followed the instructions in the link, made some changes particularly to colors in say _defaults.scss (using "vi _defaults.scss" command) and used 
> mvn clean install -P compile-skin
> but still no effect.

> Even tried editing _customization.scss still with no luck.
>Am I missing something or going about this all wrong?

Austin

unread,
Oct 31, 2017, 3:16:16 PM10/31/17
to sakai-dev, sakai-user
- I didn't need to install sass, just compiling sakai worked for me.
- I didn't use "-P compile-skin"
- after you compile, check if this folder exists:  /reference/library/src/webapp/skin/morpheus-default and if the change you made shows up in any of the resulting .css files (usually tool.css)
- check the tomcat folder's /webapps/library/skin/morpheus-default/ .css files for the changes you made
- depending what what you are editing in _default.css (especially colors), you may need to include !default
- I had trouble using _customization.css.  some options like the main logo or fonts worked, but changing colors for the background did not.  So, I'm only using _default.css for my changes.


Sakai Administrator

unread,
Nov 1, 2017, 8:33:02 AM11/1/17
to Austin, sakai-dev, sakai-user
Hi,

- I didn't use the "-P compile-skin" like you said
- after compiling, the folder /library/src/webapp/skin/morpheus-default exists but the changes made do not show up in any of the resulting .css files.
- tomcat folder's /webapps/library/skin/morpheus-default/ .css files do not also have the changes in them.
- included !default  (a bit confused as to whether you mean _defaults.scss or there is a _default.css).

Any further assistance?

You received this message because you are subscribed to the Google Groups "Sakai Development" group.
To unsubscribe from this group and stop receiving emails from it, send an email to sakai-dev+unsubscribe@apereo.org.
To post to this group, send email to saka...@apereo.org.
Visit this group at https://groups.google.com/a/apereo.org/group/sakai-dev/.

Austin

unread,
Nov 1, 2017, 3:24:34 PM11/1/17
to Sakai Administrator, sakai-dev, sakai-user
sorry, yes, I meant _defaults.scss

Take a look at compile-skin.md... I wouldn't think you'd need this if you are using the default morpheus-master folder, but maybe try adding this when you compile

-Dsakai.skin.source=morpheus-master -Dsakai.skin.target=morpheus-default

Or change the source and target to what ever you are using.  That's what I ended up doing.  I made a copy of morepheus-master, made my changes there, pointed the -Dsakai.skin.source to my copied folder and set the target to create a folder name similar to my source folder e.g. -Dsakai.skin.source=morpheus-master-uhawaii -Dsakai.skin.target=morpheus-default-uhawaii

There's some instruction in there about using custom skin files, -Dsakai.skin.customization.file=, but I couldn't quite get that working so I'm just modifying _defaults.scss in my copied folder and setting the source.

Austin

unread,
Nov 1, 2017, 9:44:25 PM11/1/17
to Sakai Administrator, sakai-dev, sakai-user
Also check sakai.properties.  The default is:

skin.default=default

but you may need to change it to:

skin.default=morpheus-default

depending on what target you used in -Dsakai.skin.target=

Sakai Administrator

unread,
Nov 2, 2017, 12:40:19 PM11/2/17
to Austin, sakai-dev, sakai-user
Thanks Guys,

I have managed to get things working now. Thanks for the tremendous assistance.

Cheers

Austin

unread,
Dec 4, 2017, 7:10:04 PM12/4/17
to sakai-dev, sakai-user
Hello All,

In Sakai 11.4 (sorry, I haven't checked 12 yet), I recently discovered that if you are using a custom skin "name" and compiling with either or both of these:

-Dsakai.skin.target=
-Dsakai.skin.source=

you will also need to modify _defaults.scss and change the value of:

$skin-name : "morpheus-default"; // This is used for bootstrap font behaviour.


And use your custom skin-name.  Otherwise, some files such as:

library/skin/morpheus-default/fonts/bootstrap/glyphicons-halflings-regular.woff2
library/skin/morpheus-default/fonts/bootstrap/glyphicons-halflings-regular.woff
library/skin/morpheus-default/fonts/bootstrap/glyphicons-halflings-regular.ttf
library/skin/morpheus-default/fonts/bootstrap/glyphicons-halflings-regular.eot
library/skin/morpheus-default/fonts/bootstrap/glyphicons-halflings-regular.svg

will be called with the default skin path instead of your custom skin.  It would be great if instructions about that could be added to:


Thanks,

Austin


Reply all
Reply to author
Forward
0 new messages