Editing Writing PDA Nodes

== Writing Nodes ==
Most of the basics of how to use your PDA are covered in-game at help datapad or here in the guide to PDA Basics, but if you end up wanting to really use the PDA you're going to end up having to compose nodes.

This system is super powerful and flexible, but at the cost of having some fairly gnarly syntax. Don't worry, though- writing basic nodes isn't too tough!

=== Basic Node Composition ===
You start by composing a node with datapad pda compose <title>. Then you'll want to open your outbox to get the node's number, just for later reference.
 ''datapad pda compose Sample Note''
 You have composed a new document. Check your OUTBOX to see it.
 
 ''datapad pda outbox''
 
 Outbox for Sample-Account (Person) [#3616]
 SampleNote (Note) [#4661] on 2176-03-07 08:57:44
Once the note's created, you're able to add text to it, line by line. The basic command for adding text is '''''datapad pda append text <text>'''''- it'll automatically add the line to the last node you had opened. 

'''''Datapad pda append text''''' without any added words will give you a blank line, which helps a lot for readability.

So how would we write a basic node?
 ''datapad pda append text This is my first line of a node.
 ''datapad pda append text
 datapad pda append text It doesn't have to be anything fancy, you see.''
What would this look like?
 ''datapad pda open 4661''
 
 SampleNote (Note) [#4661]
 (0) This is my first line of a node.
 (1) 
 (2) It doesn't have to be anything fancy, you see.
Voila! It really can be that simple. 

But in reality you're likely going to need more than three lines. It's easy to mess up when entering things line by line, so you may need to tidy things up. A few helpful commands:

'''''datapad pda replace <line number> text <new text>''''' - Replaces the original line with this new line.

'''''datapad pda insert <line number> text <new text>''''' - Puts a new line in directly BELOW the specified line.

'''''datapad pda swap <line #1 number> <line #2 number>''''' - Swaps the order of two lines.

=== Working With Sketches ===
One great use case of nodes is to store and share item designs. For that kind of thing, the sketch function is fantastic.

In essence, sketches just store a single line of text in a different format to make it clear the text is ICly representing an image.

To create a sketch, you type '''''datapad pda append sketch''''' instead of datapad pda append text - otherwise, everything else looks the same!

How would this look in-game? Here's a sample node with a couple sketches in it. To look at the sketches, you just type '''''datapad pda interact <line number>''''':

https://cdn.imgchest.com/files/7lxcprblg37.png

This node was made with the following commands:
 ''datapad pda compose AHB- Mural Sketches
 datapad pda append text SKETCH PROOFS OF CONCEPT FOR AHB MURAL PROJECT
 datapad pda append text
 datapad pda append text Mural 1 - Starry Sands
 datapad pda append sketch [1st sketch text here]
 datapad pda append text
 datapad pda append text Mural 2 - Life Old and New
 datapad pda append sketch [2nd sketch text here]''
If you make a node like this, you can easily share it with other people (with '''''datapad pda public''''' or '''''datapad pda share <person ID>''''') so they can see your strings and provide feedback.  

'''NOTE''': If you do this, make sure you save your color strings somehow - either by saving a log with your input in it, or by copying your strings into an external document. That'll make your life a lot easier when it comes time to make the actual object! But if you realize you forgot to save your strings, don't despair - as long as the node exists, you CAN get the color codes back. See Advanced Node Editing for some tips on how. 

=== Writing Nodes Externally ===
Just writing line by line works fine if you're doing something short, but if you're trying to write out anything long it's going to get obnoxious for you fast. This is doubly true if you want pretty formatting, or to update a node later, or to use color... etc, etc.

For bigger nodes, I recommend writing your nodes first in a basic text editor. Notepad works just fine, though I personally love Notepad++ (https://notepad-plus-plus.org/) as a more powerful alternative. It's free, too!

Now, after you write out your node in a text editor, you'll have to enter the text in the game. This IS a tricky process, but luckily there's a few easy ways around that:

==== Using Caors' Tools (Mudlet) ====
1) The lovely Caors has made a great tool to help people enter their text into the game. Check out https://udcolortools.neocities.org/PDALines. The page will tell you how to use it in detail, but the basic idea... All you have to do is copy and paste your text into the left box, hit the 'basic' button, and the right box will output some code you can put into an alias. Inputting that alias will then enter the text into your node. Visual example: https://cdn.imgchest.com/files/y2pckdbx5q7.png

==== Manual Entry (Any Client) ====
If this doesn't work for you, you can also do this by just making sure every line you write has ''''datapad pda append text'''<nowiki/>' at the start, and then entering those lines in a batch. In Notepad++, if you do a Find and Replace with the 'Regular expression' options checked, searching for ^ and replacing it with 'datapad pda append text ' will insert those words in front of every line for you. Here's what this looks like, if you need a visual aid: https://cdn.imgchest.com/files/7ogcbwzqkzy.png

Once you've done this, you can enter the lines manually by copying and pasting them in.

==== Plain-Text Alias (MUSHclient) ====
For MUSHClient users who want to take this path, I heavily recommend setting up an alias with speedwalk delay. (Speedwalk delay can be configured in File->World Properties, then check the window that pops up for Input -> Commands.) Once you've added 'datapad pda append text' to the start of each line in your text file, you can then simply copy the text directly into the alias box with no other effort needed. Visual example of the alias I use and its settings: https://cdn.imgchest.com/files/yrgcnad6po4.png

== More Information ==
Hopelessly lost? Try reviewing [[PDA Basics]] and [[PDA Actors]] for an introduction to PDAs in general.

Ready for the next step? Check out Advanced PDA Node Editing.
[[Category:Guide]]