Difference between revisions of "Template talk:Ansreq/Sandbox"
DesignerThan (talk | contribs) |
|||
(7 intermediate revisions by 2 users not shown) | |||
Line 31: | Line 31: | ||
::Okay, I thought there are more. Nice work. Maybe you can explain it to me how the thing with the requirements is working? I know how to use it but not how it works. Somehow I don't get it. xD | ::Okay, I thought there are more. Nice work. Maybe you can explain it to me how the thing with the requirements is working? I know how to use it but not how it works. Somehow I don't get it. xD | ||
+ | |||
+ | :::The ''reason'' for doing all this restructuring is that we've been asked to host the honor requirements pages instead of having AdventSource (the NAD's insignia supplier) create them as PDF's and try to keep them in sync with the answer keys. This will make the wiki the official repository of the honor requirements for the NAD. This makes a lot of sense because we have some overlap between the NAD's Honor Task Force (which accepts, edits, and sometimes rejects honor proposals and changes) and the admins on the Wiki. Those admins are myself, Mark (chair of the committee), and Jaceil (recording secretary). | ||
+ | |||
+ | :::This restructuring is so that we have a single copy of the requirements that both the answer keys and the requirements pages draw from. There is also a desire to make worksheets for the Pathfinders to fill out, and that too would need to draw from the single copy of the actual requirements. | ||
+ | |||
+ | :::Basically, I've got a bot I hacked together to extract each requirement from the answer keys and save it into its own page, the name of which is "Adventist Youth Honors Answer Book/''category''/''honor''/Requirement/''requirement_id''". Then we have a handful of templates (ansreq, anssubreq, reqreq, reqsubreq, etc) to display the requirements. "ansreq" is my shorthand for "answer requirement", meaning, display the requirement for the answer key". "reqreq" is "display the requirement for the Requirements page. The "Requirements" pages live at "Adventist Youth Honors Answer Book/''category''/''honor''/Requirements". And I have those for all the honors in the first five categories. But they do need dressed up. Even so, it would be instructive to look at the source for the requirements. Once we have extracted all the requirements I will run the "protect" bot to prevent edits to the requirements by the general public. Since those will become the official NAD record, we need to make sure that only the "authorities" can change them. --[[User:Jomegat|Jomegat]] ([[User talk:Jomegat|talk]]) 18:09, 9 November 2020 (EST) | ||
+ | |||
::Can you link in one of the IA pages? So I know what we are talking about. | ::Can you link in one of the IA pages? So I know what we are talking about. | ||
+ | :::IA is Investiture Achievement. There's a link to the IA section in the left pane. Go there and click anything in the matrix. --[[User:Jomegat|Jomegat]] ([[User talk:Jomegat|talk]]) 18:09, 9 November 2020 (EST) | ||
+ | |||
::I think you guys know, what the best way is for the translations, I will keep out of that discussion. But what interessets me is, what you think about the repositioning of the custom button and the color in the head. Maybe you can write some short words. --[[User:DesignerThan|DesignerThan]] ([[User talk:DesignerThan|talk]]) 02:35, 9 November 2020 (EST) | ::I think you guys know, what the best way is for the translations, I will keep out of that discussion. But what interessets me is, what you think about the repositioning of the custom button and the color in the head. Maybe you can write some short words. --[[User:DesignerThan|DesignerThan]] ([[User talk:DesignerThan|talk]]) 02:35, 9 November 2020 (EST) | ||
+ | |||
+ | ::::Okay. I think we talked about this in the mails. Now I got it, thanks, I wasn't sure if the Requirements are pages or if they are somehow saved in an other way. | ||
+ | ::::How do you think about the additional color and the placement of the "Hide/Show"-Button. Is that okay? Should I change something? | ||
+ | ::::If you want me too, I could have look at the Requirement Pages and do some fromatting and so on. If you tell me what the Requirements for those pages are. Maybe I'll have some good ideas. --[[User:DesignerThan|DesignerThan]] ([[User talk:DesignerThan|talk]]) 06:48, 10 November 2020 (EST) | ||
== How to use this template == | == How to use this template == | ||
Line 51: | Line 64: | ||
::Yeah, I was thinking about the same thing. But my conclusion was somehow the same like yours. The problem with the content argument, I think, will be that there will be some problems with MW content (tables, other templates) and I think it won't be that nice to edit with the sections. | ::Yeah, I was thinking about the same thing. But my conclusion was somehow the same like yours. The problem with the content argument, I think, will be that there will be some problems with MW content (tables, other templates) and I think it won't be that nice to edit with the sections. | ||
::I come to the same conclusion like you. The attempt with automatically closing the divs is nice I think, but I ask myself if it is not easier to do it manually every time with the template, because it is easier to communicate to the user that the requirement has to be started with ansreq and ended with closereq every time then it has only be done at the end. But I don't really know what's best... I can also find myself explaining the way it is now xD. | ::I come to the same conclusion like you. The attempt with automatically closing the divs is nice I think, but I ask myself if it is not easier to do it manually every time with the template, because it is easier to communicate to the user that the requirement has to be started with ansreq and ended with closereq every time then it has only be done at the end. But I don't really know what's best... I can also find myself explaining the way it is now xD. | ||
− | ::Definitely we should build up a Help Namespace with explanaitions of all that. "How to create a Honor?", "How to translate a Honor?", and so on ...--[[User:DesignerThan|DesignerThan]] ([[User talk:DesignerThan|talk]]) 02:35, 9 November 2020 (EST) | + | ::Definitely we should build up a Help Namespace with explanaitions of all that. "How to create a Honor?", "How to translate a Honor?", and so on ... What we also should do, I think, is to add a description and generic example of the template to it like at the [[Template:CustomToggleButton]].--[[User:DesignerThan|DesignerThan]] ([[User talk:DesignerThan|talk]]) 02:35, 9 November 2020 (EST) |
+ | |||
+ | ::I implemented an explanation and example now and did a test in the [[Adventist_Youth_Honors_Answer_Book/Nature/Amphibians/Sandbox2|Amphibian Sandbox 2]]. As I used the example I came across the not so nice thing that I wanted a line break between the answer and the next AnsReq-Box (in the code), but because the box gets closed by the next one the line break was added to the answer. That can be prevented with the <nowiki><nowiki></nowiki>-tag but I think the nicer solution would be, if every AnsReq-Box needs to be closed with a [[CloseReq]]-Template.--[[User:DesignerThan|DesignerThan]] ([[User talk:DesignerThan|talk]]) 04:28, 9 November 2020 (EST) | ||
+ | |||
+ | :::It would probably be best to open each requirement with ansreq, and close each one with closereq. Subrequirements would be opened with anssubreq. We ''should'' make a closesubreq too, even though it will be the same as closereq. I say that, because it will give us the freedom to change what ansreq and anssubreq do in the future without having to worry about ripple effects. It does feel a little dirty to start the template by closing the previous div. It felt "clever" when I did it, but there is that fine line between stupid and clever. | ||
+ | :::Note that none of this has gone live yet. Nothing uses the ansreq template or its friends except the amphibians sandbox. So It would be quite alright to make your changes there instead of in an ansreq/sandbox page. --[[User:Jomegat|Jomegat]] ([[User talk:Jomegat|talk]]) 18:09, 9 November 2020 (EST) | ||
+ | ::::Actually, we should sandbox another honor. Now that I've been through a couple hundred of them, I could probably pick one that is more complex. [[Adventist Youth Honors Answer Book/Nature/Insects - Advanced]] would be a good choice because it has sub-sub-requirements too, and it's not very long. --[[User:Jomegat|Jomegat]] ([[User talk:Jomegat|talk]]) 18:16, 9 November 2020 (EST) | ||
+ | |||
+ | Yeah I think so too. At the moment I am a bit in a hurry but the next time I have time and the Templates are not created by them I will start doing it and then working on the two Honors. | ||
+ | I created the Sandbox firstly because I didn't know if my changes will work and if they are okay for you guys and secondly because I can't change the AnsReq template and the other once because they are protected. But if you give me the permissen and tell me I should do it, I will as soon as I have time for it. --[[User:DesignerThan|DesignerThan]] ([[User talk:DesignerThan|talk]]) 06:44, 10 November 2020 (EST) | ||
+ | |||
+ | :I forgot that I had protected it. I've lifted the edit restriction now, so feel free to flail on it. It will eventually need to be protected again though since it will appear in every single honor. But until then, there's no danger in making it editable by anyone. --[[User:Jomegat|Jomegat]] ([[User talk:Jomegat|talk]]) 20:03, 10 November 2020 (EST) |
Latest revision as of 01:03, 11 November 2020
This is great! Let's adopt it into the non-sandboxed version ASAP. I've also been thinking that we should change the blue table to have two columns instead of two rows:
Requirement {{{num}}} |
{{:{{{page}}}/Requirement/{{{num}}}}} |
We should also add de and pt-br to the supported languages. Sometimes it takes me longer to come around than it should. --Jomegat (talk) 08:00, 8 November 2020 (EST)
- That's a very good idea with the two columns. Looks great.
- Okay... I'll see what I can do. Maybe I will need some kind of a plugin or so. What has to be done is written in the template maybe somebody will have an idea about my main problem.
- No problem me too :)
- Don't you think it is better to wait with the languages and add them with a bot all at once? --DesignerThan (talk) 10:54, 8 November 2020 (EST)
- I did some work at the Template. I hope you guys will like those!
- I moved the button into the table. That way the answer collapses all the way. I also moved it in a own Template, that way it will be useable in many places. It would also be possible to use it to show/hide all the answers with one push of the "button" but for that see the discussion of the template.--DesignerThan (talk) 19:48, 8 November 2020 (EST)
There's no need to have a bot add languages to the "requirement" templates. We usually do that by hand as there are only a handful of templates. Jaceil... don't worry about being super engaged right now. You have a lot on your plate In Real Life and this seems to be coming along nicely. I've extracted the requirements from all the honors except the ones in the Recreation, SG&O, and Vocational categories so far. I have been making some tweaks to the requirements here and there, like adding a requirement 6 when the honor has a 6a and 6b, but no 6 as a parent, and adding subrequirement letters here and there where they are missing. It doesn't change anything about the requirements except that it adds the metadata structure I need to make this stuff work. I'd like to add a template to all the .../Requirements pages so that it shows the name of the honor, and maybe the patch and skill level. The patch will be more difficult since we're specifying that in the honor_desc template in the answer keys. Once we have worked out a template (the coding as well as the presentation), I can put a bot together to add it to all the requirements pages.
I was looking at an IA page today, and saw some of the kludges we have in place for including requirements for honors. Now that we're on track to have each requirement on its own page, that can be cleaned up and formatted more nicely.
It came to me the other day that instead of using a Wikibot that understands the Translate extension for handling the mechanical translation of the requirements into Spanish, we could use a more generic screen-scraping robot instead. There are several out there. --Jomegat (talk) 20:24, 8 November 2020 (EST)
- Okay, I thought there are more. Nice work. Maybe you can explain it to me how the thing with the requirements is working? I know how to use it but not how it works. Somehow I don't get it. xD
- The reason for doing all this restructuring is that we've been asked to host the honor requirements pages instead of having AdventSource (the NAD's insignia supplier) create them as PDF's and try to keep them in sync with the answer keys. This will make the wiki the official repository of the honor requirements for the NAD. This makes a lot of sense because we have some overlap between the NAD's Honor Task Force (which accepts, edits, and sometimes rejects honor proposals and changes) and the admins on the Wiki. Those admins are myself, Mark (chair of the committee), and Jaceil (recording secretary).
- This restructuring is so that we have a single copy of the requirements that both the answer keys and the requirements pages draw from. There is also a desire to make worksheets for the Pathfinders to fill out, and that too would need to draw from the single copy of the actual requirements.
- Basically, I've got a bot I hacked together to extract each requirement from the answer keys and save it into its own page, the name of which is "Adventist Youth Honors Answer Book/category/honor/Requirement/requirement_id". Then we have a handful of templates (ansreq, anssubreq, reqreq, reqsubreq, etc) to display the requirements. "ansreq" is my shorthand for "answer requirement", meaning, display the requirement for the answer key". "reqreq" is "display the requirement for the Requirements page. The "Requirements" pages live at "Adventist Youth Honors Answer Book/category/honor/Requirements". And I have those for all the honors in the first five categories. But they do need dressed up. Even so, it would be instructive to look at the source for the requirements. Once we have extracted all the requirements I will run the "protect" bot to prevent edits to the requirements by the general public. Since those will become the official NAD record, we need to make sure that only the "authorities" can change them. --Jomegat (talk) 18:09, 9 November 2020 (EST)
- I think you guys know, what the best way is for the translations, I will keep out of that discussion. But what interessets me is, what you think about the repositioning of the custom button and the color in the head. Maybe you can write some short words. --DesignerThan (talk) 02:35, 9 November 2020 (EST)
- Okay. I think we talked about this in the mails. Now I got it, thanks, I wasn't sure if the Requirements are pages or if they are somehow saved in an other way.
- How do you think about the additional color and the placement of the "Hide/Show"-Button. Is that okay? Should I change something?
- If you want me too, I could have look at the Requirement Pages and do some fromatting and so on. If you tell me what the Requirements for those pages are. Maybe I'll have some good ideas. --DesignerThan (talk) 06:48, 10 November 2020 (EST)
How to use this template
I'm trying to get my head around how we would use this template, and I think I'm getting close. If we added the content as an argument, I think we'd invoke the template, specify, page, and num - but to get the answer to show up inside the box, I think we'd also need a content argument. Then it could be called like this:
{{ansreq |page={{PAGENAME}} |num=3a |content=This text supplies the answer to the requirement. It can contain MW markup such as tables, and bold, but maybe not headings? (We have a lot of answers with subheadings in them). But maybe it could? }}
But...
One of the things we need to keep in mind is that we need to make it as easy as possible for the wiki-novice to add answer content, so maybe leaving the answers outside the template is a better approach. That's what I was attempting when I was making template:ansreq start by closing the previous divs (unless the requirement number was 1). Then we'd need one more template to close the divs for the last requirement - which is what the template:lastsubreq was supposed to do, but it went too far and closed itself and its parent. That only worked because the parent was the last requirement. I think if we renamed lastsubreq to closereq, made it close only its own divs, and then used it at the end of the last subrequirement within a requirement, and at the end of the last requirement in the honor, we'd be golden. Hopefully my explanation is clear enough to convey my idea? --Jomegat (talk) 23:48, 8 November 2020 (EST)
- Yeah, I was thinking about the same thing. But my conclusion was somehow the same like yours. The problem with the content argument, I think, will be that there will be some problems with MW content (tables, other templates) and I think it won't be that nice to edit with the sections.
- I come to the same conclusion like you. The attempt with automatically closing the divs is nice I think, but I ask myself if it is not easier to do it manually every time with the template, because it is easier to communicate to the user that the requirement has to be started with ansreq and ended with closereq every time then it has only be done at the end. But I don't really know what's best... I can also find myself explaining the way it is now xD.
- Definitely we should build up a Help Namespace with explanaitions of all that. "How to create a Honor?", "How to translate a Honor?", and so on ... What we also should do, I think, is to add a description and generic example of the template to it like at the Template:CustomToggleButton.--DesignerThan (talk) 02:35, 9 November 2020 (EST)
- I implemented an explanation and example now and did a test in the Amphibian Sandbox 2. As I used the example I came across the not so nice thing that I wanted a line break between the answer and the next AnsReq-Box (in the code), but because the box gets closed by the next one the line break was added to the answer. That can be prevented with the <nowiki>-tag but I think the nicer solution would be, if every AnsReq-Box needs to be closed with a CloseReq-Template.--DesignerThan (talk) 04:28, 9 November 2020 (EST)
- It would probably be best to open each requirement with ansreq, and close each one with closereq. Subrequirements would be opened with anssubreq. We should make a closesubreq too, even though it will be the same as closereq. I say that, because it will give us the freedom to change what ansreq and anssubreq do in the future without having to worry about ripple effects. It does feel a little dirty to start the template by closing the previous div. It felt "clever" when I did it, but there is that fine line between stupid and clever.
- Note that none of this has gone live yet. Nothing uses the ansreq template or its friends except the amphibians sandbox. So It would be quite alright to make your changes there instead of in an ansreq/sandbox page. --Jomegat (talk) 18:09, 9 November 2020 (EST)
- Actually, we should sandbox another honor. Now that I've been through a couple hundred of them, I could probably pick one that is more complex. AY Honor Insects - Advanced would be a good choice because it has sub-sub-requirements too, and it's not very long. --Jomegat (talk) 18:16, 9 November 2020 (EST)
Yeah I think so too. At the moment I am a bit in a hurry but the next time I have time and the Templates are not created by them I will start doing it and then working on the two Honors. I created the Sandbox firstly because I didn't know if my changes will work and if they are okay for you guys and secondly because I can't change the AnsReq template and the other once because they are protected. But if you give me the permissen and tell me I should do it, I will as soon as I have time for it. --DesignerThan (talk) 06:44, 10 November 2020 (EST)
- I forgot that I had protected it. I've lifted the edit restriction now, so feel free to flail on it. It will eventually need to be protected again though since it will appear in every single honor. But until then, there's no danger in making it editable by anyone. --Jomegat (talk) 20:03, 10 November 2020 (EST)