Code Monkey home page Code Monkey logo

application_theme's Introduction

UNIBO APPLICATION THEME

This is the official Unibo Application Theme based on Foundation for Sites. Unibo Application Theme is suited for the creation and development of application website in University of Bologna network.

Unibo Application Theme inherits all the features, components, mixins, grid systems, and more already present in Foundation 6. It has a Gulp-powered build system with these features:

  • Handlebars HTML templates with Panini
  • Sass compilation and prefixing
  • JavaScript module bundling with webpack
  • Built-in BrowserSync server
  • For production builds:
    • CSS compression
    • JavaScript module bundling with webpack
    • Image compression

Installation

To use this template, your computer needs:

How clone and create a new site from this package

To manually set up the template, first download it with Git:

git clone https://github.com/unibo/application_theme.git projectname

Then open the folder in your command line, and install the needed dependencies:

cd projectname
yarn

Finally, run yarn start to run Gulp.

Your finished site will be created in a folder called dist, viewable at this URL:

http://localhost:8000/

If you need to create compressed, production-ready assets, run.

yarn run build

Repository structure

Here a brief description for repository structure.

src
├─ assets         All static files, scss and javascript files.
   ├─ img         * Images used in Application Unibo Theme.
   ├─ js          * All javascript that are not incorporated via webpack and app.js for configuration.
   ├─ scss        * All scss divided into folders by functionality
   └─ webfonts    * Used Fonts in Application Unibo Theme.
├─ data       
└─ layout         List of used template in theme.
   ├─ default     * Default Template for pages created in folder "pages".
   ├─ styleguide  * Template used for styleguide pages.
└─ pages          List of all pages.
   ├─ index       * Main page of the theme, to be updated manually, to view the content list.
   ├─ styleguide  * All styleguide pages.
   ├─ layout      * All example pages.
└─ partials       All html snippets used in pages.

Bug reports and requests for help

Is something get wrong or it's not what you expected? Please open an issue in this repository on github. Thank you for contributing!

License software of third part component

The components distributed with Unibo Applicatione Theme that have their own license other than CC0 are listed below.

Main dependencies for the build and development

  • NodeJS (Version 10 or greater recommended, tested with 10)
  • SASS node-sass, © Andrew Nesbitt, license MIT

How to use

Using this styleguide is very simple and immediate.

Download the starter kit, add <link rel="stylesheet" href="css/app.css"> inside tag <head> and <script src="js/app.js"> at the bottom of page (before end of tag <body>).

Choose a template from our styleguide and start code!

Example can be found in our demo site (italian language).

Copyright and terms of use

The license of Unibo Applicatione Theme is BSD 3-Clause and is visible in LICENSE file.

If you use Unibo Applicatione Theme for your projects, the link to this repository must be reported in the software interface exposed to the public.

Logos and Brand

application_theme's People

Contributors

lapanenka avatar mamico avatar valeriabaldelli avatar

Stargazers

 avatar  avatar

Watchers

 avatar

Forkers

parruc

application_theme's Issues

Error: The partial foundation_close_button could not be found

Steps to reproduce:

$ node -v
v10.23.1

$ yarn -v
1.22.10

$ yarn install
...
[3/4] Linking dependencies...
[4/4] Building fresh packages...
Done in 4.21s.

$ yarn run build
yarn run v1.22.10
$ gulp build --production
[17:15:42] Requiring external module @babel/register
[17:15:43] Using gulpfile ~/Work/unibo/application_theme/gulpfile.babel.js
[17:15:43] Starting 'build'...
[17:15:43] Starting 'clean'...
[17:15:43] Finished 'clean' after 5.08 ms
[17:15:43] Starting 'pages'...
[17:15:43] Starting 'javascript'...
[17:15:43] Starting 'images'...
[17:15:43] Starting 'copy'...
[17:15:44] 'pages' errored after 975 ms
[17:15:44] Error: Panini: rendering error occured.
Error: The partial foundation_close_button could not be found
    at Panini.render (.../application_theme/node_modules/panini/lib/render.js:80:11)
    at DestroyableTransform.Transform._read (.../application_theme/node_modules/readable-stream/lib/_stream_transform.js:184:10)
    at DestroyableTransform.Transform._write (.../application_theme/node_modules/readable-stream/lib/_stream_transform.js:172:83)
    at doWrite (.../application_theme/node_modules/readable-stream/lib/_stream_writable.js:428:64)
    at writeOrBuffer (.../application_theme/node_modules/readable-stream/lib/_stream_writable.js:417:5)
    at DestroyableTransform.Writable.write (.../application_theme/node_modules/readable-stream/lib/_stream_writable.js:334:11)
    at DestroyableTransform.ondata (.../unibo/application_theme/node_modules/readable-stream/lib/_stream_readable.js:619:20)
    at DestroyableTransform.emit (events.js:198:13)
    at DestroyableTransform.EventEmitter.emit (domain.js:466:23)
    at addChunk (.../application_theme/node_modules/readable-stream/lib/_stream_readable.js:291:12)
    at readableAddChunk (..../application_theme/node_modules/readable-stream/lib/_stream_readable.js:278:11)
    at DestroyableTransform.Readable.push (.../application_theme/node_modules/readable-stream/lib/_stream_readable.js:245:10)
    at DestroyableTransform.Transform.push (.../application_theme/node_modules/readable-stream/lib/_stream_transform.js:148:32)
    at Pumpify.onReadable (.../application_theme/node_modules/to-through/index.js:25:14)
    at Pumpify.emit (events.js:198:13)
    at Pumpify.EventEmitter.emit (domain.js:466:23)
[17:15:44] 'build' errored after 983 ms
error Command failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.