supercollider / supercollider.github.io Goto Github PK

View Code? Open in Web Editor NEW

30.0 23.0 78.0 81.28 MB

Website for SuperCollider

Home Page: http://supercollider.github.io

HTML 42.45% Ruby 2.14% SCSS 50.82% JavaScript 4.59%

supercollider.github.io's Introduction

supercollider.github.io

Local Usage

Clone this repository:

git clone https://github.com/supercollider/supercollider.github.io.git
cd supercollider.github.io

This website is powered by jekyll so in order to view it locally you'll need to have Ruby and Gems installed on your computer.

Then, install jekyll and bundler gems:

gem install jekyll bundler

Install dependencies:

bundle install

Now you can run jekyll server:

bundle exec jekyll serve

And then, in your browser:

http://127.0.0.1:4000

Update This Website

CSS Updates

We use sass variables so changing colors can be done by editing assets/css/_variables.scss. Otherwise, the main sass file is assets/css/main.scss.

If you wanna be sure that your CSS changes are going to be effective in the browsers you'll have to update site_version in _config.yml (css cache bust).

Downloads

To update download links, you'll have to edit _data/downloads.yml.

Please keep in mind that the Download section on the index page will display the first download for each OS in the current_version category (order matters).

Code Snippets

To add a code snippet to the main page:

edit _data/code_snippets.yml
add the corresponding audio file in assets/audio

Gallery

To add a project to the Projects page:

edit _data/gallery.yml with your project data (see examples below)
if your project is represented by an image, add the corresponding image in images/gallery

Image

- title: YOUR TITLE
  type: image
  image: YOUR IMAGE
  link: YOUR LINK
  author: YOUR AUTHOR NAME
  text: |
    YOUR TEXT

Vimeo or YouTube video

- title: YOUR VIDEO TITLE
  type: vimeo (or youtube)
  id: YOUR VIDEO ID
  text: |
    YOUR TEXT

supercollider.github.io's People

Contributors

Stargazers

Watchers

supercollider.github.io's Issues

Slack / Scsynth?

sciss wrote on sc-dev:

someone asked me how to see SC activity; since I'm no longer that
involved, I thought I look it up on the page:

https://supercollider.github.io/

If you scroll down to Community, there is a link to 'Slack' but if you
follow it, I get "This link is no longer active"

On the repo README.md, there is link to https://scsynth.org/

I think probably website should remove Slack link and add scsynth.org link.

Now that GH pages moved to https, fonts are not loaded by our old theme.
I'm willing to redesign the whole site by using a modern, minimal and sleek theme (à la https://supercollider.github.io/sc3-plugins).. This would be my summer-holidays-present : )

2021 update

I'm gonna propose a fresh new website, with a simple and modern design (mobile friendly).
Seeing that over the last 4 years there were no real consensus reached as to what content should or should not go I'm gonna propose something very minimal and if the community likes it someone can take over from there : )

use modern jekyll folder structure
use mobile-first simple theme
remove cruft and keep concise minimal content
.md files over .html when possible
add a carousel/gallery with community projects
dedicated download page (we have too many possible downloads)
audio snippets for code examples

Move wiki pages to GH wiki

Hi everybody, it's been a while :)

What about moving all wiki pages from the website to the Github wiki?
I have some free time...

Website WIKI pages

supercollider.github.io forensyc analysis results - hidden sections, how to access?

_{i noticed throughout a forensic analysis, that just came up for the sake of learning some stuff related to websecurity, that the supercollider website, has some hidden sections, include, not only, but as well:}

/news (Status: 200)]]
/images (Status: 301)
/index (Status: 200)
/links (Status: 200)
/downloads (Status: 200)
/projects (Status: 200)
/feed (Status: 200)
/releases (Status: 301)
/assets (Status: 301)
/book (Status: 301)
/courses (Status: 301)
/survey (Status: 301)
/development (Status: 301)
/uncategorized (Status: 301)
/examples (Status: 200)
/workshops (Status: 301)
/404 (Status: 200)
/symposium (Status: 301)
/2012 (Status: 301)
/meetups (Status: 301)

_{how can i access all those, and more important how can i copy the information which is there for my hard drive, and having it all neat and organized locally}

Improve Contributing page

this issue is mostly a "note to self" since I'm probably going to do this. the Contributing page could use some more visibility and content, so it's easy to find and has all the information new developers need to work on SC

fix links on community page

In the preview they look fine:

https://github.com/supercollider/supercollider.github.io/blob/master/community/systems-interfacing-with-sc.md

but on the site it doesn't work:

http://supercollider.github.io/community/systems-interfacing-with-sc

the footnote style links do not work. They are messy to deal with anyway; all links should be inline.

slack invite not working

On page:
https://supercollider.github.io/

pointing to: https://join.slack.com/t/scsynth/shared_invite/enQtMzk3OTY3MzE0MTAyLWY1ZGE1MTJjYmI5NTRkZjFmNjZmNmYxOWI0NDZkNjdkMzdkNjgxNTJhZGVlOTEwYjdjMDY5OWM0ZTA4NWFiOGY

takes the user to

Do we have an updated address?

Add 3.7.0 release to News

SC 3.7.0 release needs to be announced on the homepage.

Youtube example playlist: "The video does not exist"

http://supercollider.github.io/examples/audio-examples.html

Gives a "The video does not exist" message

jekyll build error

I was using ruby 2.0.0p195 and jekylll 1.2.1
it seems that markdown parsing have some problem

| Illegal character '&' in raw string "http://mailhide.recaptcha.net/d?k=01YVFnHW9NHLw39fEf2vm6mw==&c=ct4jjs4oH5itVZAFwWghfBP-5PfgsNuW15Gikv_byzQqQSSmTPpvOvuzkvw7KXZLWPIDEtGHNx693fKe1No2Qg=="
| Line: 3
| Position: 342
| Last 80 unconsumed characters:
| >
+---------------------------------------------------------------------------
!/Users/sean/.rvm/gems/ruby-2.0.0-p195@global/gems/maruku-0.6.1/lib/maruku/errors_management.rb:56:in `maruku_recover'
!/Users/sean/.rvm/gems/ruby-2.0.0-p195@global/gems/maruku-0.6.1/lib/maruku/helpers.rb:96:in `rescue in md_html'
!/Users/sean/.rvm/gems/ruby-2.0.0-p195@global/gems/maruku-0.6.1/lib/maruku/helpers.rb:85:in `md_html'
!/Users/sean/.rvm/gems/ruby-2.0.0-p195@global/gems/maruku-0.6.1/lib/maruku/input/parse_block.rb:255:in `read_raw_html'
!/Users/sean/.rvm/gems/ruby-2.0.0-p195@global/gems/maruku-0.6.1/lib/maruku/input/parse_block.rb:88:in `parse_blocks'
\___________________________________________________________________________
  Conversion error: There was an error converting 'community/1-mailing-lists.md

I think we need to specify ruby version and jekyll version in a Gemfile, maybe change a markdown parser in _config.yml?

Improved projects page

I think there should be a better-organized and more comprehensive page for projects done in SC. From my experience with other languages, one of the first questions I ask when coming to new software is "what can I do with this, and what have others done with it?". What the community is doing (and therefore what kind of projects they might be helpful with or have experience with) seems to me to be a crucial feature of any software project. A well-documented projects page can also serve as a repository of ideas and inspiration for future projects. I think these sentiments might be shared by a significant number of newcomers to SC.

Some features I think would be important:
Embedded sound and video (youtube / soundcloud links)
a short blurb for each project summarizing what it is and how it uses SC
maybe categories for projects? Composition, sound installation, instrument, etc?
snippets of code accessible straight from the browser, for projects where that makes sense

Examples of projects pages that I think do a good job(we don't necessarily have to copy these, but it's worth discussing whether we think they're good and how)

https://cycling74.com/community/?q=project
https://processing.org/exhibition/

I particularly like the Processing projects page - it's concise, curated and has a lot of description up front.

Let me know what you think!

Issues with front page examples

@shimpe wrote:

I'd like to flag some shortcomings of the webpage. After all, there's only one chance to make a first impression.

The atari example on the web page apparently requires one to install an Atari UGen. This is not mentioned or explained anywhere on that page (I had to check the source code to find out where to get it!). New users pasting the example code in supercollider for the first time therefore are met with error messages without any clue how to go about solving them = instant turn-off.
Examples on the front page probably should also explicitly mention that one has to boot a server first (or should be rewritten using s.waitForBoot).

general layout

The layout as a whole looks a little awkward: it may be better to align the sections the same way as the images, and also not just vertically?

This does not work anymore: Ndef and ".setAt" -- Why? [SC >= 3.9.1]

Hi,

I just installed SC 3.9.1 under Windows 7. I managed to build polyphonic Ndef with the following code (with SC 3.9.0) but now it says ".setAt not understood". Has it been removed? Why is it broken now?

########################
(
SynthDef( \myInstr1, { arg freq = 440, amp = 0.25, xgate = 0;
var e = EnvGen.kr(Env.asr(0.01, 1, 1, -4), gate: xgate, doneAction:0);
var sig = SinOsc.ar( freq!2, 0, e * amp );
Out.ar(0, sig);
}).send;
)

Ndef(\test1).play;
Ndef(\test1).put( 0, \myInstr1, 0, [\freq, 60.midicps, \xgate, 0]);
Ndef(\test1).setAt( 0, \xgate, 1 );
...
########################
I used to make polyphonic sound with many instances build with many ".put( ...".

Jekyll build broken locally

With a recent clone, building the site locally is broken:

ERROR: YOUR SITE COULD NOT BE BUILT:
------------------------------------
Invalid date '<%= Time.now.strftime('%Y-%m-%d %H:%M:%S %z') %>':
Document 'vendor/bundle/ruby/2.7.0/gems/jekyll-3.9.0/lib/site_template/_posts/0000-00-00-welcome-to-jekyll.markdown.erb'
does not have a valid date in the YAML front matter.

ArchLinux
ruby-2.7.3p183

Re jekyll/jekyll#5267

Design issues

Small css issues:

SC logo is misplaced (index page)
SC title should have a slight shadow (all pages except index)
padding is missing between projects (projects page)
there should be at least 2 projects per row on wide resolutions (projects page)
open source has too much emphasis (index page)

home page contains dead link

https://supercollider.github.io/ mentions
"
Communicates via Open Sound Control - TCP/UDP network communication
"

The first part of this quote is a link to a non-existing page http://doc.sccode.org/Reference/Server-Command-Reference

Raspberrypi instructions do not work

http://supercollider.github.io/development/building-raspberrypi.html

Trying on a Raspberry PI 3 Model B.

Step 6.2:

sclang #should start sc and compile the class library with only 3 harmless class overwrites warnings

init_OSC
empty
compiling class library...
initPassOne started
    NumPrimitives = 590
initPassOne done
    compiling dir: '/usr/local/share/SuperCollider/SCClassLibrary'
    pass 1 done
ERROR: Class extension for nonexistent class 'Document'
     In file:'/deprecated/3.7/deprecated-3.7.sc'
    numentries = 658972 / 6661008 = 0.099
    3672 method selectors, 1814 classes
    method table size 4425868 bytes, big table size 26644032
    Number of Symbols 8839
    Byte Code Size 251349
    compiled 219 files in 0.88 seconds

Info: 3 methods are currently overwritten by extensions. To see which, execute:
MethodOverride.printAll

compile done
Execution warning: Class 'NotificationCenter' not found
ERROR: Message 'isMetaClass' not understood.
RECEIVER:
   nil
ARGS:
CALL STACK:
    DoesNotUnderstandError:reportError   0x13b5dd0
        arg this = <instance of DoesNotUnderstandError>
    Nil:handleError   0x13b5e30
        arg this = nil
        arg error = <instance of DoesNotUnderstandError>
    Thread:handleError   0x13b5e90
        arg this = <instance of Thread>
        arg error = <instance of DoesNotUnderstandError>
    Object:throw   0x13b60d0
        arg this = <instance of DoesNotUnderstandError>
    Object:doesNotUnderstand   0x13b63d0
        arg this = nil
        arg selector = 'isMetaClass'
        arg args = [*0]
    Meta_Class:initClassTree   0x13b64f0
        arg this = <instance of Meta_Class>
        arg aClass = nil
        var implementsInitClass = nil
    Meta_Server:initClass   0x13b2d90
        arg this = <instance of Meta_Server>
    Meta_Class:initClassTree   0x13b5ef0
        arg this = <instance of Meta_Class>
        arg aClass = <instance of Meta_Server>
        var implementsInitClass = nil
    Meta_Event:initClass   0x13b6370
        arg this = <instance of Meta_Event>
    Meta_Class:initClassTree   0x13b3170
        arg this = <instance of Meta_Class>
        arg aClass = <instance of Meta_Event>
        var implementsInitClass = nil
    Meta_EventTypesWithCleanup:initClass   0x13b4710
        arg this = <instance of Meta_EventTypesWithCleanup>
    Meta_Class:initClassTree   0x13b5f50
        arg this = <instance of Meta_Class>
        arg aClass = <instance of Meta_EventTypesWithCleanup>
        var implementsInitClass = nil
    ArrayedCollection:do   0x13b3230
        arg this = [*149]
        arg function = <instance of Function>
        var i = 27
    Meta_Class:initClassTree   0x13b2a30
        arg this = <instance of Meta_Class>
        arg aClass = <instance of Meta_Object>
        var implementsInitClass = nil
    Process:startup   0x13b20f0
        arg this = <instance of Main>
        var time = 0.899260664
    Main:startup   0x13b1310
        arg this = <instance of Main>
        var didWarnOverwrite = false
^^ The preceding error dump is for ERROR: Message 'isMetaClass' not understood.
RECEIVER: nil


sc3> s.boot
ERROR: Message 'boot' not understood.
RECEIVER:
   nil
ARGS:
CALL STACK:
    DoesNotUnderstandError:reportError   0x13b5230
        arg this = <instance of DoesNotUnderstandError>
    Nil:handleError   0x13b5290
        arg this = nil
        arg error = <instance of DoesNotUnderstandError>
    Thread:handleError   0x13b5350
        arg this = <instance of Thread>
        arg error = <instance of DoesNotUnderstandError>
    Object:throw   0x13b53b0
        arg this = <instance of DoesNotUnderstandError>
    Object:doesNotUnderstand   0x13b5530
        arg this = nil
        arg selector = 'boot'
        arg args = [*0]
    Interpreter:interpretPrintCmdLine   0x13b2df0
        arg this = <instance of Interpreter>
        var res = nil
        var func = <instance of Function>
        var code = "s.boot"
        var doc = nil
        var ideClass = nil
    Process:interpretPrintCmdLine   0x13b5770
        arg this = <instance of Main>
^^ The preceding error dump is for ERROR: Message 'boot' not understood.
RECEIVER: nil


sc3>

pages build failure

I just approved a pull request, that just adds an image file. I got a pages "build failure" email from github.

Dan Stowell added something yesterday and from the looks of the front page it did not successfully build after that. I don't see any reason why though, it looks quite simple.

but it seems to have broken there.

9b4d7d0

still investigating. I will have to do a pull and local buildout to figure it out. if anybody else has time, please look into it if you have the chance.

Wiki migration is incomplete

There's still some text and media on the wiki that hasn't been imported yet: http://supercollider.sourceforge.net/wiki/index.php/Special:AllPages

Jekyll Bootstrap framework has a known incompatibility with Jekyll v3.1.

I just got this message when editing the pages:

The page build completed successfully, but returned the following warning:

You are currently using the Jekyll Bootstrap framework which has a known incompatibility with Jekyll v3.1. To fix this incompatibility, change `page.theme.name` in `_includes/JB/setup` to `layout.theme.name`. Your site may not build properly until this change has been applied. For more information, see http://jekyllrb.com/docs/upgrading/2-to-3/#layout-metadata.

For information on troubleshooting Jekyll see:

 https://help.github.com/articles/troubleshooting-jekyll-builds

If you have any questions you can contact us by replying to this email.

is it save to just do this? @crucialfelix ?

"Edit this page" link doesn't work for news posts

For example:

Go to http://supercollider.github.io/workshops/2013/10/07/supercollider-workshop-in-Vigo-introduction-to-supercollider/
Scroll to the bottom and click "Edit this page", which links to https://github.com/supercollider/supercollider.github.io/edit/master/workshops/2013/10/07/supercollider-workshop-in-Vigo-introduction-to-supercollider
Hit a smug 404 page.

Announce 3.8.0 beta

upgrade to new markdown interpreter

The page build completed successfully, but returned the following warning:

Your site is using Maruku, the default Markdown interpreter. Maruku is now obsolete and may cause builds to fail for sites with invalid Markdown or HTML. See https://help.github.com/articles/migrating-your-pages-site-from-maruku for more information on upgrading to a newer Markdown interpreter.

For information on troubleshooting Jekyll see:

https://help.github.com/articles/using-jekyll-with-pages#troubleshooting

If you have any questions please contact us at https://github.com/contact.