Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

General Site for JuliaMusic Org using Franklin.jl #9

Open
ashwanirathee opened this issue Jun 13, 2020 · 14 comments
Open

General Site for JuliaMusic Org using Franklin.jl #9

ashwanirathee opened this issue Jun 13, 2020 · 14 comments

Comments

@ashwanirathee
Copy link

@team @Datseris
I believe there is a need to develop a community around JuliaMusic
Quoting Viral shah

Many packages only have documentation, but the orgs do not yet have websites - since nobody has 
done it yet. Examples where there are websites are fluxml.ai and jump.dev. Those should serve as 
good starting points - gather the materials, packages, documentation, examples, videos and
present them on the website.

We also only have documentation,we need to start collecting literature and people work's using JuliaMusic Packages..
I therefore propose we start working on it and develop the general site.I believe most of the people currently working on JuliaMusic maintain a blog and I also do it..So putting together a static site won't be that tough and it can be put together within a few days... I have quite a lot of time at my hand right now,so I can work on it...
Also @Datseris ,I have seen in bokeh that ("@bokeh/dev") is used to call for the whole development team,can It be made available here too??Probably also start a slack if there is not one already...

@Datseris
Copy link
Member

There is a slack #music-dev, but at there isn't any team. The only person working on JuliaMusic in a the more general sense is myself, while (to the best of my knowledge) @aminya only works on MusicXML.jl . Every other member of the org is inactive.

So I find this issue very low priority, you can of course feel free to start working on a site :P

We also only have documentation,we need to start collecting literature and people work's using JuliaMusic Packages..

I do scientific research using JuliaMusic but I don't think anyone else does. MIDI.jl has an associated paper but it doesn't have any citations outside mine.

@ashwanirathee
Copy link
Author

ashwanirathee commented Jun 13, 2020

oK!!There seems a lot of work that could be worked upon then :)
I will do the site work and the librosa work.I believe there has been a lot of work done by you guys and lot more needs to be done..community developement is still in pretty early stages for julia..MIR community is already pretty small,getting them to show interest here is more interesting task... @Datseris and team guidance every now and then is all I need,lol :)

@aminya
Copy link
Member

aminya commented Jun 13, 2020

Regarding the team stuff, 😄 I have been busy developing and fixing MusicXML.jl itself.

There is still some stuff to fix before I can help with other packages.

For example, JuliaMusic/MusicXML.jl#30 or JuliaMusic/MusicXML.jl#46 and finally JuliaMusic/MusicXML.jl#3

@aminya
Copy link
Member

aminya commented Jun 13, 2020

I like to see a unified website. Especially, if it addresses the issue in #5. I prefer to write the documentation of each package in its repository. If there is a way to bring all those into a single website, it would be good.

Similar to https://juliarobotics.org/

@Datseris I think this issue should move to https://github.com/JuliaMusic/JuliaMusic_documentation.jl

@ashwanirathee
Copy link
Author

@team pretty optimistic that there will be a need of a team to maintain this place in 5 years time :)

@Datseris Datseris transferred this issue from JuliaMusic/MusicProcessing.jl Jun 13, 2020
@Datseris
Copy link
Member

Notice that we can re-use this website: https://juliadynamics.github.io/JuliaDynamics/ which comes from the main org I develop.

@aminya
Copy link
Member

aminya commented Jun 13, 2020

We might need to fix JuliaDocs/Documenter.jl#688 first, for doing this.
Allowing to cross-reference using [PackageName.function](@ref) is nice for this. Otherwise, we need to use full URLs.

@ashwanirathee
Copy link
Author

ashwanirathee commented Jun 13, 2020

I saw the julia dynamics site,it is more science type than music type :p we could try for more colorful and interactive if that's allowed @Datseris :)
One other thing,the only good part about juliarobotics website is that they have tutorials,which is super important to me atleast,so many time I just want to try something right then..
Documentations tell the scope,but idk having tutorials will be really good.If we have any milestones,it should totally be on it..

Ofcourse,they have video tutorials which I am not sure if it is feasible right now,so we can create Ijulia notebooks if that is possible in HTML format like done by steven tjoa in ipython:
musicinformationretrieval.com

@Datseris
Copy link
Member

for me this is a very low priority. The packages of JuliaMusic are very small and self contained, I doubt the existence of tutorials will make them so much more easier to learn, versus the gain tutorials have on organizations like JuliaRobotics. There of course things are much more complex.

Besides, the MIDI, MusicManipulations and MusicVisualizations already have "tutorials" in the form of runnable code that runs from within the documentation pages, e.g. https://juliamusic.github.io/JuliaMusic_documentation.jl/dev/mm/quantizing/ thus spending time to make a tutorial for something already explained so clearly, is not time well spent I feel.

I mentioned this in another PR as well, but I think what is discussed here should come after code improvements are done. For example, I load a midi file via

using MIDI

midi = readMIDIFile("test.mid")

Can I pass this midi struct directly to the MusicXML package and get the XML version? I think improvements like these are much more meaningful.

@aminya
Copy link
Member

aminya commented Jun 14, 2020

Not yet. That is being tracked in JuliaMusic/MusicXML.jl#3

However, before that, I need to merge JuliaMusic/MusicXML.jl#49, which automatically sets the graphical representation of the notes based on their duration (similar to MIDI note duration).

However, that is failing because of Julia crashes JuliaLang/julia#36269.

MusicXML is different from MIDI in many ways. MusicXML works like how humans think of music. Humans think of time signatures, pitches, rests, etc and all of these are related to each other. To automatically find the graphical representation, the code should analyze the last time signature that is defined and then adjust all the notes based on that! This makes things complex since it requires intertype communication.

@zlatanvasovic
Copy link

I'd vouch for renaming this repository to juliamusic.github.io and generating the website in a manner similar to https://juliarobotics.org/. The current name, i.e. https://juliamusic.github.io/JuliaMusic_documentation.jl/dev/ seems overly complex for the task.

@Datseris
Copy link
Member

If you know how to change Documenter.jl generated documentation links go ahead, because I don't...

@aminya
Copy link
Member

aminya commented Aug 18, 2020

For you information, I made a fix for inter-repository linking. JuliaDocs/Documenter.jl#1351 However, I am quite busy right now. I can take a look at this in one or two weeks. That will fix the issue of cross-referencing.

@Datseris
Copy link
Member

That's great, but I will be anyways including MusicProcessing.jl in the central docs as well (once it is updated of course).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

4 participants