WebSite - Revision history

Ltlnx: Clarify that all pages need republishing

2024-05-05T07:56:21Z

Clarify that all pages need republishing

← Older revision		Revision as of 07:56, 5 May 2024
Line 167:		Line 167:
	* Click Page > Unpublish. This would unpublish the page, but keep the contents.		* Click Page > Unpublish. This would unpublish the page, but keep the contents.
	* Clear the contents by going to the sidebar, and clicking the topmost hamburger menu > Empty all. Click on "Yes, I'm sure" to confirm.		* Clear the contents by going to the sidebar, and clicking the topmost hamburger menu > Empty all. Click on "Yes, I'm sure" to confirm.
	* Re-publish the page by clicking the blue "Publish page" button. '''Make sure to do this''' to ensure that ~~only~~ the page ~~itself is unpublished~~, and its subpages keep working. Otherwise every subpage of it will become 404 (Page not found).		* Re-publish the page by clicking the blue "Publish page" button. '''Make sure to do this''' to ensure that the page contents falls back to English, and in the case of root pages (e.g. [https://inkscape.org/learn/ Learn], [https://inkscape.org/contribute/ Contribute]), that its subpages keep working. Otherwise the page and every subpage of it will become 404 (Page not found).

	=== Translating News ===		=== Translating News ===

Ltlnx: /* Unpublishing */ Add saving to the web archive as a suggestion

2024-05-05T07:51:39Z

Unpublishing: Add saving to the web archive as a suggestion

← Older revision		Revision as of 07:51, 5 May 2024
Line 162:		Line 162:
	After you got an approval, you can move on to unpublish the page. To do this:		After you got an approval, you can move on to unpublish the page. To do this:

	* Check if you've switched to the desired language you want to unpublish. You may unpublish pages in other languages if you didn't make sure, so please be extra careful.		* Check if the page you're about to unpublish is saved on the [https://web.archive.org Web Archive], to preserve the contents (as we're clearing them in later steps).
			*Check if you've switched to the desired language you want to unpublish. You may unpublish pages in other languages if you didn't make sure, so please be extra careful.
	*Enter edit mode by going to Page > Edit this page.		*Enter edit mode by going to Page > Edit this page.
	* Click Page > Unpublish. This would unpublish the page, but keep the contents.		* Click Page > Unpublish. This would unpublish the page, but keep the contents.

Moini: Fix broken links mentioned in https://gitlab.com/inkscape/inkscape-web/-/issues/606

2024-04-22T23:15:58Z

Fix broken links mentioned in https://gitlab.com/inkscape/inkscape-web/-/issues/606

← Older revision		Revision as of 23:15, 22 April 2024
Line 5:		Line 5:
	== Editing ==		== Editing ==

	~~We have a [https://inkscape.org/*editor small team of people] who look after~~ the ~~web site contents, keep it~~ up-to-date and constantly look for ways to improve it, by collecting information from various sources and presenting it on the web site. You can support us in various ways: suggest improvements or corrections, write contents about topics that are missing, write news articles and help with ‘marketing’, or join us long-term and help with contents maintenance.		If you would like to help keep the website up-to-date and constantly look for ways to improve it, by collecting information from various sources and presenting it on the web site, join us in the chat for the [https://chat.inkscape.org/channel/documentation documentation], the [marketing https://chat.inkscape.org/channel/team_vectors] and/or the [https://chat.inkscape.org/channel/team_website website team]. You can support us in various ways: suggest improvements or corrections, write contents about topics that are missing, write news articles and help with ‘marketing’, or join us long-term and help with contents maintenance.

	=== General Rules ===		=== General Rules ===
Line 233:		Line 233:
	* The published website: https://inkscape.org/		* The published website: https://inkscape.org/
	* The staging website (testing): http://staging.inkscape.org/ (currently unavailable)		* The staging website (testing): http://staging.inkscape.org/ (currently unavailable)
	* The project on Launchpad (only bug reports created before February 2017): https://launchpad.net/inkscape-web/bugs
	* The project on gitlab (code repository and bug reports created since February 2017): https://gitlab.com/inkscape/inkscape-web		* The project on gitlab (code repository and bug reports created since February 2017): https://gitlab.com/inkscape/inkscape-web

Line 255:		Line 254:

	* Option B (better):		* Option B (better):
	** Create an ssh key if you don't have one yet, and upload your public ssh key to gitlab (instructions: https://docs.gitlab.com/ee/~~gitlab-basics~~/~~create-your-~~ssh~~-keys~~.html).		** Create an ssh key if you don't have one yet, and upload your public ssh key to gitlab (instructions: https://docs.gitlab.com/ee/user/ssh.html).
	** <code>$ git clone git@gitlab.com:inkscape/inkscape-web.git</code>		** <code>$ git clone git@gitlab.com:inkscape/inkscape-web.git</code>

Line 312:		Line 311:
	Once you have made your modifications, please commit back and push to your own fork of inkscape-web for review unless otherwise granted permission to commit to the master branch.		Once you have made your modifications, please commit back and push to your own fork of inkscape-web for review unless otherwise granted permission to commit to the master branch.

	See https://docs.gitlab.com/ce/~~workflow~~/forking_workflow.html for more info on forking a project on gitlab and making merge requests.		See https://docs.gitlab.com/ee/user/project/repository/forking_workflow.html for more info on forking a project on gitlab and making merge requests.

	To set the origin of your local copy of inkscape-web to a personal fork on gitlab, you can do the following:		To set the origin of your local copy of inkscape-web to a personal fork on gitlab, you can do the following:

Ltlnx: Grammar and clarification

2024-04-21T16:31:56Z

Grammar and clarification

← Older revision		Revision as of 16:31, 21 April 2024
Line 166:		Line 166:
	* Click Page > Unpublish. This would unpublish the page, but keep the contents.		* Click Page > Unpublish. This would unpublish the page, but keep the contents.
	* Clear the contents by going to the sidebar, and clicking the topmost hamburger menu > Empty all. Click on "Yes, I'm sure" to confirm.		* Clear the contents by going to the sidebar, and clicking the topmost hamburger menu > Empty all. Click on "Yes, I'm sure" to confirm.
	* Re-publish the page by clicking the blue "Publish page" button. '''Make sure to do this''' to ensure that only the page itself is unpublished, and ~~keep~~ its subpages working. Otherwise ~~all subpages~~ will become 404 (Page not found).		* Re-publish the page by clicking the blue "Publish page" button. '''Make sure to do this''' to ensure that only the page itself is unpublished, and its subpages keep working. Otherwise every subpage of it will become 404 (Page not found).

	=== Translating News ===		=== Translating News ===

Ltlnx: Grammar fix

2024-04-21T16:28:02Z

Grammar fix

← Older revision		Revision as of 16:28, 21 April 2024
Line 166:		Line 166:
	* Click Page > Unpublish. This would unpublish the page, but keep the contents.		* Click Page > Unpublish. This would unpublish the page, but keep the contents.
	* Clear the contents by going to the sidebar, and clicking the topmost hamburger menu > Empty all. Click on "Yes, I'm sure" to confirm.		* Clear the contents by going to the sidebar, and clicking the topmost hamburger menu > Empty all. Click on "Yes, I'm sure" to confirm.
	* Re-publish the page by clicking the blue "Publish page" button. '''Make sure to do this''' to ensure that only the page itself is unpublished, and its subpages ~~will keep~~ working. Otherwise all subpages will become 404 (Page not found).		* Re-publish the page by clicking the blue "Publish page" button. '''Make sure to do this''' to ensure that only the page itself is unpublished, and keep its subpages working. Otherwise all subpages will become 404 (Page not found).

	=== Translating News ===		=== Translating News ===

Ltlnx: Remove links to Launchpad (outdated)

2024-04-21T16:22:47Z

Remove links to Launchpad (outdated)

← Older revision		Revision as of 16:22, 21 April 2024
Line 306:		Line 306:
	==== Bug Reports ====		==== Bug Reports ====

	We use ~~Launchpad's and~~ Gitlab's bug tracker to report and track progress on bug reports. Please see ~~https://bugs.launchpad.net/inkscape-web and~~ https://gitlab.com/inkscape/inkscape-web/-/issues for possible things to fix.		We use Gitlab's bug tracker to report and track progress on bug reports. Please see https://gitlab.com/inkscape/inkscape-web/-/issues for possible things to fix.

	==== Making changes ====		==== Making changes ====

Ltlnx: Add an instruction to check the language the editor's in

2024-04-21T16:20:05Z

Add an instruction to check the language the editor's in

← Older revision		Revision as of 16:20, 21 April 2024
Line 162:		Line 162:
	After you got an approval, you can move on to unpublish the page. To do this:		After you got an approval, you can move on to unpublish the page. To do this:

	* Enter edit mode by going to Page > Edit this page.		* Check if you've switched to the desired language you want to unpublish. You may unpublish pages in other languages if you didn't make sure, so please be extra careful.
			*Enter edit mode by going to Page > Edit this page.
	* Click Page > Unpublish. This would unpublish the page, but keep the contents.		* Click Page > Unpublish. This would unpublish the page, but keep the contents.
	* Clear the contents by going to the sidebar, and clicking the topmost hamburger menu > Empty all. Click on "Yes, I'm sure" to confirm.		* Clear the contents by going to the sidebar, and clicking the topmost hamburger menu > Empty all. Click on "Yes, I'm sure" to confirm.

Ltlnx: Add guide for unpublishing pages

2024-04-21T16:14:56Z

Add guide for unpublishing pages

← Older revision		Revision as of 16:14, 21 April 2024
Line 156:		Line 156:
	* If there are no images, tables of contents or other plugins in the text you want to copy-paste:		* If there are no images, tables of contents or other plugins in the text you want to copy-paste:
	** feel free to copy-paste it as a whole into your translation, and to translate in place.		** feel free to copy-paste it as a whole into your translation, and to translate in place.

			==== Unpublishing ====
			If a translated page contains outdated information, you might consider unpublishing it. Before you unpublish, please make sure to send a message to the inkscape-translators mailing list or the chat, to seek approval from other editors.
			[[File:Empty all.png\|alt=Screenshot of the website with the "Empty all" button highlighted\|thumb\|The "Empty all" button]]
			After you got an approval, you can move on to unpublish the page. To do this:

			* Enter edit mode by going to Page > Edit this page.
			* Click Page > Unpublish. This would unpublish the page, but keep the contents.
			* Clear the contents by going to the sidebar, and clicking the topmost hamburger menu > Empty all. Click on "Yes, I'm sure" to confirm.
			* Re-publish the page by clicking the blue "Publish page" button. '''Make sure to do this''' to ensure that only the page itself is unpublished, and its subpages will keep working. Otherwise all subpages will become 404 (Page not found).

	=== Translating News ===		=== Translating News ===

Moini at 14:47, 16 February 2023

2023-02-16T14:47:54Z

← Older revision		Revision as of 14:47, 16 February 2023
Line 26:		Line 26:
	'''The real thing:''' When you have practiced a little, and feel ready to edit contents on the real website, please [https://inkscape.org/user/register/ create a separate account] at our main website and contact us again to be granted permissions.		'''The real thing:''' When you have practiced a little, and feel ready to edit contents on the real website, please [https://inkscape.org/user/register/ create a separate account] at our main website and contact us again to be granted permissions.
	-->		-->
	Please [https://inkscape.org/user/register/ register] an account using your email address and activate the account. Once active and logged in, please email the [https://inkscape.org/community/mailing-lists/ inkscape-docs or inkscape-translators mailing list] to get the ~~necessary permissions~~.		Please [https://inkscape.org/user/register/ register] an account using your email address and activate the account. Once active and logged in, please '''subscribe''' to the corresponding mailing list and email either the [https://inkscape.org/community/mailing-lists/ inkscape-docs or the inkscape-translators mailing list] to get more information. For translations, please add some more info to your email, and additionally open a request to join the website translators' team (see Translation section below) and start by contributing to the website's .po file for your language.

	~~Your~~ account will then be enabled with the right permissions to add and edit any of the pages on the website. Please take care not to disrupt other content as you edit the website. As before, don't hesitate to ask other website editors on their mailing list if you need help.		If you're approved, your account will then be enabled with the right permissions to add and edit any of the pages on the website. Please take care not to disrupt other content as you edit the website. As before, don't hesitate to ask other website editors on their mailing list if you need help.

	If anything goes wrong while you are editing — for example, you encounter a bug, or you accidentally delete something you did not intend to delete, or something weird happens, and you don't know why —, please ask for help on one of the mailing lists — either translators, or inkscape-docs. You can also contact your team admin directly or file a bug report for the website at the [https://gitlab.com/inkscape/inkscape-web/-/issues bug tracker].		If anything goes wrong while you are editing — for example, you encounter a bug, or you accidentally delete something you did not intend to delete, or something weird happens, and you don't know why —, please ask for help on one of the mailing lists — either translators, or inkscape-docs. You can also contact your team admin directly or file a bug report for the website at the [https://gitlab.com/inkscape/inkscape-web/-/issues bug tracker].

Ted1277: /* Translating Menu contents */ update

2022-02-13T06:43:11Z

Translating Menu contents: update

← Older revision		Revision as of 06:43, 13 February 2022
Line 110:		Line 110:
	* Now use the language chooser to switch to your language ([[Media:Select language.png\|Image 2]]).		* Now use the language chooser to switch to your language ([[Media:Select language.png\|Image 2]]).
	* You should now see a blue '''Page Settings''' button at the right. Click on it. (If there's a button that says 'Create', '''go back to the English page''' and switch to Edit mode. 'Create' will create a new page, not a translation.) ([[Media:CMS toolbar Page Settings button.png\|Image 3]]).		* You should now see a blue '''Page Settings''' button at the right. Click on it. (If there's a button that says 'Create', '''go back to the English page''' and switch to Edit mode. 'Create' will create a new page, not a translation.) ([[Media:CMS toolbar Page Settings button.png\|Image 3]]).
	* In the '''Page settings''', enter a title for your new translation and click on '''Save''' ([[Media:~~Add_a_language_2~~.png\|Image 4]]).		* In the '''Page settings''', enter a title for your new translation and click on '''Save''' ([[Media:Add a language 2.png\|Image 4]]).
	* At first, the new page will be empty. We must now fill it with a copy of the English content. Start by toggling the structure mode view ([[Media:Toggle structure mode website.png\|Image 5]]).		* At first, the new page will be empty. We must now fill it with a copy of the English content. Start by toggling the structure mode view ([[Media:Toggle structure mode website.png\|Image 5]]).
	* Next, click on the topmost hamburger icon in the structure panel (next to the name of the template that is being used), and select '''Copy from English''' ([[Media:Copy plugins from English.png\|Image 6]]).		* Next, click on the topmost hamburger icon in the structure panel (next to the name of the template that is being used), and select '''Copy from English''' ([[Media:Copy plugins from English.png\|Image 6]]).
	* The page will now contain the same texts and widgets as the English version does. You can click on the structure toggle icon again to hide the structure overview. To start translating, double-click on a text ([[Media:Double-click to edit.png\|Image 7]]).		* The page will now contain the same texts and widgets as the English version does. You can click on the structure toggle icon again to hide the structure overview. To start translating, double-click on a text ([[Media:Double-click to edit.png\|Image 7]]).
	* An editor window will pop up and you can translate the text ([[Media:~~Editor_window~~.png\|Image 8]]).		* An editor window will pop up and you can translate the text ([[Media:Editor window.png\|Image 8]]).
	* If something does not look correct (for example, because you accidentally deleted a certain html tag), you can choose to edit the html source, too ([[Media:~~Editor_window_source~~.png\|Image 9]]).		* If something does not look correct (for example, because you accidentally deleted a certain html tag), you can choose to edit the html source, too ([[Media:Editor window source.png\|Image 9]]).
	* When you are done, click on '''Save''' to save your work. Don't forget to leave a comment about your changes ([[Media:Save Edit with comment.png\|Image 10]]).		* When you are done, click on '''Save''' to save your work. Don't forget to leave a comment about your changes ([[Media:Save Edit with comment.png\|Image 10]]).
	* You can now take a look at your translation and if you are happy with your work, click on the '''Publish''' button at the top of the page. Only this will make your translation available to the site's visitors ([[Media:Publish page.png\|Image 11]]).		* You can now take a look at your translation and if you are happy with your work, click on the '''Publish''' button at the top of the page. Only this will make your translation available to the site's visitors ([[Media:Publish page.png\|Image 11]]).
Line 188:		Line 188:
	=== Translating Menu contents ===		=== Translating Menu contents ===

	~~Please~~ send a text file with a list of the following format:		The menu items are translatable from the CMS administration pages.

			* If you have access rights: go to [https://inkscape.org/admin/el_menu/menuitem/ EL_MENU > Menu items]. All menu items are listed here, you can use the "FILTER" on the right panel and select "Main Menu" under "By category". Select the menu you want to translate, then in the last row under "MENU TRANSLATIONS" (the last row is blank), choose the language and type the URL and your translation. Save to finish this translation.
			* If you don't have access rights: you can send your translation in a text file to the inkscape-translator mailing list, and an authorized translator will set them for you. Please prepare the text file with a list of the following format:

	<code>English menu entry, url, translated menu entry</code><br/>		<code>English menu entry, url, translated menu entry</code><br/>
Line 199:		Line 202:
	Overview, /about/overview/, Übersicht		Overview, /about/overview/, Übersicht
	</pre>		</pre>

	~~to someone with access to the website administration interface.~~

	=== Translating other parts of the website ===		=== Translating other parts of the website ===