Theme file format - Versionshistorik

Admin: /* Stiliserade Boxar */

2024-09-23T06:10:36Z

Stiliserade Boxar

← Äldre version		Versionen från 23 september 2024 kl. 06.10
Rad 46:		Rad 46:

	Figur 7.3		Figur 7.3

	== Skapa Stiliserade Boxbilder ==		== Skapa Stiliserade Boxbilder ==
	Vektorgrafikredigeraren Inkscape är ett mycket användbart verktyg för att skapa bilder för stiliserade boxar. En process som fungerar väl för att skära upp en ritning i nödvändiga bildremsor är:		Vektorgrafikredigeraren Inkscape är ett mycket användbart verktyg för att skapa bilder för stiliserade boxar. En process som fungerar väl för att skära upp en ritning i nödvändiga bildremsor är:

Admin: /* 7.3.6 Gemensamma Egenskaper */

2024-09-23T06:09:07Z

7.3.6 Gemensamma Egenskaper

← Äldre version		Versionen från 23 september 2024 kl. 06.09
Rad 154:		Rad 154:
	</ul>		</ul>

	=== ~~7.3.6~~ Gemensamma Egenskaper ===		=== Gemensamma Egenskaper ===
	Följande egenskaper stöds av alla komponenter:		Följande egenskaper stöds av alla komponenter:

Rad 166:		Rad 166:
	* '''id''' - Identifieraren för komponenten. Detta kan vara vilken godtycklig sträng som helst. ID:t kan användas av skript för att referera till olika komponenter i GUI-komponentträdet. För närvarande finns det ett speciellt ID-värde som GRUB känner igen:		* '''id''' - Identifieraren för komponenten. Detta kan vara vilken godtycklig sträng som helst. ID:t kan användas av skript för att referera till olika komponenter i GUI-komponentträdet. För närvarande finns det ett speciellt ID-värde som GRUB känner igen:
	* '''__timeout__''' - Komponent med detta ID kommer att uppdateras av GRUB och kommer att indikera tiden som förflutit till en automatisk start av standardvalet. Berörda komponenter: "label", "circular_progress", "progress_bar".		* '''__timeout__''' - Komponent med detta ID kommer att uppdateras av GRUB och kommer att indikera tiden som förflutit till en automatisk start av standardvalet. Berörda komponenter: "label", "circular_progress", "progress_bar".


	= Sidslut =		= Sidslut =

Admin: /* 7.3.4 Komponentkonstruktion */

2024-09-23T06:08:57Z

7.3.4 Komponentkonstruktion

← Äldre version		Versionen från 23 september 2024 kl. 06.08
Rad 94:		Rad 94:
	* '''terminal-height''' - Specificerar höjden på terminalfönstret.		* '''terminal-height''' - Specificerar höjden på terminalfönstret.

	=== ~~7.3.4~~ Komponentkonstruktion ===		=== Komponentkonstruktion ===
	Större anpassningsbarhet ges av komponenter. Ett träd av komponenter bildar användargränssnittet. Behållare är komponenter som kan innehålla andra komponenter, och det finns alltid en enda rotkomponent som är en instans av en duk-behållare.		Större anpassningsbarhet ges av komponenter. Ett träd av komponenter bildar användargränssnittet. Behållare är komponenter som kan innehålla andra komponenter, och det finns alltid en enda rotkomponent som är en instans av en duk-behållare.

Admin: /* 7.2.6 Startmeny */

2024-09-23T06:08:44Z

7.2.6 Startmeny

← Äldre version		Versionen från 23 september 2024 kl. 06.08
Rad 27:		Rad 27:
	Textetiketter kan placeras på startskärmen. Typsnittet, färgen och den horisontella justeringen kan specificeras för etiketter. Om en etikett ges id "__timeout__", uppdateras även "text"-egenskapen för den etiketten med ett meddelande som informerar användaren om antalet sekunder som återstår till automatisk start. Detta är användbart om du vill att texten visas någon annanstans istället för direkt på tidslinjen.		Textetiketter kan placeras på startskärmen. Typsnittet, färgen och den horisontella justeringen kan specificeras för etiketter. Om en etikett ges id "__timeout__", uppdateras även "text"-egenskapen för den etiketten med ett meddelande som informerar användaren om antalet sekunder som återstår till automatisk start. Detta är användbart om du vill att texten visas någon annanstans istället för direkt på tidslinjen.

	=== ~~7.2.6~~ Startmeny ===		=== Startmeny ===
	Startmenyn där GRUB visar menyposter från filen ”grub.cfg”. Det är en lista över objekt, där varje objekt har en titel och en valfri ikon. Ikonen väljs baserat på de klasser som specificeras för menyposten. Om det finns en PNG-fil med namnet ”myclass.png” i katalogen ”grub/themes/icons”, kommer den att visas för objekt som har klassen myclass. Startmenyn kan anpassas på flera sätt, såsom typsnittet och färgen som används för titeln på menyposten, samt genom att specificera stylade boxar för själva menyn och för markeringen av det valda objektet.		Startmenyn där GRUB visar menyposter från filen ”grub.cfg”. Det är en lista över objekt, där varje objekt har en titel och en valfri ikon. Ikonen väljs baserat på de klasser som specificeras för menyposten. Om det finns en PNG-fil med namnet ”myclass.png” i katalogen ”grub/themes/icons”, kommer den att visas för objekt som har klassen myclass. Startmenyn kan anpassas på flera sätt, såsom typsnittet och färgen som används för titeln på menyposten, samt genom att specificera stylade boxar för själva menyn och för markeringen av det valda objektet.

Admin: /* 7.2.5 Etiketter */

2024-09-23T06:08:29Z

7.2.5 Etiketter

← Äldre version		Versionen från 23 september 2024 kl. 06.08
Rad 24:		Rad 24:
	Den cirkulära tidsindikatorn fungerar på liknande sätt som tidslinjen. När den ges ett id av "__timeout__", uppdaterar GRUB den cirkulära tidsindikatorns värde för att indikera den återstående tiden. För den cirkulära tidsindikatorn används två bilder för att rendera den: center-bilden och tick-bilden. Centerbilden renderas i mitten av komponenten, medan tick-bilden används för att rendera varje markering längs omkretsen av indikatorn.		Den cirkulära tidsindikatorn fungerar på liknande sätt som tidslinjen. När den ges ett id av "__timeout__", uppdaterar GRUB den cirkulära tidsindikatorns värde för att indikera den återstående tiden. För den cirkulära tidsindikatorn används två bilder för att rendera den: center-bilden och tick-bilden. Centerbilden renderas i mitten av komponenten, medan tick-bilden används för att rendera varje markering längs omkretsen av indikatorn.

	=== ~~7.2.5~~ Etiketter ===		=== Etiketter ===
	Textetiketter kan placeras på startskärmen. Typsnittet, färgen och den horisontella justeringen kan specificeras för etiketter. Om en etikett ges id "__timeout__", uppdateras även "text"-egenskapen för den etiketten med ett meddelande som informerar användaren om antalet sekunder som återstår till automatisk start. Detta är användbart om du vill att texten visas någon annanstans istället för direkt på tidslinjen.		Textetiketter kan placeras på startskärmen. Typsnittet, färgen och den horisontella justeringen kan specificeras för etiketter. Om en etikett ges id "__timeout__", uppdateras även "text"-egenskapen för den etiketten med ett meddelande som informerar användaren om antalet sekunder som återstår till automatisk start. Detta är användbart om du vill att texten visas någon annanstans istället för direkt på tidslinjen.

Admin: /* 7.2.4 Cirkulär Tidsindikator */

2024-09-23T06:08:21Z

7.2.4 Cirkulär Tidsindikator

← Äldre version		Versionen från 23 september 2024 kl. 06.08
Rad 21:		Rad 21:
	Tidslinjer kan valfritt ha text som visas på dem. Denna text styrs av variabeln "text" som innehåller en printf-mall där enda argumentet %d är antalet sekunder som återstår. Dessutom ersätts speciella värden "@TIMEOUT_NOTIFICATION_SHORT@", "@TIMEOUT_NOTIFICATION_MIDDLE@" och "@TIMEOUT_NOTIFICATION_LONG@" med standard- och översatta mallar.		Tidslinjer kan valfritt ha text som visas på dem. Denna text styrs av variabeln "text" som innehåller en printf-mall där enda argumentet %d är antalet sekunder som återstår. Dessutom ersätts speciella värden "@TIMEOUT_NOTIFICATION_SHORT@", "@TIMEOUT_NOTIFICATION_MIDDLE@" och "@TIMEOUT_NOTIFICATION_LONG@" med standard- och översatta mallar.

	=== ~~7.2.4~~ Cirkulär Tidsindikator ===		=== Cirkulär Tidsindikator ===
	Den cirkulära tidsindikatorn fungerar på liknande sätt som tidslinjen. När den ges ett id av "__timeout__", uppdaterar GRUB den cirkulära tidsindikatorns värde för att indikera den återstående tiden. För den cirkulära tidsindikatorn används två bilder för att rendera den: center-bilden och tick-bilden. Centerbilden renderas i mitten av komponenten, medan tick-bilden används för att rendera varje markering längs omkretsen av indikatorn.		Den cirkulära tidsindikatorn fungerar på liknande sätt som tidslinjen. När den ges ett id av "__timeout__", uppdaterar GRUB den cirkulära tidsindikatorns värde för att indikera den återstående tiden. För den cirkulära tidsindikatorn används två bilder för att rendera den: center-bilden och tick-bilden. Centerbilden renderas i mitten av komponenten, medan tick-bilden används för att rendera varje markering längs omkretsen av indikatorn.

Admin: /* 7.2.3 Tidslinje för Timeout */

2024-09-23T06:08:11Z

7.2.3 Tidslinje för Timeout

← Äldre version		Versionen från 23 september 2024 kl. 06.08
Rad 12:		Rad 12:
	De typsnitt som GRUB använder är i "PFF2 font format" för bitmap-typsnitt. Typsnitt specificeras med fulla typsnittsnamn. För närvarande finns det inga förutsättningar för en önskelista av typsnitt eller härledning av ett typsnitt från ett annat. Typsnitt laddas med kommandot "loadfont" i GRUB (loadfont). För att se listan över laddade typsnitt, kör kommandot "lsfonts" (lsfonts). Om det finns för många typsnitt för att passa på skärmen, gör "set pager=1" innan du kör "lsfonts".		De typsnitt som GRUB använder är i "PFF2 font format" för bitmap-typsnitt. Typsnitt specificeras med fulla typsnittsnamn. För närvarande finns det inga förutsättningar för en önskelista av typsnitt eller härledning av ett typsnitt från ett annat. Typsnitt laddas med kommandot "loadfont" i GRUB (loadfont). För att se listan över laddade typsnitt, kör kommandot "lsfonts" (lsfonts). Om det finns för många typsnitt för att passa på skärmen, gör "set pager=1" innan du kör "lsfonts".

	=== ~~7.2.3~~ Tidslinje för Timeout ===		=== Tidslinje för Timeout ===
	Se figur 7.1		Se figur 7.1

Admin: /* 7.2.2 Typsnitt */

2024-09-23T06:08:02Z

7.2.2 Typsnitt

← Äldre version		Versionen från 23 september 2024 kl. 06.08
Rad 9:		Rad 9:
	* Med "SVG 1.0 färgnamn" (t.ex. "cornflowerblue") som måste specificeras i små bokstäver.		* Med "SVG 1.0 färgnamn" (t.ex. "cornflowerblue") som måste specificeras i små bokstäver.

	=== ~~7.2.2~~ Typsnitt ===		=== Typsnitt ===
	De typsnitt som GRUB använder är i "PFF2 font format" för bitmap-typsnitt. Typsnitt specificeras med fulla typsnittsnamn. För närvarande finns det inga förutsättningar för en önskelista av typsnitt eller härledning av ett typsnitt från ett annat. Typsnitt laddas med kommandot "loadfont" i GRUB (loadfont). För att se listan över laddade typsnitt, kör kommandot "lsfonts" (lsfonts). Om det finns för många typsnitt för att passa på skärmen, gör "set pager=1" innan du kör "lsfonts".		De typsnitt som GRUB använder är i "PFF2 font format" för bitmap-typsnitt. Typsnitt specificeras med fulla typsnittsnamn. För närvarande finns det inga förutsättningar för en önskelista av typsnitt eller härledning av ett typsnitt från ett annat. Typsnitt laddas med kommandot "loadfont" i GRUB (loadfont). För att se listan över laddade typsnitt, kör kommandot "lsfonts" (lsfonts). Om det finns för många typsnitt för att passa på skärmen, gör "set pager=1" innan du kör "lsfonts".

Admin: /* 7.2.1 Färger */

2024-09-23T06:07:52Z

7.2.1 Färger

← Äldre version		Versionen från 23 september 2024 kl. 06.07
Rad 3:		Rad 3:
	GRUB:s grafiska meny stödjer teman som kan anpassa layouten och utseendet på GRUB:s startmeny. Temat konfigureras genom en vanlig textfil som specificerar layouten för olika GUI-komponenter (inklusive startmenyn, tidslinjen för timeout och textmeddelanden) samt utseendet med hjälp av färger, typsnitt och bilder. Ett exempel finns tillgängligt i docs/example_theme.txt		GRUB:s grafiska meny stödjer teman som kan anpassa layouten och utseendet på GRUB:s startmeny. Temat konfigureras genom en vanlig textfil som specificerar layouten för olika GUI-komponenter (inklusive startmenyn, tidslinjen för timeout och textmeddelanden) samt utseendet med hjälp av färger, typsnitt och bilder. Ett exempel finns tillgängligt i docs/example_theme.txt
	== Temaelement ==		== Temaelement ==
	=== ~~7.2.1~~ Färger ===		=== Färger ===
	Färger kan specificeras på flera sätt:		Färger kan specificeras på flera sätt:
	* HTML-stil "#RRGGBB" eller "#RGB", där R, G och B är hexadecimala siffror (t.ex. "#8899FF")		* HTML-stil "#RRGGBB" eller "#RGB", där R, G och B är hexadecimala siffror (t.ex. "#8899FF")

Admin den 23 september 2024 kl. 06.07

2024-09-23T06:07:33Z

← Äldre version		Versionen från 23 september 2024 kl. 06.07
Rad 1:		Rad 1:
	=~~= 7~~ Temafilsformat ==		= Temafilsformat =
	==~~= 7.1~~ Introduktion ===		== Introduktion ==
	GRUB:s grafiska meny stödjer teman som kan anpassa layouten och utseendet på GRUB:s startmeny. Temat konfigureras genom en vanlig textfil som specificerar layouten för olika GUI-komponenter (inklusive startmenyn, tidslinjen för timeout och textmeddelanden) samt utseendet med hjälp av färger, typsnitt och bilder. Ett exempel finns tillgängligt i docs/example_theme.txt		GRUB:s grafiska meny stödjer teman som kan anpassa layouten och utseendet på GRUB:s startmeny. Temat konfigureras genom en vanlig textfil som specificerar layouten för olika GUI-komponenter (inklusive startmenyn, tidslinjen för timeout och textmeddelanden) samt utseendet med hjälp av färger, typsnitt och bilder. Ett exempel finns tillgängligt i docs/example_theme.txt
			== Temaelement ==
	=== ~~7.2~~ Temaelement ===		=== 7.2.1 Färger ===
	==== 7.2.1 Färger ====
	Färger kan specificeras på flera sätt:		Färger kan specificeras på flera sätt:
	* HTML-stil "#RRGGBB" eller "#RGB", där R, G och B är hexadecimala siffror (t.ex. "#8899FF")		* HTML-stil "#RRGGBB" eller "#RGB", där R, G och B är hexadecimala siffror (t.ex. "#8899FF")
Rad 10:		Rad 9:
	* Med "SVG 1.0 färgnamn" (t.ex. "cornflowerblue") som måste specificeras i små bokstäver.		* Med "SVG 1.0 färgnamn" (t.ex. "cornflowerblue") som måste specificeras i små bokstäver.

	==== 7.2.2 Typsnitt ====		=== 7.2.2 Typsnitt ===
	De typsnitt som GRUB använder är i "PFF2 font format" för bitmap-typsnitt. Typsnitt specificeras med fulla typsnittsnamn. För närvarande finns det inga förutsättningar för en önskelista av typsnitt eller härledning av ett typsnitt från ett annat. Typsnitt laddas med kommandot "loadfont" i GRUB (loadfont). För att se listan över laddade typsnitt, kör kommandot "lsfonts" (lsfonts). Om det finns för många typsnitt för att passa på skärmen, gör "set pager=1" innan du kör "lsfonts".		De typsnitt som GRUB använder är i "PFF2 font format" för bitmap-typsnitt. Typsnitt specificeras med fulla typsnittsnamn. För närvarande finns det inga förutsättningar för en önskelista av typsnitt eller härledning av ett typsnitt från ett annat. Typsnitt laddas med kommandot "loadfont" i GRUB (loadfont). För att se listan över laddade typsnitt, kör kommandot "lsfonts" (lsfonts). Om det finns för många typsnitt för att passa på skärmen, gör "set pager=1" innan du kör "lsfonts".

	==== 7.2.3 Tidslinje för Timeout ====		=== 7.2.3 Tidslinje för Timeout ===
	Se figur 7.1		Se figur 7.1

Rad 22:		Rad 21:
	Tidslinjer kan valfritt ha text som visas på dem. Denna text styrs av variabeln "text" som innehåller en printf-mall där enda argumentet %d är antalet sekunder som återstår. Dessutom ersätts speciella värden "@TIMEOUT_NOTIFICATION_SHORT@", "@TIMEOUT_NOTIFICATION_MIDDLE@" och "@TIMEOUT_NOTIFICATION_LONG@" med standard- och översatta mallar.		Tidslinjer kan valfritt ha text som visas på dem. Denna text styrs av variabeln "text" som innehåller en printf-mall där enda argumentet %d är antalet sekunder som återstår. Dessutom ersätts speciella värden "@TIMEOUT_NOTIFICATION_SHORT@", "@TIMEOUT_NOTIFICATION_MIDDLE@" och "@TIMEOUT_NOTIFICATION_LONG@" med standard- och översatta mallar.

	==== 7.2.4 Cirkulär Tidsindikator ====		=== 7.2.4 Cirkulär Tidsindikator ===
	Den cirkulära tidsindikatorn fungerar på liknande sätt som tidslinjen. När den ges ett id av "__timeout__", uppdaterar GRUB den cirkulära tidsindikatorns värde för att indikera den återstående tiden. För den cirkulära tidsindikatorn används två bilder för att rendera den: center-bilden och tick-bilden. Centerbilden renderas i mitten av komponenten, medan tick-bilden används för att rendera varje markering längs omkretsen av indikatorn.		Den cirkulära tidsindikatorn fungerar på liknande sätt som tidslinjen. När den ges ett id av "__timeout__", uppdaterar GRUB den cirkulära tidsindikatorns värde för att indikera den återstående tiden. För den cirkulära tidsindikatorn används två bilder för att rendera den: center-bilden och tick-bilden. Centerbilden renderas i mitten av komponenten, medan tick-bilden används för att rendera varje markering längs omkretsen av indikatorn.

Rad 31:		Rad 30:
	Startmenyn där GRUB visar menyposter från filen ”grub.cfg”. Det är en lista över objekt, där varje objekt har en titel och en valfri ikon. Ikonen väljs baserat på de klasser som specificeras för menyposten. Om det finns en PNG-fil med namnet ”myclass.png” i katalogen ”grub/themes/icons”, kommer den att visas för objekt som har klassen myclass. Startmenyn kan anpassas på flera sätt, såsom typsnittet och färgen som används för titeln på menyposten, samt genom att specificera stylade boxar för själva menyn och för markeringen av det valda objektet.		Startmenyn där GRUB visar menyposter från filen ”grub.cfg”. Det är en lista över objekt, där varje objekt har en titel och en valfri ikon. Ikonen väljs baserat på de klasser som specificeras för menyposten. Om det finns en PNG-fil med namnet ”myclass.png” i katalogen ”grub/themes/icons”, kommer den att visas för objekt som har klassen myclass. Startmenyn kan anpassas på flera sätt, såsom typsnittet och färgen som används för titeln på menyposten, samt genom att specificera stylade boxar för själva menyn och för markeringen av det valda objektet.

	=== ~~7.2.7~~ Stiliserade Boxar ===		=== Stiliserade Boxar ===
	En av de viktigaste funktionerna för att anpassa layouten är användningen av stiliserade boxar. En stiliserad box består av 9 rektangulära (och potentiellt tomma) regioner, som används för att sömlöst rita den stiliserade boxen på skärmen:		En av de viktigaste funktionerna för att anpassa layouten är användningen av stiliserade boxar. En stiliserad box består av 9 rektangulära (och potentiellt tomma) regioner, som används för att sömlöst rita den stiliserade boxen på skärmen:

Rad 47:		Rad 46:

	Figur 7.3		Figur 7.3
	==~~= 7.2.8~~ Skapa Stiliserade Boxbilder ===		== Skapa Stiliserade Boxbilder ==
	Vektorgrafikredigeraren Inkscape är ett mycket användbart verktyg för att skapa bilder för stiliserade boxar. En process som fungerar väl för att skära upp en ritning i nödvändiga bildremsor är:		Vektorgrafikredigeraren Inkscape är ett mycket användbart verktyg för att skapa bilder för stiliserade boxar. En process som fungerar väl för att skära upp en ritning i nödvändiga bildremsor är:

Rad 59:		Rad 58:
	* Välj Arkiv \| Exportera Bitmap och kryssa i rutan Batchexport 9 valda objekt. Se till att Dölj alla utom valda inte är ikryssad. klicka på Exportera. Detta kommer att skapa PNG-filer i samma katalog som ritningen, uppkallade efter remsorna. Dessa kan nu användas för en stiliserad box i ett GRUB-tema.		* Välj Arkiv \| Exportera Bitmap och kryssa i rutan Batchexport 9 valda objekt. Se till att Dölj alla utom valda inte är ikryssad. klicka på Exportera. Detta kommer att skapa PNG-filer i samma katalog som ritningen, uppkallade efter remsorna. Dessa kan nu användas för en stiliserad box i ett GRUB-tema.

	==~~= 7.3~~ Temafilhandbok ===		== Temafilhandbok ==
	Temafilen är en vanlig textfil. Rader som börjar med "#" ignoreras och anses vara kommentarer. (Observera: Detta kanske inte är fallet om den föregående raden slutade där ett värde förväntades.)		Temafilen är en vanlig textfil. Rader som börjar med "#" ignoreras och anses vara kommentarer. (Observera: Detta kanske inte är fallet om den föregående raden slutade där ett värde förväntades.)

Rad 67:		Rad 66:
	Konstruktion av komponenter.		Konstruktion av komponenter.

	==~~= 7.3.2~~ Format ===		== Format ==
	Globala egenskaper specificeras med följande enkla format:		Globala egenskaper specificeras med följande enkla format:
	<pre>		<pre>
Rad 76:		Rad 75:
	I detta exempel tilldelas namn3 ett färgvärde.		I detta exempel tilldelas namn3 ett färgvärde.

	=== ~~7.3.3~~ Lista över Globala Egenskaper ===		=== Lista över Globala Egenskaper ===
	* '''title-text''' - Specificerar texten som ska visas överst i mitten av skärmen som en titel.		* '''title-text''' - Specificerar texten som ska visas överst i mitten av skärmen som en titel.
	* '''title-font''' - Definierar typsnittet som används för titelmeddelandet överst på skärmen.		* '''title-font''' - Definierar typsnittet som används för titelmeddelandet överst på skärmen.
Rad 108:		Rad 107:
	* en tupel (t.ex., "preferred_size = (120, 80)").		* en tupel (t.ex., "preferred_size = (120, 80)").

	=== ~~7.3.5~~ Komponentlista ===		=== Komponentlista ===
	<h3>~~7.3.5~~ Komponentlista</h3>		<h3> Komponentlista</h3>
	<p>Följande är en lista över komponenterna och de egenskaper de stöder:</p>		<p>Följande är en lista över komponenterna och de egenskaper de stöder:</p>