January 2015 - Inkscape Docs - Inkscape Mailman

official tutorials titles, Tutorials page links
by Brynn 04 Feb '15

04 Feb '15

Hi again, I'm sorry that I don't understand exactly how this works. But I don't seem to have the ability to edit those official tutorials. I noticed that some of their titles aren't quite right. As below: Basic tutorial -- ok Advanced tutorial -- ok Shapes tutorial -- ok Bitmap tracing tutorial -- "Inkscape tutorial: Tracing" should be "Inkscape tutorial: Tracing Bitmaps" Calligraphy tutorial -- ok Elements of Design tutorial -- "Inkscape tutorial: Elements" should be "Inkscape tutorial: Elements of Design" Tips and Tricks tutorial -- "Inkscape tutorial: " should be "Inkscape tutorial: Tips and Tricks" Interpolate tutorial -- ok Also, it looks like the links on the Tutorials page aren't made with the plug-in. I'll be glad to get those ready today, if you like. Thanks, brynn

3 6

ready to translate
by Brynn 31 Jan '15

31 Jan '15

Hi Maren and Martin, Unless you find any errors (and please feel free to check), the new Learn, Community, and FAQ pages are up on live, linked with the plug-in, and ready to translate. Also, on the faq, the span is removed from the h4s. Martin said to leave alone the span where they were in a list item (unless I misunderstood). So there are still some span ids in the list items. The only outstanding issue is that there is no link to the manual for the new Measurement tool (item B.8.), because it hasn't been written yet (at least not as of last night). Another minor issue is on Community page under IRC, this link: irc://irc.freenode.org/#inkscape. I'm not very familiar with that kind of link, so I didn't have any clues how to fix it, when the plug-in reported there is an error with it ("not valid", I think it said). So I just left that as is. I don't know if the problem is the plug-in or the link. But it seems to work as is, so that's why I left it with <a href>. Beyond those issues, you may particularly want to have a look at the Contribute section (D.) since it changed drastically, after putting its content on Contribute page, and the new Promote page. If I could use rich text, I'd put in a happy dance smiley or 2! Thanks, brynn PS - Martin recently mentioned about announcing changes to the website in the mailing list, but I'm not clear exactly what kind of changes. Do you want me to post a message for this? It seems like there have been a lot of fairly significant changes lately, so maybe there should be a summary, or something..... But again, I wasn't completely clear what he meant -- maybe meant code changes? TA :-)

2 3

time to finish my new pages now!
by Brynn 31 Jan '15

31 Jan '15

Ok, now that 0.91 is ready, I'll be transferring the content from my new Community, Learn, and FAQ pages to the live site, and start fixing the links. I won't publish until I have all the links fixed. But, before I get too far into the faq, I just want to make sure you don't want me to fix the id links. Thanks, brynn

3 16

Table of Contents
by Martin Owens 29 Jan '15

29 Jan '15

Dear all, In trunk I've just committed a new website plugin, djangocms-toc. It's quite new and will need fixing as it's tested but this is what it does so far: 1. If placed into a text plugin, it will generate a table of contents for that plugin. 2. If placed outside, it'll pick the first plugin/placeholder. 3. The toc is generated using the html header tags in order 4. If the header tag itself has an id, then a local link <a href="#id"> is created. 5. Otherwise no link is created. a. You can pick a title (h2) for the table of contents. b. You can choose if you want bullets or numbers c. The whole toc is within a <div id='toc'> tag for easier styling later on. Thoughts? Best Regards, Martin Owens

2 2

bug? or annoyance?
by Brynn 28 Jan '15

28 Jan '15

Hi Maren and Martin, I'm not sure if I've found a bug, or if this is just another annoying thing about using the link plugin. Since Maren said I should not copy over the source from the staging page (so I don't have to make new links), I tried to use the non-source part of the editor. In a few places there are 2 links to the same page. But if I use the same the text link, and simply change the text by typing, then after the page is saved and published, even though the text appears to be correct in the editor, it reverts to the original text when saved/published. Steps to reproduce: 1 -- Open any page (with links made by plugin) to edit, such as Contribute. 2 -- Copy a text link, such as "Open Source" in the first sentence. 3 -- Paste it somewhere else on the page, like the end of that same paragraph. 4 -- Change the text "Open Source" to "click here". 5 -- Looks fine in the editor, but after saving and publishing, it changes back to "Open Source". I'm not sure if it happens during the save or the publish. I didn't notice until after the publish, but it probably happened during the save. The solution I found was to make a brand new link. To my understanding, it sounds like that makes a new....maybe it's like a new row or item in a database, or something like that. But anyway it sounds like it must be duplicating something. Also, different topic. What do I need to do to get the format changes going, with the indents, and different heading styles? Bug report? Thanks again, brynn

2 1

new Contribute and Develop pages ready
by Brynn 26 Jan '15

26 Jan '15

Hi Everyone, These pages have basically the same content as before, but just rearranged, so that the page structure mirrors the sub-menu structure (or vice versa). Of course, since I started them on staging, AND started before we discussed always using the django plugin for making links, I'll have to fix all the links once I transfer the content (from staging to live). (partly off topic, but using the link plugins will put a kink in the process of using the staging site to make drafts of pages, like I have, for the several pages I've worked on) Anyway, if you'd like to review that I got everything right, and didn't forget anything..... Here is new Contribute: http://staging.inkscape.org/en/brynns-contribute/?edit_off, and Here is new Develop: http://staging.inkscape.org/en/brynnsdev/?edit_off. Here's my plan: -- transfer the content, from staging to live pages -- fix all the links -- publish -- move Bug Management sub-menu item to the bottom If we ever get guides for writing documentation and/or extensions, those would go below Bug Mgmt, at least for the time being. I do realize that larger changes may be on the way, if Matthew's structure is adopted. But at least for now, this will be a little improvement. (Also partly off topic -- if Matthew's structure is adopted, which removes 1 whole main menu item and sub-menu, maybe the Gallery could go into the main menu? Maybe it's just me, but I think the Gallery needs top billing :-) ) Ok then. Please let me know if any changes are needed to these pages, and when I can go ahead with the transfer. All best, brynn

2 3

jabber? also communities on Chat Now page
by Brynn 25 Jan '15

25 Jan '15

Hi again, The other day, I think it was Martin who said to get rid of info or references to Jabber, or something like that. I just came across a couple of instances, but now I don't remember what the instructions were. And I can't seem to find the message about it. One is on the new Community page, which I'll fix over on staging. In both places, it's just the words "and Jabber", that I guess should be deleted? The other is the current Chat Now page, under Inkscape Development Online Discussion > IRC > end of 2nd sentence. Also, I think I mentioned this a while ago. Under the chat applet is International and Local Communities section, which links to the wiki page. I have transferred all that info from the wiki page (and updated) to the Learn page. Once 0.91 is released, it will be on the Communities page. Any objections to me deleting the International and Local Communities section? And regarding Jabber, I guess I'll delete "and Jabber", in the next section below? Thanks, brynn

3 2

Inkscape Website
by Martin Owens 24 Jan '15

24 Jan '15

Hi Docs List, The website team is going to be joining this mailing list to keep track of website work. It's mostly talking about content issues as the technical stuff goes to bug reports. The idea of joining everything here means we can make the docs really consistent between the generated docs, the website and/or other educational content. Please welcome Maren Hachman (web-development/qa), Brynn (content/editing), Mathew Wong (content design) and Hinerangi Courtenay (visual design/branding) I'm Martin Owens, web developer and central node. :-) Please post a reply if you're interested in joining the website work and/or getting the docs for 0.91 on the website. Best Regards, Martin Owens

1 0

Re: [Inkscape-docs] re Documentation section of Develop page
by Hinerangi Courtenay 24 Jan '15

24 Jan '15

Hello Brynn, Mathew made contact with the others not long after myself – he is also a designer, so we'll be working together to redesign the website. Mathew has made a start on wireframes and a revised site map (linked to by Maren), and I have started on the general design direction (https://inkscape.org/en/gallery/5498/). If it interests you I started a Trello board for the redesign, so we all know where we're at – and any of us can add/assign/label tasks to the backlog or vote for them (the backlog is just a brain dump where we can create tickets for anything that comes to mind, but only things agreed upon should be moved to the todo column). If preferred we can make the group public so it can be visible to all, but editable only by those invited. Let me know if you would like to be added. Cheers,Hinerangi P.S. I have also just joined the docs list. On Saturday, 24 January 2015 8:51 PM, "brynn@...67..." <brynn@...67...> wrote: Sorry if this is a duplicate. I tried to send this to inks docs list, but didn't receive. -------------------------------------------------- From: <brynn@...67...> Sent: Saturday, January 24, 2015 12:05 PM To: "Maren Hachmann" <maren@...68...>; "Martin Owens" <doctormo@...2...> Cc: "Mathew Wong" <matwong86@...2...>; "Hinerangi Courtenay" <nospamunicornus-mailinglist@...5...> Subject: Re: re Documentation section of Develop page > I'm joined too. Should I repost? > > Actually I didn't even know we had a 4th volunteer. What kind of work, > generally, will he generally be doing? > > brynn > > -------------------------------------------------- > From: "Maren Hachmann" <maren@...68...> > Sent: Saturday, January 24, 2015 8:24 AM > To: "Martin Owens" <doctormo@...2...> > Cc: <brynn@...67...>; "Mathew Wong" <matwong86@...2...>; > "Hinerangi Courtenay" <nospamunicornus-mailinglist@...5...> > Subject: Re: re Documentation section of Develop page > >> >> -----BEGIN PGP SIGNED MESSAGE----- >> Hash: SHA256 >> >> Okay, I joined. You can reach me via that list now, too. >> >> Regards, >> Maren >> >> Am 24.01.2015 um 16:15 schrieb Martin Owens: >>> On Sat, 2015-01-24 at 15:18 +0100, Maren Hachmann wrote: >>>> >>>> @Martin: it seems we now have three sets of people working on >>>> rearranging the pages on the site independently. Do you have any news >>>> about our own mailing list? It would be better if they talked to one >>>> another and coordinated their efforts ;) (and I think it would be good >>>> to have our own, in case docs will one day be resuscitated ;) ) >>> >>> While we wait for OSUOSL to come back, we should get everyone to join >>> ubuntu-docs mailing list: >>> >>> https://lists.sourceforge.net/lists/listinfo/inkscape-docs >>> >>> Brynn, Mathew especially but everyone overall, we should make sure >>> content changes are also made aware to the inkscape-developers mailing >>> list. If there's a lot of changes then a weekly report would be ideal. >>> >>> Best Regards, Martin Owens >>> >>> >> >> -----BEGIN PGP SIGNATURE----- >> Version: GnuPG v1 >> >> iF4EAREIAAYFAlTDuSQACgkQKoYx0uUjpE0XOgD/cobNjIXmUxEmuf7vCP1dlgr3 >> w1Wei3ELSw1an+hqHmoA/jOE+M/jP2/1ahnJekDPyNsHfK6qLGbP8t7Zdu/YsAFe >> =AfMH >> -----END PGP SIGNATURE----- >>

1 0