LaTeX/C3/Writing-Style-Files-in-LaTeX/English-timed

Time	Narration
00:01	Hello and welcome to the spoken tutorial on “Writing Style files” in LaTeX.
00:08	In this tutorial we will learn how to:
00:11	Write a custom style file
00:14	Import a custom style file in a LaTeX document and
00:19	Define a standard style file
00:23	This tutorial is recorded on Ubuntu Linux 18.04 OS and TeXworks Editor v0.6.
00:36	The steps demonstrated will work in all operating systems.
00:41	To practise this tutorial, you should be familiar with LaTeX commands.
00:47	You should also know how to define newcommand and newenvironment in LaTeX.
00:54	If not, then go through the prerequisite LaTeX spoken tutorials on this website.
01:01	The files used in this tutorial are available in the Code Files link on this tutorial page.
01:08	Please download and use them while practising.
01:12	Make sure that all the supporting files are kept in the same folder while practising.
01:19	Style files are also known as Packages.
01:23	These are supplementary files that increase the functionality of LaTeX.
01:29	You might have used various packages in your LaTeX document earlier.
01:34	For example, we import geometry package for defining margin.
01:40	To reuse the same code many times in the same document, we use newcommand and newenvironment.
01:48	To reuse the same code many times in many documents, we use style files.
01:55	We usually define our own style file in LaTeX to save time and get cleaner code.
02:03	The tex file containing the content will remain clean, if the styles are in separate sty files.
02:12	Hence, it is advised to write and use style files.
02:17	Go to the folder where all the files are downloaded.
02:21	Open the file myPackage.sty in TeXworks editor.
02:27	We will see some LaTeX code written in the file.
02:31	Let us try to understand the code.
02:34	This newcommand definition means that slash iitb is the newcommand.
02:40	Whenever slash iitb is used in a LaTeX document, it will typeset the full name of IITB in bold font.
02:50	RequirePackage command is used to load the required packages in the style files.
02:57	We are using RequirePackage background for setting the background image.
03:03	I have defined newcommand slash iitbbg to load IITB’s logo as the background image.
03:12	So every time instead of loading the image manually, we can use slash iitbbg command.
03:21	We have now successfully created our custom style file.
03:25	Next let us see how to use this style file.
03:30	Please note that we do not compile .sty files.
03:34	Let’s close this file.
03:38	Now open the file custom.tex in TeXworks editor.
03:44	The new style file is loaded in the preamble using usepackage command.
03:51	In our example, we have loaded our style filemyPackage.
03:57	After loading the style file, we use\iitb and \iitbbg commands inside the document section.
04:08	At the top left, in the drop-down, select pdfLaTeX if not already selected.
04:15	Then click on the green arrow button to compile the file.
04:20	On compilation, we get the pdf output on the right.
04:25	Come back to custom.tex file.
04:29	Here, we had included the command slash iitbbg to display the background image.
04:37	But we’re not seeing that in the output.
04:41	To display the background image, we may need to compile the code once again. Let us compile it once again.
04:50	And here is the background image!
04:53	Sometimes, we have to compile the LaTeX code twice, if we don’t see the expected output.
05:00	Now let’s modify our style file into a standard style file.
05:06	The reason is, in the real-world you would want to share your style file with others.
05:13	Ideally, it must adhere to the style file guidelines given by the LaTeX community.
05:20	The structure of the style file can be summarized into 3 parts:
05:26	Identification, includes package name and version
05:32	Preliminary declarations, includes details of the required package and User code.
05:42	More information on this guideline is available at this link
05:48	Go to the folder where the code files are saved.
05:53	Let’s open the file myStdPackage.sty in TeXworks.
06:01	We have written some definition inside our style file. Let’s try to understand the code.
06:09	NeedsTeXFormat{} is used to specify the version of LaTeX in which this style file will work.
06:17	In our example, it is LaTeX2e.
06:22	ProvidesPackage is used for identification of the package.
06:27	The package name should be identical to the filename.
06:32	Here I am using myStdPackage as a parameter and file name.
06:39	We willalso provide other details like release date and description of the package.
06:46	From here onwards, we define our commands and definitions.
06:51	Recall, we have used this code in myPackage.sty file.
06:58	endinput must be the last command in this file.
07:02	It indicates that the style file ends here.
07:07	Now we have modified our style file into a standard style file.
07:13	Next let’s switch back to the LaTeX file custom.tex.
07:19	In the usepackage command change the package name to myStdPackage.
07:27	Then save and compile the file.
07:31	We get the same pdf output without any error.
07:36	This means our new standard stylepackage is working correctly.
07:42	Once we have created our own style file, we can share this with the LaTeX community too.
07:49	Upload the created style file on the Comprehensive TeX Archive Network
07:56	Provide proper documentation and read the guidelines before uploading.
08:02	This brings us to the end of this tutorial. Let us summarise.
08:08	In this tutorial we learnt Write a custom style file
08:13	Import the custom style file in a LaTeX document
08:18	Define a standard style file
08:22	As an assignment: Identify and make a list of different scenarios where creating a style file would be helpful.
08:31	The video at the following link summarises the Spoken Tutorial project. Please watch it.
08:39	The Spoken Tutorial Project Team conducts workshops and gives certificates. For more details, please write to us.
08:49	Please post your timed queries in this forum
08:53	Spoken Tutorial Project is funded by MHRD, Government of India.
08:59	The script is contributed by Arun, FOSSEE Summer Fellow 2019 And this is Praveen from IIT Bombay signing off. Thanks for joining.

Contributors and Content Editors

PoojaMoolya