Comments (17)
I just started using CasparCG a 2 months ago, and didn't´t know that the ACMP documentation was outdated.
Until a new documentation version is out. Couldn't we put a note on the top of the old one saying: "All commands may not be valid for version newer than 2.0.x"
At least it would have saved me lots of hours :)
from help.
Awesome!
I made a scratch of what intuitively makes sense to me as a structure:
Guides
Getting Started (should be a hello world, rather than an install guide)
Template development
HTML
FLASH
SCENE (legacy)
Client development
Configuration
Config File
Vision mixer settings
Producers
HTML
FFMPEG
FLASH
IMAGE
COLOUR
DECKLINK
SCENE / PSD (legacy)
FRAMERATE (legacy)
ROUTE
Mixer
Consumers
BLUEFISH
DECKLINK
FFMPEG
IMAGE
NEWTEK
SCREEN
Related Projects
libraries
templates
clients
tools
Diagnostics
Supported Hardware
Minimum Requirements
Recommended system
Supported capture cards
Protocols
AMCP
OSC
from help.
Now that 2.2 is released, we need to do something about this.
I am now thinking that maintaining a separate version for each release would be best. So right now we should have a 2.0, 2.1?, 2.2 and master. When we branch off master for a new version, we should do the same in the wiki.
In the rare scenario that there is an amcp change in a patch release (2.2.0 -> 2.2.1) that should just be a comment/note in the 2.2 docs.
How did the research into other platforms go? Anything look promising enough to try out?
from help.
Hi @Julusian
Me and @5opr4ni has been talking about this earlier this week and agreed on that we need to do something quick about the wiki. We came across that I will make an overview of how the wiki should look (information wise) and how we should work with it in the future. I will sync what I came up to with some community members and make a POC. If it feels good I will reorganize the current CasparCG Wiki into the new information architecture. I will have something to share this week.
I am now thinking that maintaining a separate version for each release would be best. So right now we should have a 2.0, 2.1?, 2.2 and master. When we branch off master for a new version, we should do the same in the wiki.
I don't mind having it like this and actually think it would be best solution, but wouldn't this best apply only for the protocols? And not the general texts etc.?
How did the research into other platforms go? Anything look promising enough to try out?
I did look into some other platforms such as Gitbook but we continue to stay on GitHub for now even if the wiki feature could be better on GitHub.
from help.
@baltedewit after exploring GitBook again I have to say it has improved since I checked it last. I really think we should strive for going that way? I have created a CasparCG organization at GitBook and applied for a plan because we're an open source project.
Currently I cannot invite any members until we get the open source plan approved.
from help.
The CasparCG project has now received a free plan for open source project at GitBook 📖 ❤️ . I will start to contact community members and invite users to GitBook during this week. Before we do any documentation we should have a chat on Slack or something regarding how to structure the documentation. I will put together a group for this conversation.
Any thoughts so far?
from help.
We could create folders under server and maintain the wiki pages seperately for each version.
eg.
- server/2.0/
- server/2.1/
- server/2.2/
Although pages can be stored in folders in git (which is how you can have different sidebars in each section), each page must still have a unique name.
So should the server pages be renamed:
Server:-System-Requirements
to Server:-2.2:-System-Requirements
Or perhaps the latest version can keep the name without the version number and the deprecated versions have to use the version numbers?
What do you think?
from help.
You're absolutely right about this. I have actually been exploring other wiki solutions and to try to find a easy way to have the wiki in sync with changes in the server etc. I have been exploring Gitbook that also can be easily exported to a PDF that can be shipped with each build.
I wish GitHub could update their Wiki-feature, I have started to feel often like it's just bare minimum. That's why I have explored Gitbook as an alternative.
from help.
Do you mean Gitbook or Github Pages?
from help.
I mean Gitbook :)
from help.
Jekyll and Github Pages looks interesting (and is free)
https://jekyllrb.com/docs/github-pages/
from help.
Hi
Started to poke around in this a couple of days ago, Started to remove things and added others (INFO command) Just for my self. https://github.com/5opr4ni/help/wiki
/olle
from help.
I don't mind having it like this and actually think it would be best solution, but wouldn't this best apply only for the protocols? And not the general texts etc.?
I think we would need to do this for all the wiki contents, as over time any functionality and available producers etc will change. Even the config file structure will change a bit, so example configs will need versioning also.
I did look into some other platforms such as Gitbook but we continue to stay on GitHub for now even if the wiki feature could be better on GitHub.
There are some tools which can convert a github wiki to pdf, so we could look into using something like that to bundle it up to pdf for releases in future. Im not sure how they will play with the versioning though.
from help.
we need to do something quick about the wiki.
This was 1,5 months ago...
Looked at GitBook real quickly, seems like it supports multiple versions out of the box, is free for open source projects and can sync with GitHub. I see no reason not to use this. Can @dotarmin just set up an account there and distribute access?
Regarding HTML, someone has written a nice post about this on Medium:
- https://medium.com/@indrch/introduction-to-casparcgs-html-producer-391c81a4c4f
- https://medium.com/@indrch/creating-production-ready-html-templates-for-casparcg-1af1952be5b2
We should at least link to these.
from help.
Hi @baltedewit,
I have been exploring a new structure for the wiki and it's starting to take shape. Plain file structure with a clear naming convention for files without unnecessary folders which makes it easy to maintain and find appropriate files when wiki has been cloned.
However, the drawback with this solution is that it can be hard to maintain the custom sidebar. I'm thinking of the links. I have started to figure out a smart way for this but I'm not there yet.
Can @dotarmin just set up an account there and distribute access?
I have explored Gitbook before and liked it. What I didn't like was the fact it's "outside" GitHub if you understand. I have to setup a CasparCG organization on GitBook first and apply for the open source discount before I can do anything more in GitBook.
I will write a comment when it's done and more community members can help evaluate GitBook.
/Armin
from help.
I have been exploring a new structure for the wiki and it's starting to take shape
Well, put it up in a branch and let's work on it together! This is a real problem that urgently needs a solution. I'm sure that if we make an effort as a community that we can have something that works for all of us in a few weeks.
from help.
Is the gitbook live? I can't seem to find it. I'm keen to use CasparCG, but at the moment I'm struggling with the lack of documentation, especially around AMCP and OSC integrations.
from help.
Related Issues (20)
- CG ADD play-on-load problem? HOT 3
- CG crawl integrated with RSS HOT 2
- NDI +CASPARCG informations HOT 2
- CasparCG + NDI on Linux - Incorrect file extentsion HOT 3
- can not record stereo audio
- MP4 recording can't be imported in Adobe Premiere (recorded with v2.2 or v2.3)
- smooth text movement on casparcg html template
- Link is 404 for sample configs in guide page “ Guide: Example Server Configuration” HOT 3
- Wrong OpenGL version in help text HOT 3
- Caspar 2.3.0 and Intensity Pro 4k HOT 1
- Build on Debian 9
- FFmpeg producer OSC Data prefix is wrong
- 2.3 LTS - Unhandled Exception Shortly After FFMPEG Warnings HOT 5
- HTML Templates not working HOT 5
- File extension behaviour between releases
- Delete
- Casparcg 2.2.0 video contactor same as 2.09
- POSTING TO THE FORUM
- AMCP 2.3 lts INFO SERVER issue
- Woff2 font dosent work in casparcg
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
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.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from help.