bespokejs / generator-bespoke Goto Github PK

From what I can tell, gulp-jade hasn't been updated since 2015, while gulp-pug is actively maintained by the pugjs crew, and has several recent bugfixes that gulp-jade is missing.

The Asciidocotor Bespoke converter writes speaker notes into an aside element with the role "note" (which is pending a rename to "notes"). These elements should be hidden by default. They are enabled by a speaker notes plugin.

aside[role=note], aside[role=notes]
  display none

Instead of just the cube, the transition also seems to wildly zoom in as well.

After generating a project with this generator and creating a presentation I wanted to print out the presentation to a PDF. Using the Nebula theme gave me a print preview with no pages at all. Using the default Cube theme only gives me the last page in a print preview.

• Is it something I am doing wrong? (presentation I am trying to print)
• Is it a bug?
• Or does Bespoke.js just not handle printing at the moment?

Thanks!

If we switch to the npm version, that means we can simplify stuff by nuking debowerify.

It would be nice to have two (or more) presentations in one project. Is this possible?

E.g. index.jade is the main presentation, but another-one.jade could be accessible through /another-one.html.

I'm guessing a lot of users would choose to license (some) presentations under Creative Commons or somesuch, but didn't think to do so. It would be awesome if generator-bespoke would prompt the user to do this.

I would like to print my presentation's https://github.com/pmalek/knngraphs/tree/gh-pages-src slides into pdf but when I try to print it in Google Chrome into pdf then I get like 2.5 slides on the page.

I have generated the template with bespoke-generator 0.9.

I have tried adjusting the styles but nothing changes. I have changed default styles/main.styl generated by bespoke generator to following:

slide_width = 1180px
slide_height = 700px

but the default values give the same results. I have also tried changing:

.bespoke-slide
  ...
  @media print
    height: 743px // seems to correspond with an A4, landscape page height

but nothing changes either.

Additionally : how can I change the orientation so that printed slides are also landscape as the presentation in the browser?

Works fine in Chrome and FF, but viewed in Safari, all the code snippets display very strangely (see image below).

Not sure if this is an upstream issue or not, but thought I'd let you know.

Hi everyone,

We're working on a new version of this generator and your help is welcomed. Yeah 🎉🎉 !

You can see the proposed changes in the v3 branch.

Why?

The main goals of this v3 are :

• Update all the dependencies (latest version or alternative)
• Simplify the questions process (too many questions, lots of plugins should be default)
• Solve the current issues

The roadmap

PDF generation

The current PDF generation is done with davidmarkclements/bespoke-pdf and davidmarkclements/bespoke-to-pdf. It uses a NW.js app which itself uses an old Webkit engine 😞.

We want authors to be able to use the latest CSS techniques if they want like flexbox and object-fit. In order to do so, we will remove the PDF option in the generator and push authors to use up-to-date projects like astefanutti/decktape.

We need to make sure that this kind of project stays compatible with this generator and the bespoke ecosystem in general.

Bespoke plugins as default

• bespoke-bullets
  
  This plugin will be replaced with a new approach in the future (bespoke-builds).
• bespoke-scale
  
  This plugin will be replaced with a new approach in the future (ask @mojavelinux).
• bespoke-hash
• bespoke-classes
• bespoke-extern
  
  For now, this is required for PDF generation.

Bespoke plugins as option

• Add bespoke-multimedia as an option.

Bespoke plugins to replace

• Use bespoke-nav instead of bespoke-keys and bespoke-touch.
• Replace bespoke-theme-cube with basic styles in the generated code.

Bespoke plugins to remove

• bespoke-pdf
  
  Explained in a previous section.
• bespoke-backdrop
  
  Most slide deck don't really need this feature.
• bespoke-progress
  
  Most of the time this feature is a distraction for the audience.
• bespoke-forms
  
  Most slide deck don't really need this feature.

Generator & build dependencies to update

A lot of the gulp/build dependencies need to be updated or removed.

• Remove sindresorhus/opn, this behaviour feels very annoying.
• We also need to update to the latest yeoman generator framework.
• gulp-browserify seems deprecated. We will have to update to the new gulp+browserify way.
• Remove bower and use prismjs from NPM.
• prismjs support should be moved to a plugin.

Templating options

For now, only Jade is supported 😢.

• Authors should be able to write plain HTML (see #35)
• Authors should be able to write AsciiDoc with AsciiDoctor.
• We need to update Jade to Pug since the project got renamed.
• Use coderay (and rouge) enabled with AsciiDoc and don't ask for prism in those cases

Tests

• Test that generated files are OK
• Test that gulp serve works OK
• Test that gulp build works OK

Turns out this is because yeoman removed colors.js as a dependency.

Same as a bunch of other generators have experienced: yeoman/generator-webapp#137

The fix is to upgrade yeoman-generator and use chalk for colours; pull request incoming shortly.

Include a task in the Gulp build that copies custom fonts.

It may be time to update some of the dependencies the generator brings in. Currently, npm throws security warnings as a result of some of the things that gulp <4 brings in, and github throws warnings as a result of one of the dependencies (lodash.template) of the now depreciated gulp-util.

Open questions :

• Is this a problem that NPM won't recognize README.adoc?
• Do we maintain 2 two files a markdown version for HTML and Pug and another for AsciiDoc or do we have another solution? (we already have 3 very similar index templates).

If I create a presentation without a pre-made theme, main.styl contains a reference to prism-okaidia.css and, because this file is not available, it throws the following error.

[17:16:07] Plumber found unhandled error:
 Error in plugin 'gulp-stylus'
Message:
    /Users/christiangiordano/Documents/Barclays/Visual Language/presentations/barclays-body-language/src/styles/main.styl:9:9
    5| // thanks to Stylus' "import css" and "paths" options
    6| 
    7| @import 'normalizecss/normalize.css'
    8| 
    9| @import 'prism/themes/prism-okaidia.css'
--------------^
   10| // Check out "bower_components/prism/themes/" for available themes
   11| 
   12| // Style using Bespoke Classes: https://github.com/markdalgleish/bespoke-classes

failed to locate @import file prism/themes/prism-okaidia.css

The main.styl starts with:

// New to Stylus? Check out http://learnboost.github.io/stylus
// Use modern CSS thanks to Autoprefixer: https://github.com/ai/autoprefixer

// Import CSS from "node_modules" and "bower_components"
// thanks to Stylus' "import css" and "paths" options

@import 'normalizecss/normalize.css'

@import 'prism/themes/prism-okaidia.css'
// Check out "bower_components/prism/themes/" for available themes

// Style using Bespoke Classes: https://github.com/markdalgleish/bespoke-classes

.bespoke-parent
...

After generating my presentation, when doing gulp serve I was getting this error.

events.js:141
      throw er; // Unhandled 'error' event
      ^

Error: listen EADDRINUSE :::8080
    at Object.exports._errnoException (util.js:860:11)
    at exports._exceptionWithHostPort (util.js:883:20)
    at Server._listen2 (net.js:1234:14)
    at listen (net.js:1270:10)
    at Server.listen (net.js:1366:5)
    at ConnectApp.server (/home/santiago/proyectos/js/marionette-presentation/node_modules/gulp-connect/index.js:57:19)
    at new ConnectApp (/home/santiago/proyectos/js/marionette-presentation/node_modules/gulp-connect/index.js:37:10)
    at Object.module.exports.server (/home/santiago/proyectos/js/marionette-presentation/node_modules/gulp-connect/index.js:170:12)
    at Gulp.<anonymous> (/home/santiago/proyectos/js/marionette-presentation/gulpfile.js:83:11)
    at module.exports (/home/santiago/proyectos/js/marionette-presentation/node_modules/gulp/node_modules/orchestrator/lib/runTask.js:34:7)

I manage to fix it by changing the configuration of the gulp file in my presentation.

gulp.task('connect', ['build'], function() {
  connect.server({
    root: 'dist',
    port: 8081,
    livereload: true
  });
});

The file in app/templates/gulpfile.js should be checked.

Thank you!

I have created my first bespokejs app via this generator. And I was quiet sad to see a Jade file for writing our slides. I dislike this syntax, and I would prefer to use HTML.
We can add a parameter to Yeoman, in order to ask to the user which syntax he wants to use.
What do you think ?

Is it possible to create presentations with markdown?

npm init guesses the location of the repository when generating package.json. We should follow suit.

gulp-browserify is no longer maintained. It depends on browserify 3.x which is very old version.

I have seen that https://github.com/tschaub/grunt-gh-pages has parameter for commit message

--gh-pages-message 'Tagging v1.2.3'

Can we introduce the same in generator-bespoke? To pass the parameter from grunt deploy in generator to grunt-gh-pages

Configure the Travis CI job to publish a release to npm when a tag is pushed to the git repository.

Use the npm releasing feature of Travis CI.

Hey,

I'm just starting using bespoke, and are lame in javascript (<24hrs of experience), but I noticed that there's a slight problem when using gulp-browserify with bespoke-notes:

[20:42:05] Finished 'css' after 1.44 s
[20:42:05] Plumber found unhandled error:
Error in plugin 'gulp-browserify'
module "./style" not found from "./node_modules/bespoke-notes/index.js"
[20:42:05] Finished 'js' after 1.9 s
[20:42:05] Starting 'build'...

Strange enough, it all works with 'npm start', somebody help please :)

The top-level clean task, which removes the dist folder, should run synchronously. Otherwise, it may end up deleting the dist folder after files have been written to it by subsequent tasks.

This is the only clean task that needs to be synchronous. The other clean tasks only work on the files that they are managing and therefore do not run the risk of deleting a file generated in the same process.

Seems to be due to Windows using \ instead of / for path separators.

Will submit patch if I can figure it out.

I have just tried pushing the page generated with generator-bespoke to github pages with grunt deploy and it has deployed bower_components to my gh-pages branch which is unneeded since the scripts are minified to scripts/whatever.js and styles are minified to styles/whatever.cs

Where can I find the definition of deploy task and how can we fix that so that bower_components is not pushed?

I have been manually pushing so far only those files (generated with generator-bespoke) to gh-pages branch and it worked fine:

$ls
image.png index.html  scripts  styles