Last September I've created a package called UmbImport which is capable of importing content  from various datasources into Umbraco. For a demo of this package please checkout the video below.

UmbImport from Richard Soeteman on Vimeo.

The package was based on Beta1 of Umbraco 4 and threw errors when installing on Umbraco 4 RC.  I've fixed these bugs and created a new package. Currently I'm also working on a new version that is capable of importing members and I will add support for plugging in your own datasource, so you can import data from any datasource you like.

Download umbImport here

Nadat de eerste CTPvan Sandcastle uitkwam was op vele weblogs te lezen dat het documenteren middels Sandcastle niet gemakkelijk was. Enkele dagen na de release waren er tools ontwikkeld om het gebruik van Sandcastle te vereenvoudigen.

Een tool die ik zelf erg prettig vind is Sandcastle Help File Builder. De tool heeft een gebruikersinterface die afgeleid is van nDoc, sterker nog je nDoc project files kan je binnen deze tool ook gebruiken. Ook is het mogelijk deze tool deel uit te laten maken van je build proces, zodat je documentatie tijdens de build automatisch gegenereerd wordt. 

Download Sandcastle Help File Builder

Op diverse weblogs is al enige tijd te lezen dat Microsoft komt met een documentatie tool, namelijk  Sandcastle. De CTP hiervan is vanaf nu te downloaden.

Sandcastle Overview:

• Produces quality, comprehensive, familiar MSDN-like documentation.
• Works with or without authored comments.
• Supports Generics and .NET Framework 2.0
• Sandcastle has 2 main components (MrefBuilder and Build Assembler)
• MrefBuilder generates reflection xml file for Build Assembler
• Build Assembler includes syntax generation, transformation..etc
• Sandcastle is used internally to build .Net Framework documentation

Sandcastle is zeer welkom, zeker nu de maker van NDoc heeft aangekondigt zijn contributie aan NDOC te stoppen.

Op de weblog van Sandcastle is tevens  een artikel geplaatst waarin wordt uitgelegd hoe je een chm file maakt met gebruik van Sandcastle.

Download Sandcastle
Lees hier de uitleg

Update 30-7-2006 19:43

Lees tevens de FAQ die zojuist geplaatst is.

Afgelopen week moest ik een class genereren op basis van een redelijk complex XML Schema. Hiervoor wilde ik niet XSD.exe gebruiken. XSD.exe kent een aantal beperkingen. Het stoort me bijvoorbeeld dat ik in mijn implementatie gebruik moet maken van arrays, terwijl ik gebruik wil maken van collecties. De bekende vervanger XSDObjectGen hernoemt enumerations iets wat ik ook niet wil.

Uiteindelijk heb ik gekozen voor CodeXS. De output van CodeXS is schoon. Hij neem de output van xsd.exe als de basis. De uiteindelijke code wordt gegenereerd d.m.v. CodeDom. Wanneer een schema gebruik maakt van included schema’s kan je de locatie opgeven zodat deze ook worden meegenomen. Verder kan je de tool zelf uitbreiden d.m.v. het implementeren van de ICodeModifier  interface en het opgeven van je assembly locatie. Dit vereist wel overigens wel kennis van CodeDom. Een serializer wordt standaard mee gegenereerd.

Een tweetal issues dat ik tegenkwam:

• Let wel op dat je de parameters goed specificeert want daarin is CodeXS wel wat foutgevoelig en de foutmeldingen worden standaard niet getoond.
• Zorg ervoor dat de bin folder van ConsoleApp onderstaande bestanden bevat:
  - cxsc.Net.exe
  - CodeXS.Application.CommandLine.Net.dll
  - CodeXS.Schema.Net.dll
  - CodeXS.Schema.StandardCodeModifier.Net.dll
  - Refly.Net.dll

Sinds gisteren gebruik ik Snippet Compiler in VS2003 en baal ervan dat ik dit niet eerder heb  gebruikt.  Je kan heel snel een stukje code in een Console App of  Winform  testen zonder direct een heel project in Visual Studio aan te maken. Verder kan je binnen de tool kiezen voor een C#,J# of VB.Net template. De tool beschikt ook over intellisense voor deze talen en nog een prettige editor om in te werken ook. 

Download Snippet Compiler