#1✎ 960Y_ackHead AdminUmm... hi!
So one idea that a few people have kind of whispered about for a while is community-written documentation and tutorials, to the point of being an intended feature for a possible website rewrite, because the official reference isn't that great, both in organization and accuracy, and even most of the advanced users here don't really know how SmileBASIC works.
Recently 12Me21 and I went and took another stab at it and laid out the groundwork.
The goals of such a project are:
- Provide accurate documentation of SmileBASIC instructions
- Document anomalies and hidden/undocumented functionality
- Accommodate future releases and updates
The project in its current form can be accessed at https://github.com/y-ack/puchikon-no-hata
If you have any experience with SmileBASIC to the point where you have, say, run into bugs before, or if you've ever thought "I would actually describe this command this way..." please help out!
The guide for contributing is here: CONTRIBUTINGResources:
If you're not sure where to start, snail_ has released sbdoc-cc to the public domain, so it is completely open for integration.
Also, the chat logs can be searched http://scratch.smilebasicsource.com/chatlogs/search?search=GCLS (takes regex; be careful) for strange discoveries (but be careful to avoid plagiarism)
Japanese fan reference: http://petitcom.net/
Additionally, here is the initial intended categorization of instructions (may be outdated)
To be clear, due to problems we have encountered with github, this project is eventually intended to find a different host (cough cough) and use a custom markup (that we are developing), but porting pages is relatively easy, so it is much more important that as much as possible can be written so that people may actually use it as a resource.things that aren't important because they're handled by spooky new system magic
- navigation links
- page titles
- tables of contents
things that matter a lot:
- getting the true syntax correct
- meaningful descriptions
- references for anything particularly interesting
If you have any questions, please don't hesitate to ask!
Posted
Edited
by Y_ack
#2✎ 317spaceturtlesVideo GamesI like to play video games!HobbiesAvatar BlockI didn't change my avatar for 30 days.WebsiteIntermediate ProgrammerI can make programs, but I still have trouble here and there. Programming StrengthIf I was to write a tutorial on all that I knew about strings, would that count?
Posted
If I was to write a tutorial on all that I knew about strings, would that count?
Yeah!
I suggest making it the top-level page for a category (for now that looks like this, note filename and path) e.g. https://github.com/y-ack/puchikon-no-hata/blob/master/String/README.org
The template for category pages is here template-category.org
The only difference between a tutorial inside the instruction list and outside of it is that you have to avoid personal language.
Posted
#4✎ 202TheV360Pokemon Is Awesome!I love Pokemon!Express YourselfFirst DayJoined on the very first day of SmileBASIC SourceWebsiteNight PersonI like the quiet night and sleep late.Express YourselfWilling to help with sprite info, I was writing a sprite tutorial a long time ago, and the recent Love2DSmileBASIC library uncovered a few more edge cases.
Posted
#5✎ 960Y_ackHead AdminAlso if anyone has trouble with forking just PM me and I'll add you as a contributor or whatever
Posted
#6✎ 76kitesinpowerlinesAvatar BlockI didn't change my avatar for 30 days.WebsiteAvatar EmbargoI didn't change my avatar for 90 daysWebsiteAvatar TabooI didn't change my avatar for 180 daysWebsiteIf anyone wants tips etc on writing instructional/informational content, I am a technical writer. I literally write manuals for a living (though not for software)
Posted
#7✎ 922snail_HelperReceived for being very helpful around SmileBASIC SourceAchievementsOSP Contest 2 Contest ParticipantI participated in the second SmileBASIC Source OSP Contest!Night PersonI like the quiet night and sleep late.Express YourselfWhen I get home (if I'm not too busy playing smash or sleeping) I'll probably start migrating some of my repo's content. To be clear: for the time being, we use org-mode markup for the docs for the time being and transition to a new system at a later date? At that rate we could use the existing Emacs smilebasic-mode for highlighting and write a custom orgexport backend to convert it.
Beyond individual function pages I think it would be beyond useful to write Guides to encompass larger cohesive topics like random generation and sprite control. This would wind up being the lion's share of my output.
Posted
#8✎ 960Y_ackHead AdminContributions are a little slower than I hoped so we are now offering your choice of one of these excellent incentive plans:
- for every 2 good quality pages you contribute Y will smile and pat you on the head
- if you do at least half as much work as 12 you can have a badge
- for every page you write you get another month to live
we use org-mode markup for the docs for the time being and transition to a new system at a later date? At that rate we could use the existing Emacs smilebasic-mode for highlighting and write a custom orgexport backend to convert it.
Yes. The information is more important and more difficult to produce than the formatting. org backends won't quite work because most of the important features are things that are completely impossible in org (e.g. nested tables and generating the navigation) so I don't think it's worth worrying about.
As far as highlighting though, writing especially guides with orgmode and the smilebasic-mode is a good idea. Nothing needs to be done with smilebasic-mode for that, right? It doesn't need the Babel hooks or anything?
Beyond individual function pages I think it would be beyond useful to write Guides to encompass larger cohesive topics like random generation and sprite control.
RIght; besides instruction documentation we want guides like this. As far as systems: beyond the notes/ category for general "other" descriptions of SmileBASIC functionality, we have the concept of "category pages" for which e.g. Sprites/index (for now Sprites/README.org) would cover sprites in general and have a table of contents for sprite instructions in particular.
The template for this is https://github.com/y-ack/puchikon-no-hata/blob/master/template-category.org
Posted
Edited
by Y_ack
#9✎ 922snail_HelperReceived for being very helpful around SmileBASIC SourceAchievementsOSP Contest 2 Contest ParticipantI participated in the second SmileBASIC Source OSP Contest!Night PersonI like the quiet night and sleep late.Express YourselfUhh for highlighting to work in org export you need a couple packages installed; I think htmlize and html-fontify (maybe just fontify) are their names. Beyond that it should just work assuming you have smilebasic-mode correctly registered and you mark it up properly. This only works for html export.
Keep in mind that the faces used are the faces of your Emacs theme, so i guess you'll wind up taking the commits and feeding them to some kind of emacs hook to make sure they all look the same.
Posted
#10✎ 960Y_ackHead AdminOh, I was hoping you were talking about getting highlighting while editing.
If you're going to even think about exporting to the custom markdown you just want to make a source block with smilebasic set and then we highlight that perfectly
Posted
#11✎ 922snail_HelperReceived for being very helpful around SmileBASIC SourceAchievementsOSP Contest 2 Contest ParticipantI participated in the second SmileBASIC Source OSP Contest!Night PersonI like the quiet night and sleep late.Express YourselfTo get highlighting in org src blocks themselves you can (setq org-src-fontify-natively t) in your config. This doesn't enable autoformatting like indentation though.
Posted
#12✎ 593IAmRalseiForum LeaderHiddenAchievementsFirst YearMy account is over 1 year oldWebsiteExpert ProgrammerProgramming no longer gives me any trouble. Come to me for help, if you like!Programming Strength
- for every 2 good quality pages you contribute Y will smile and pat you on the head
- if you do at least half as much work as 12 you can have a badge
- for every page you write you get another month to live
ARE YOU REALLY HANDING OUT BADGES?
Ahem. I would have helped anyway but..BADGES? (I was planning on waiting until it wasn't on GitHub anymore tho)
Posted
Edited
by IAmRalsei
#13✎ 91SimeonScholarReceived for knowing a great deal about programming topicsAchievementsAmazing PageHiddenAchievementsDrawingI like to draw!HobbiesThis looks really great so far, I hope I can contribute some, once I figure out how to...
Posted
This looks really great so far, I hope I can contribute some, once I figure out how to...
What's confusing you? I tried to provide as much information as I could but inevitably it's probably still confusing.
Posted
#15✎ 91SimeonScholarReceived for knowing a great deal about programming topicsAchievementsAmazing PageHiddenAchievementsDrawingI like to draw!Hobbies
This looks really great so far, I hope I can contribute some, once I figure out how to...
What's confusing you? I tried to provide as much information as I could but inevitably it's probably still confusing.
I think I'm figuring it out
Posted
Edited
by Simeon
#16✎ 960Y_ackHead AdminImportant Note for Contributors Using the Github Interface:(if you are using a command line git interface you probably already know how to do this)
To keep your branch up to date with origin, (this includes important changes to template files and possibly your committed files) you will need to occasionally (i.e., before starting work) PULL changes from origin/master to your fork.
Click any of those [Pull Request] links, and you'll be taken to a page about "Comparing changes"
You want to switch the base and compare origin/master against your own branch. It should look like this, with master on the right:
Then you can create a pull request into your own branch and merge it
And since GitHub is so awesome, it'll even leave a mess in the commit history when you submit changes to master!
If anyone knows of a better way to do this please share it w
Posted
#17✎ 202TheV360Pokemon Is Awesome!I love Pokemon!Express YourselfFirst DayJoined on the very first day of SmileBASIC SourceWebsiteNight PersonI like the quiet night and sleep late.Express YourselfExample sprite for sprite transform demonstrations should be...
vote now!!
Posted
#18✎ 166012Me21Head AdminThird YearMy account is over 3 years oldWebsiteSyntax HighlighterReceived for creating the code syntax highlighter on SBSNight PersonI like the quiet night and sleep late.Express YourselfWhat about the SB logo? (1474 or 4095)
Posted
Edited
by 12Me21
strawberry is the most obvious choice BUT
there are a few problems
the other sprites have really big ID numbers which stand out more
SPSET 0,0 vs SPSET 0,532
though I suppose we could use any of the other strawberry definitions
anyway also the strawberry is pretty small...
and it's symmetrical which might be bad for showing mirroring and scaling
Posted
#20✎ 202TheV360Pokemon Is Awesome!I love Pokemon!Express YourselfFirst DayJoined on the very first day of SmileBASIC SourceWebsiteNight PersonI like the quiet night and sleep late.Express Yourself
What about the SB logo? (1474 or 4095)
Considered that, don't like it because it's giant and also bad. Although, it would be good for attribute demonstration?
Also, I GOD DANG FORGOT WANG-PAKU AND DUMMY. They would've been good inclusions, as Wang-PAKU is an energetic naughty boy and Dummy would be a good dummy (sometimes used as a synonym for placeholder) sprite.
Posted