### YAHOO Namespace Initialization

Source: https://github.com/itext/itext-dotnet/blob/develop/itext.tests/itext.styledxmlparser.tests/resources/itext/styledxmlparser/jsoup/htmltests/yahoo-jp.html

Initializes YAHOO namespaces ('util', 'widget', 'example') if they do not already exist. Also handles YAHOO_config listener setup.

```javascript
(function(){YAHOO.namespace("util","widget","example");if("undefined"!==typeof YAHOO_config){var d=YAHOO_config.listener,a=YAHOO.env.listeners,b=true,c;if(d){for(c=0;c<a.length;c=c+1){if(a[c]]==d){b=false;break}}}if(b){a.push(d)}}})()
```

--------------------------------

### Install iText NuGet Packages

Source: https://github.com/itext/itext-dotnet/blob/develop/README.md

Use these commands to add the iText library and its Bouncy Castle adapter to your .NET project via NuGet.

```shell
dotnet add package itext --version <REPLACE_WITH_DESIRED_ITEXT_VERSION>
```

```shell
dotnet add package itext.bouncy-castle-adapter --version <REPLACE_WITH_DESIRED_ITEXT_VERSION>
```

--------------------------------

### Applying GPL to New Programs

Source: https://github.com/itext/itext-dotnet/blob/develop/itext.tests/itext.io.tests/resources/itext/io/font/GNU General Public License.txt

Include these notices at the start of each source file when developing a new program under the GPL. This ensures the exclusion of warranty and informs users about redistribution rights.

```text
<one line to give the program's name and a brief idea of what it does.>
Copyright (C) <year>  <name of author>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.
```

--------------------------------

### Create a Simple PDF Document in C#

Source: https://github.com/itext/itext-dotnet/blob/develop/README.md

This C# example demonstrates how to create a basic PDF file named 'helloworld-pdf.pdf' and add 'Hello World!' text to it using the iText library.

```csharp
using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;

namespace HelloPdf {
    class Program {
        static void Main(string[] args) {
            using var document = new Document(new PdfDocument(new PdfWriter("helloworld-pdf.pdf")));
            document.Add(new Paragraph("Hello World!"));
        }
    }
}
```

--------------------------------

### GPL Notice for Interactive Programs

Source: https://github.com/itext/itext-dotnet/blob/develop/itext.tests/itext.io.tests/resources/itext/io/font/GNU General Public License.txt

If a program interacts with the terminal, display this notice when it starts in interactive mode. This informs users about the lack of warranty and their rights to redistribute the software.

```text
<program>  Copyright (C) <year>  <name of author>
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
```

--------------------------------

### Initialize Yahoo News Hotlist and Translation

Source: https://github.com/itext/itext-dotnet/blob/develop/itext.tests/itext.styledxmlparser.tests/resources/itext/styledxmlparser/jsoup/htmltests/yahoo-article-1.html

This JavaScript code initializes the YAHOO.one.uh object, setting up hotlist information and a translation function for UI elements. It ensures the setup runs only if the YAHOO.one.uh object is already defined, otherwise, it retries after a delay.

```javascript
(function(){
var h = {};
var setUp = function(){
  h = YAHOO.one.uh.hotlistInfo = {
    rd: "http://us.ard.yahoo.com",
    space: "/SIG=15qa4spbh/M=650008.13019228.13970208.12579242/D=news/S=2023881070:HEAD/Y=YAHOO/EXP=1283302646/L=PENKT2KIKjz0U5Bi.EoomABspUVaCEx9iNYABtx_/B=62FLBkoGYmQ-/J=1283295446553092/K=U7.lJSeRx2ofwgoGAUPgCQ/A=5877298/R=0",
    adid: "5877298",
    prop: "news",
    protocol: "http",
    host: "real-fe.story.news.yahoo.com:80",
    url: "%2fnews%2fstory%2fmaple%2fen-US%2fnm%2f20100831%2fbs_nm%2fus_gm_china",
    spaceid: "2023881070"
  };
  YAHOO.one.uh.translate = function(str) {
    var set = {
      yahoo_homepage: "http://www.yahoo.com/",
      hp_detect_script: "http://www.yahoo.com/includes/hdhpdetect.php",
      set_hp_script: "http://us.ard.yahoo.com/SIG=15qa4spbh/M=650008.13019228.13970208.12579242/D=news/S=2023881070:HEAD/Y=YAHOO/EXP=1283302646/L=PENKT2KIKjz0U5Bi.EoomABspUVaCEx9iNYABtx_/B=62FLBkoGYmQ-/J=1283295446553092/K=U7.lJSeRx2ofwgoGAUPgCQ/A=5877298/R=1/SIG=10uacnjgh/*http://www.yahoo.com/bin/set",
      set_hp_firefox_instructions: ["Drag the \"Y!\" and drop it onto the \"Home\" icon.", "Select \"Yes\" from the pop up window.", "Nothing, you're done."],
      close_this_window: "Close this window",
      set_hp_alternative_instructions1: "If this didn't work for you see ",
      detailed_set_hp_instructions: "detailed instructions",
      set_hp_alternative_instructions2: ""
    };
    return set[str];
  };
  YAHOO.one.uh.Search = ['ygmasearchInput', 'sat'];
};
if ("undefined" !== typeof YAHOO && "undefined" !== typeof YAHOO.one && "undefined" !== typeof YAHOO.one.uh) {
  setUp();
} else {
  setTimeout(arguments.callee, 500);
}})();
```

--------------------------------

### Document Element Selector

Source: https://github.com/itext/itext-dotnet/blob/develop/itext.tests/itext.styledxmlparser.tests/resources/itext/styledxmlparser/jsoup/htmltests/yahoo-jp.html

A shorthand function '$' to get an element by its ID from the document. Returns false if the input is not a string.

```javascript
var d=document;var $=function(a){return(typeof(a)=="string")?d.getElementById(a):false};
```

--------------------------------

### Getting YAHOO Module Version

Source: https://github.com/itext/itext-dotnet/blob/develop/itext.tests/itext.styledxmlparser.tests/resources/itext/styledxmlparser/jsoup/htmltests/yahoo-jp.html

Retrieves the version information for a specified YAHOO module. Returns null if the module is not found.

```javascript
YAHOO.env.getVersion=function(a){return YAHOO.env.modules[a]||null}
```

--------------------------------

### Post-Initialization Script Execution

Source: https://github.com/itext/itext-dotnet/blob/develop/itext.tests/itext.styledxmlparser.tests/resources/itext/styledxmlparser/jsoup/htmltests/smh-biz-article-1.html

Sets the document domain to 'smh.com.au' for cross-domain scripting and executes any delayed ad loading functions. Includes error handling for development environments.

```javascript
function initPost() {
  try {
    document.domain = "smh.com.au";
  } catch (e) {
    // if working dev the above will fail
  }
  for(var i = 0; i < delayedAds.length; i++) {
    delayedAds[i]();
  }
}
```

--------------------------------

### Initialize Yahoo Search MiniAssist

Source: https://github.com/itext/itext-dotnet/blob/develop/itext.tests/itext.styledxmlparser.tests/resources/itext/styledxmlparser/jsoup/htmltests/yahoo-article-1.html

Initializes the YAHOO.Search.MiniAssist component for search suggestions. Ensure YAHOO.Search and YAHOO.Search.MiniAssist are available before instantiation.

```javascript
(function () { var sa; if (YAHOO.Search && YAHOO.Search.MiniAssist) { sa = new YAHOO.Search.MiniAssist('yn-search-assist'); sa.gossip.setConfigValue('pubid', 104); } })();
```

--------------------------------

### Initialize Font Asian and Hyph Modules

Source: https://github.com/itext/itext-dotnet/blob/develop/BUILDING.md

Call the initializer methods for the font-asian and hyph modules at application startup to ensure they are correctly initialized and not trimmed.

```csharp
new iText.FontAsian.FontAsianDummyInitializer(); // Font asian
new iText.Hyph.HyphDummyInitializer(); // Hyph module
```

--------------------------------

### Get Query Variable JavaScript Function

Source: https://github.com/itext/itext-dotnet/blob/develop/itext.tests/itext.styledxmlparser.tests/resources/itext/styledxmlparser/jsoup/htmltests/smh-biz-article-1.html

This function extracts the value of a specified variable from the current URL's query string. It's useful for retrieving parameters passed in the URL.

```javascript
function getQueryVariable(variable) { var query = window.location.search.substring(1); var vars = query.split("&"); for (var i=0;i<vars.length;i++) { var pair = vars[i].split("="); if (pair[0] == variable) { return pair[1]; } } return ''; }
```

--------------------------------

### TRAKTR Initialization and Configuration

Source: https://github.com/itext/itext-dotnet/blob/develop/itext.tests/itext.styledxmlparser.tests/resources/itext/styledxmlparser/jsoup/htmltests/news-com-au-home.html

This JavaScript block initializes and configures the TRAKTR tracking system. It sets site, section, page name, and tags based on dynamic page variables.

```javascript
//<![CDATA[
var tracktrSectionName = ndm.page.section.replace(/-/g, "_");
TRAKTR = window.TRAKTR || {};
/* editable */
TRAKTR.site = "NEWS";
TRAKTR.section = tracktrSectionName;
TRAKTR.pn = "NewsComAu | home | homepage | Homepage";
TRAKTR.tags = "content:type=homepage";
/* end editable */
//]]>
```

--------------------------------

### Preformatted List of Hangul Syllables

Source: https://github.com/itext/itext-dotnet/blob/develop/itext.tests/itext.styledxmlparser.tests/resources/itext/styledxmlparser/jsoup/bomtests/bom_utf16be.html

This preformatted block displays a sequence of Hangul syllables as represented in Unicode 2.0/KS C 5700. It serves as a raw data example for character encoding.

```text
 
      !"#$%&'()*+,-./01234567 89:;<=>?@ABCDEFGHIJKLMNOPQRS 
```

--------------------------------

### Adding ILLink Descriptors to Project File

Source: https://github.com/itext/itext-dotnet/blob/develop/BUILDING.md

Include the ILLink.Descriptors.xml file as an embedded resource in your project file to ensure the linker uses the specified configurations.

```xml
<ItemGroup>
		<EmbeddedResource Include="ILLink.Descriptors.xml">
			<LogicalName>ILLink.Descriptors.xml</LogicalName>
		</EmbeddedResource>
</ItemGroup>
```