Details on using Atomo, the Sueetie Developer's Package. Atomo contains all Sueetie Framework source code so you can customize your community and add new services. If you need information on getting started with Atomo, see
Getting Started With Atomo. Atomo is available for download and is free to all Sueetie Community Members in
the Sueetie Marketplace.Introducing Atomo, The Sueetie Developer Package
Item #3 in the
Sueetie Manifesto is that no Community Framework meets everyone's needs, even one as full-featured as Sueetie. With full framework source code and essential application source libraries, Atomo gives you the ability to create custom features of all existing applications or create all new ones.
The Atomo Solution
The Atomo Visual Studio Solution is shown below. It includes the Sueetie Framework core source code base, each application's WebApplication project (or Website project in the case of BlogEngine.NET), and each application's core class libraries. Remaining application libraries are compiled and referenced from /source/lib/APPLICATION.
Color Coded Atomo
The following screenshots provide a description of the Atomo Solution contents. (The current release of Atomo is structured the same as the Atomo 2.0 screenshots below.)
Web application/website projects of the Sueetie and its applications.
The supporting application Core project libraries to facilitate development and debugging.
Saltie is the complimentary project new in Sueetie v2.0 designed especially to support customization.
Read more about Saltie here.
And of course, the Sueetie Framework class libraries.
Sueetie Application Web Locations
If you look at the Root WebApplication in Atomo, you'll notice that the physical locations of each of the application web apps is in folders under the root.
A Single Development Solution
To understand and appreciate the economy of the Atomo Solution, let's look at a typical Sueetie Solution used in creating the framework itself. The Sueetie Communiity Framework is a collection of several Visual Studio Solutions, one Solution for each application. Here's an example using Gallery Server Pro. All GSP souce projects are included as well as Sueetie Framework class projects of Sueetie.Core, Sueetie.Controls and Sueetie.Media. Similar solutions exist for ScrewTurn Wiki, BlogEngine.NET, YetAnotherForum.NET and the Root WebApplication.
If we were to extend that structure across all applications and include all application projects, our Sueetie Solution would have over fifty class projects and be completely unworkable. We approached Atomo instead as a lightweight yet all-inclusive Solution that gives you all of the source you will need to full customize your community.
What If I Need To Change Application Source Code?
The source code of each Sueetie Application is available at their home community site. Below are descriptions and links to the specific version of the source library used in the current release of Atomo, Version 4.0.
If you wanted to modify code in, say, a Gallery Server Pro Project Library, you would obtain the Gallery Server Pro 2.4.6 source and add it to your Atomo solution. You would then add a reference to that project from GSP rather than the reference in /source/lib/APPLICATION
How To Determine Sueetie-Modified Application Source
Sueetie makes far less changes to application source libraries than you'd expect. Nearly all libraries touched by Sueetie are included with modifications. To find all instances of code changes made to the source libraries do a search for
// Sueetie Modifiedin Visual Studio. You can also, of course, obtain the source libraries from the Application home community site and perform a comparison of project libraries in a tool like WinMerge to determine any changes. See the DIFFs.txt in the Atomo Package root directory for any additional notes.
Application Source Versions and Locations for Sueetie Release Version 4.0¶
- YetAnotherForum.NET Version: 1.9.5 RTM. Available in the YetAnotherForum.NET repository on CodePlex. Filename: YAF v1.9.5 RTM (Date: 11/16/2010 Rev: 4140)
- BlogEngine.NET Version 2.0.0.36. Available on BlogEngine.NET's CodePlex Downloads Page. BlogEngine.NET 2.0 (Source)
- ScrewTurn Wiki Version 3.0.4.560. ScrewTurn Wiki Downloads page.
- Gallery Server Pro Version 2.4.6 on Roger Martin's GSP Download page.
Source Code License
All source code in Atomo is licensed by GNU GPLv2.0. (See
Sueetie Licensing for details and use guidance.) Commercial licenses to the Sueetie Framework source code and the individual applications are available. Contact
Sueetie Sales or the application contacts for details.
One more thing, what's the deal with "Atomo?"
Members of the Sueetie Community agreed with me that the Sueetie Developer Package should have a name, like Gummy Bear for our Web Package. In thinking about something sweet I thought about the candy I ate more than any other throughout the decades. The Atomic Fire Ball. It conveyed the hotness of the developer package and contrasted Gummy Bear nicely, but "Atomic Fire Ball" or just "Fire Ball" or "Atomic" didn't do it.
There's a wonderful 1999 animated movie named Iron Giant set in the late 50's. In one scene, Hogarth Hughes and the Iron Giant were reading comic books when the Iron Giant spotted a metal robot on the cover. Hogarth said, "Oh, that's Atomo, the metal menace. He's not a hero, he's a villain. But you're not like him. You're a good guy, like Superman."
It would have been nice if Atomo were one of the good guys, but he's still a fun character and ties nicely with Atomic Fire Balls on the sweet side. So there it is.