[lang_en]Today you can download yet another RapidWeaver plugin from my site. The name is @stash and like the name hints it will allow you to ”stash” text and codesnippets inside your projectfile. In some ways it is similar to the built-in feature ”Snippets” in RapidWeaver 3.6 but does so in a different way because @stash is all about keeping your stuff inside the projectfile. This plugin started growing before I even knew what was going to be in RapidWeaver 3.6. If I had I would maybe not have written it, but now I have and i’m sharing it with you since it is a nice complement to ”Snippets”.

@stash also works with RapidWeaver 3.5.1 (OSX 10.4 is required) so now those who haven’t yet upgraded to 3.6 can start using all those fantastic codesnippets that all the users have started to share.[/lang_en]
[lang_sv]I dag kan du ladda hem ännu ett plugin för RapidWeaver. Namnet är @stash och som namnet på engelska antyder så tillåter det dig att spara text och kodsnuttar inuti din projektfil. Till viss del så fungerar det som den inbyggda ”Snippets” finessen i RapidWeaver 3.6 men det gör det på ett helt annorlunda sätt för @stash är tänkt att knyta allt till din projektfil. Plugin:et började ta form långt innan jag ens visste vad RapidWeaver 3.6 skulle innehålla. Om jag hade vetat det så skulle jag kanske inte ha skapat @stash, men nu har jag gjort det och jag delar med mig det till dig eftersom det är ett bra komplement till ”Snippets”.

@stash fungerar också tillsammans med RapidWeaver 3.5.1 (OSX 10.4 krävs) så nu kan även dom som inte har uppgraderat till 3.6 ta del av alla fantastiska kodsnuttar som alla användare har börjat dela med sig.[/lang_sv]

[lang_en]But lets get back to @stash and what it does. Because it does more than just storing your items inside the projectfile. You can also reference (import) these items into any styled textarea in your project using the following tag:

@stash((item name))

The tag will be replace by the content of the referenced item when your page is rendered.

But there is more too… You can also access these items from a HUD inspector, available through the ”View” menu and a configurable keyboard shortcut, and drag the items to where you want to use them (either the tag or the actual content of the item). So there is no need for you to remember the name of the items in your head. Just open the inspector, hover the mouse over an item to see it’s comment, if the name you used isn’t a good enough hint for what the item does, and drag the item onto your current page.

Here is a list of the current features:

• Store any text and codesnippets (PHP, HTML etc.) inside your projectfile.
• Organize the items in groups and subgroups.
• Import and Export item(s) in XML format (not the same as .rwsnippets).
• Import .rwsnippets, either by importing the file or dragging the snippet from the inspector to the @stash sourcelist.
• Import selected text by dragging it to the @stash sourcelist.
• Reference your items into styled textareas with the @stash((item name)) tag. When the page is exported the item will automatically get the ’ignore formatting’ attribute applied to prevent RapidWeaver from ”destroying” the code.
• Access your @stash items from a HUD inspector on any page in your project.
• …probably forgot something but try it out and send me feedback 🙂

So what can you do with it? I put one example in a previous post. The documentation is still a bit short but I have posted a webpage about it that will show you a little bit about what it does.

The plugin is free for personal and non-commercial use, for other usage it is donationware. You can download the plugin from my @stash page and try it out.[/lang_en]
[lang_sv]Men låt oss återgå till @stash och vad det kan göra. För det kan göra mer än bara spara dina objekt inuti projektfilen. Du kan nämligen också referera (importera) dessa objekt ifrån alla stilerade textareor i ditt projekt med hjälp av följande tagg:

@stash((item name))

Taggen ersätts med innehållet av det refererade objektet när din sida renderas.

Men det är inte allt… Du kan också komma åt dessa objekt från en HUD inspector, finns tillgänglig från ”View” menyn och ett konfigurerbart kortkommando, och dra dina objekt dit du will ha dom (antingen taggen eller innehållet i objektet). Så du behöver inte komma ihåg namnet på dina objekt. Det är bara att öppna inspector fönstret, håll muspekaren över ett objekt för att se dess kommentar, om namnet du angett inte tydligt nog identifierar ditt objekt, och dra det dit du vill använda det på din sida.

Här är en lista över alla features som finns just nu:

• Spara text och kodsnuttar (PHP, HTML etc.) inuti din projektfil
• Organisera dina objekt i grupper och undergrupper.
• Importera and Exportera objekt(en) i XML format (inte samma format som .rwsnippets).
• Importera .rwsnippets, antingen genom att importera filen eller genom att dra en ”snippet” från snippets-fönstret till listan i @stash.
• Importera markerad text genom att dra den till listan i @stash.
• Referera till dina objekt från stilerade textareor med @stash((item name)) taggen. När sidan exporteras så får kommer attributet ’ignore formatting’ automatiskt att läggas till för att förhindra att RapidWeaver ”förstör” koden.
• Nå dina @stash objekt via ett HUD fönster från alla sidor i ditt projekt..
• …jag har förmodligen glömt något med testa det och skicka feedback 🙂

Så vad kan du då göra med det? Jag skrev om ett exempel i ett tidigare inlägg. Dokumentationen är fortfarande lite sparsam men jag har lagt upp en sida om det så att du kan se lite mer om vad det gör.

Plugin:et är gratis att använda för privat och icke-kommersiellt bruk, för övrig användning är det donationware. Du kan ladda hem plugin:et från min @stash sida och testa det.[/lang_sv]

Tags: @stash | Plugins | RapidWeaver | Released