topbanner_forum
  *

avatar image

Welcome, Guest. Please login or register.
Did you miss your activation email?

Login with username, password and session length
  • Thursday March 28, 2024, 6:39 pm
  • Proudly celebrating 15+ years online.
  • Donate now to become a lifetime supporting member of the site and get a non-expiring license key for all of our programs.
  • donate

Last post Author Topic: idea: FARR plugin school / tutorial / wiki  (Read 21655 times)

Nod5

  • Supporting Member
  • Joined in 2006
  • **
  • Posts: 1,169
    • View Profile
    • Donate to Member
idea: FARR plugin school / tutorial / wiki
« on: May 22, 2009, 05:21 AM »
Both FARR and the Fscript javascript plugin system has come a long way. Many new commands and options have been added. It may be hard to get an overview of it all.

Wouldn't it be a good idea to run some sort of "FARR plugin school" or a tutorial that catches up and gives a systematic overview of the new features? Or maybe a wiki where such a tutorial can grow? I'm myself not very good at plugin making but I get the feeling that I could probably do some more and better stuff if I just had a better grasp of all the new cool features and how the various parts fit together so to speak.

Nod5

  • Supporting Member
  • Joined in 2006
  • **
  • Posts: 1,169
    • View Profile
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #1 on: May 23, 2009, 06:18 AM »
Lanux128 pointed out that FSubScript is an improved version of the Fscript javascript plugin system for FARR. So it makes sense to focus on that.  :Thmbsup: But FSubScript adds another layer of complexity which makes the idea in this thread even more relevant.

I suggest these steps:

1. overview the forum sticky-ing concerning these program
- make some new sticky threads
- add/update some info to a few first posts in some sticky threads
2. start thinking of a some simple plugin that could be made into a good example to learn from.
3. make a thread/wiki/something that describe the construction of that simple plugin in a very detailed and very beginner friendly ways.

-------------------------------
regarding 1:

- make these two sticky, update the first post of each with links to the latest official FSubScript:

New FARR plugin : FSubScript enable loading of multiple javascript plugins
https://www.donation...ex.php?topic=15686.0

FSubScript Feature Requests
https://www.donation...ex.php?topic=16015.0

- update the first post of these already sticky threads with links the latest official FSubScript

FARR v2 PLUGIN CREATOR (SDK/API) INFO THREAD
https://www.donation...ex.php?topic=10105.0

FScript Javascript SDK - Write FARR plugins in javascript and more.
https://www.donation...ex.php?topic=12232.0

--------------------------
regarding 2:
I've some time thought about rewriting the experimental AlbumDisplayer plugin . With the new appcap command in FARR and the command-line support in Everything I think things are looking better than ever for that. But I also think that might not be a very good starting script since it would also involve and require Everything and a lot of HTML outputting. Can someone else give some other suggestions instead?  :tellme: One alternative would be to take some already existing plugin and rewrite/update it and make a tutorial for it.
« Last Edit: May 23, 2009, 06:26 AM by Nod5 »

czb

  • Honorary Member
  • Joined in 2007
  • **
  • Posts: 336
    • View Profile
    • My open-source online piano game
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #2 on: May 23, 2009, 06:40 AM »
Hi,
a few months ago I began writing some docs but I have not time to continue in that as I am quite busy at school right now. So for a function list and description of some of them can be found here:
http://czb.dcmembers.com/help/FARR
If anybody is interested in writing the docs I can provide login.
My open-source online piano game: https://github.com/musicope/game

Nod5

  • Supporting Member
  • Joined in 2006
  • **
  • Posts: 1,169
    • View Profile
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #3 on: May 24, 2009, 04:29 PM »
Great - that is something to build on then! I don't have the FScript know-how to continue that writing work. But if someone else continues it then I will try to help out with questions, suggestions and discussion along the way. A link to your doc file would also be useful to add to the first post in the FSubScript thread.

Maybe I should for clarity also add that many of these issues (the idea of a plugin school, and so on) are of course very much up to Mouser to make the call on. I had this idea and threw it out there as a brainstorming thing, with all the best FARR-friendly intentions but I'm just a FARR user not a FARR decider ;D (that was of course no news to most reading this :D )
« Last Edit: May 24, 2009, 04:41 PM by Nod5 »

ecaradec

  • Honorary Member
  • Joined in 2006
  • **
  • Posts: 410
    • View Profile
    • Blog & Projects
    • Read more about this member.
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #4 on: June 06, 2009, 04:08 AM »
I would be great to have a school that would really help to create more plugins IHMO. May be it does not have to be limited to FScript and FSubScript and it could support the developpement of C plugins too.
I'll second the idea of a wiki. This would make it easier to update a collaborative documentation.

There is also a FScript documentation available at : http://e.craft.free....rr/FScript/help.html
Is also updated the FScript thread to explain clearly what FScript is and to point users to CZB fsubscript version if they want to build javascript plugins.
Blog & Projects : Blog | Qatapult | SwiffOut | FScript
« Last Edit: June 06, 2009, 04:14 AM by ecaradec »

Nod5

  • Supporting Member
  • Joined in 2006
  • **
  • Posts: 1,169
    • View Profile
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #5 on: June 11, 2009, 01:08 PM »
ecadarec: right, but I think it would make sense to make such a school as basic as possible at first. So FSubScript is a good place to start. I don't have much spare time at the moment but hopefully later this summer.

ecaradec

  • Honorary Member
  • Joined in 2006
  • **
  • Posts: 410
    • View Profile
    • Blog & Projects
    • Read more about this member.
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #6 on: July 08, 2009, 02:25 AM »
Could it be possible to get a farrplugindev.dcmembers or farrplugin.dcmembers space to put a wiki on it as a place for plugins dev to group information about tools, language and farr api ?
Blog & Projects : Blog | Qatapult | SwiffOut | FScript

mouser

  • First Author
  • Administrator
  • Joined in 2005
  • *****
  • Posts: 40,896
    • View Profile
    • Mouser's Software Zone on DonationCoder.com
    • Read more about this member.
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #7 on: July 08, 2009, 10:29 AM »
absolutely.
i'll ask gothic to install DokuWiki, which i really like.

maybe a shorter subdomain name would be easier..  farrcoders.dcmembers.com or fcoders.dcmembers.com? farrapi.dcmembers.com?

hamradio

  • Charter Honorary Member
  • Joined in 2006
  • ***
  • Posts: 826
  • Amateur Radio Guy
    • View Profile
    • HamRadioUSA.net
    • Read more about this member.
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #8 on: July 08, 2009, 03:20 PM »
My opinion = farrapi.dcmembers.com might be great. :Thmbsup:

jgpaiva

  • Global Moderator
  • Joined in 2006
  • *****
  • Posts: 4,727
    • View Profile
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #9 on: August 26, 2009, 06:37 PM »
Can't it be api.farr.dcmembers.com? (although that'd cause the creation of farr.dcmembers.com, which doesn't make much sense).
The appended farr* sounds really weird (even more than 'farr' itself :P).

not a very nice comment
fcoders.dcmembers sounds like f******coders.dcmembers :)


ecaradec

  • Honorary Member
  • Joined in 2006
  • **
  • Posts: 410
    • View Profile
    • Blog & Projects
    • Read more about this member.
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #10 on: August 30, 2009, 04:23 AM »
Actually I'll be happy with any name... It is possible to create it ?
Blog & Projects : Blog | Qatapult | SwiffOut | FScript

Perry Mowbray

  • N.A.N.Y. Organizer
  • Charter Member
  • Joined in 2005
  • ***
  • Posts: 1,817
    • View Profile
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #11 on: September 08, 2009, 09:49 AM »
Actually I'll be happy with any name... It is possible to create it ?

Me too  :D

TucknDar

  • Charter Member
  • Joined in 2005
  • ***
  • Posts: 1,133
    • View Profile
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #12 on: September 08, 2009, 10:10 AM »
farrdev.dcmembers.com - easy to pronounce and allows for all kind of FARR development, i.e. not just limited to plugins, but possible alias wiki entries as well.

mouser

  • First Author
  • Administrator
  • Joined in 2005
  • *****
  • Posts: 40,896
    • View Profile
    • Mouser's Software Zone on DonationCoder.com
    • Read more about this member.
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #13 on: September 08, 2009, 04:58 PM »
i just went with http://farr.dcisv.com
because it was the shortest url.

TucknDar

  • Charter Member
  • Joined in 2005
  • ***
  • Posts: 1,133
    • View Profile
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #14 on: September 18, 2009, 09:56 AM »
Maybe a stupid Q, but is the wiki intended to be limited to plugins or for aliases as well? I'd surely vote for it to cover aliases, since it's highly unlikely that I will ever be able to do more FARR programming than a couple of alias packs.

Perry Mowbray

  • N.A.N.Y. Organizer
  • Charter Member
  • Joined in 2005
  • ***
  • Posts: 1,817
    • View Profile
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #15 on: September 18, 2009, 10:20 AM »
I wouldn't stop there either... why not include skins as well?

TucknDar

  • Charter Member
  • Joined in 2005
  • ***
  • Posts: 1,133
    • View Profile
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #16 on: September 18, 2009, 10:29 AM »
Yes, everything related to FARR, really  :Thmbsup:

mouser

  • First Author
  • Administrator
  • Joined in 2005
  • *****
  • Posts: 40,896
    • View Profile
    • Mouser's Software Zone on DonationCoder.com
    • Read more about this member.
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #17 on: September 24, 2009, 01:05 AM »
please sign up at the wiki if you want to help edit it
sample page:
http://farr.dcisv.co...u.php?id=farrplugins

mouser

  • First Author
  • Administrator
  • Joined in 2005
  • *****
  • Posts: 40,896
    • View Profile
    • Mouser's Software Zone on DonationCoder.com
    • Read more about this member.
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #18 on: September 30, 2009, 09:14 PM »
where are all you wiki lovers!!!
come help us fill in the farr plugins/aliases table please -- especially those of you who have written alias packs and plugins!

Nod5

  • Supporting Member
  • Joined in 2006
  • **
  • Posts: 1,169
    • View Profile
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #19 on: October 01, 2009, 03:29 AM »
I'll sign up and add some stuff next week - sorry, no time at all ATM  :-[ Great that the wiki is up and ready to set in motion.

phitsc

  • Honorary Member
  • Joined in 2008
  • **
  • Posts: 1,198
    • View Profile
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #20 on: October 01, 2009, 08:10 AM »
Sorry for the stupid question: is signing up supposed to be enough for actually being able to edit pages in the wiki?

Perry Mowbray

  • N.A.N.Y. Organizer
  • Charter Member
  • Joined in 2005
  • ***
  • Posts: 1,817
    • View Profile
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #21 on: October 01, 2009, 09:31 AM »
Sorry for the stupid question: is signing up supposed to be enough for actually being able to edit pages in the wiki?

That worked for me ( after digging through my spam to find the email from the wiki with my password)

mouser

  • First Author
  • Administrator
  • Joined in 2005
  • *****
  • Posts: 40,896
    • View Profile
    • Mouser's Software Zone on DonationCoder.com
    • Read more about this member.
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #22 on: October 01, 2009, 09:32 AM »
no -- i need to promote you to the Editor group before you can edit pages.  phitsc you have been promoted.

phitsc

  • Honorary Member
  • Joined in 2008
  • **
  • Posts: 1,198
    • View Profile
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #23 on: October 01, 2009, 09:34 AM »
phitsc you have been promoted.

Hey, I think that's the first time I hear this in my entire career! ;)

Perry Mowbray

  • N.A.N.Y. Organizer
  • Charter Member
  • Joined in 2005
  • ***
  • Posts: 1,817
    • View Profile
    • Donate to Member
Re: idea: FARR plugin school / tutorial / wiki
« Reply #24 on: October 01, 2009, 09:39 AM »
no -- i need to promote you to the Editor group before you can edit pages.

Ah: Did that happen without me realizing?