diff --git a/source/en/content-edit.txt b/source/en/content-edit.txt index c64d90a..00fe64b 100644 --- a/source/en/content-edit.txt +++ b/source/en/content-edit.txt @@ -14,23 +14,21 @@ // This next line is an ID, which should be left alone. [[content-edit]] // The topic title goes on this line. Use "Title Case" for topic titles. -=== Verbing a Noun +=== Editing Content // - Replace the text in (((Nouns,verbing))) with an appropriate index entry, // such as (((Blocks,creating))). You can add additional index entries if // appropriate. // - Also remove the // before the ((( so that this becomes an index entry // and not a comment. -//(((Nouns,verbing))) +(((Content,editing))) ==== Goal // Describe the goal of this task here. -Remove this placeholder text. - - +The goal of this task is to explain how to edit existing content. ==== Prerequisite knowledge @@ -44,8 +42,17 @@ Remove this placeholder text. //* <> //* How to upload files from your local server to your web server. -Remove this placeholder text. +Basic familiarity with using a browser. Basic familiarity with the concept of content +types. Familiarity with <>. These instructions only apply +to editing content that forms individual pages (as opposed to blocks, taxonomy terms, or +views headers or footers, etc). In all but the rarest of circumstances, you must be +logged into the site in question to be able edit content. + +@TODO link to appropriate instructions on editing other content. + +@TODO How to make this more friendly to new Drupal users. +@TODO create a basic description of content types ==== Site prerequisites @@ -60,24 +67,110 @@ Remove this placeholder text. //* At least one published content item of this type exists. See // <>. - -Remove this placeholder text. +This is a central feature of any basic Drupal installation. No additional prerequisites +are required. ==== Steps // This is where you describe the actual steps needed to perform this task. -. Text of step one goes here. The subsequent lines of this step need - to be indented by two spaces. +.Locate the content to be edited +..Edit in place + There are several ways to locate content. The first is that you are on a page where you +are viewing the content in question. Above the content should be several buttons among +which will be "Edit". Click on "Edit". The other common way to locate a piece of content +to edit is to click on the "Content" button in the Admin menu bar to view a list of all +the content on the site. You can and use the filters to locate the content you want to edit. + + An advantage of editing via this content list is that when you save a piece of content, +Drupal will return you to this list so you can edit another piece of content. This is useful +when you have to edit a large number of items. + + Below we'll cover how to make batch edits to content using the options on this content +list page. + +.Edit the piece of content. + + Once you pick the "Edit" link/button, your browser should load the content in an editor +form. As introduced in the <>, you can +change the title, body text and other fields here. + + On the right sidebar (or below the content on a mobile device), you will see some +vertical tabs that offer other tasks related to the content. + +..Revisions + + Revisions are a useful tool for managing the history of edits of a piece of content and +to be able to revert to a previous version of the content. If you check the "create a new +revision" a new copy of the content will be created upon saving. (Once saved you will see a +new tab labeled "Revisions".) + +@TODO need managing revisions documentation. + +..Menu Settings + + As described in the <>, you can edit the +menu link title, create a description (that will appear when the user is hovering over the +link, the menu, and the position within the menu) - And it could be a couple of paragraphs. +..Comment Settings -[start=2] -. Text of step two goes here. If you preview the output and the numbering is - wrong, you can use this start=(number) line to set the numbering correctly. + If commenting is enabled on the site as well as for this particular content type, this +is where you can close or re-open commenting. NOTE: Once a piece of content has been +created, changing commenting defaults for the content type do not affect the status of +commenting on any content of that type that has already been created. (So if you have 50 +blog posts already and find commenting is a problem, you can change the default for the +"blog post" content type, but, absent advanced editing options, you must manually close +commenting on each extant blog post.) -. Text of step 3. +..URL Path Settings + + As introduced in <>, you can edit the path +to your content here using letters, numbers, hyphens and underscores. + +..Authoring Information + + You can change the author, date and time the content was "created" here. Only authors +that already exist as explained in the <<_users_roles_and_permissions,users section>> +can be assigned as author of a piece of content. + +..Promotion Options + + As introduced in <>, you can change +whether a piece of content should be promoted to the front page or whether the content's +position will always appear at the top of lists regardless of other sorting rules. NOTE: +While a default installation of Drupal will use these for the front page aggregation of, +content, these options will have no effect if they have not been enabled in the various +content lists defined in views and other tools. +@TODO link to views overview. +@TODO explanation of front page default aggregation configuration. + +.Saving Content + + At the bottom of the editor, there is a blue button with a triangle on right side. This +means that the button has options. If you click on the triangle, you will see that you can +choose to save and publish the content, or save and unpublish the content. Unpublished +content is no longer visible to those users (including the anonymous user) who are not +allowed to view unpublished content (see the <<_users_roles_and_permissions,users section>> +for details.) + + You can also preview the content here and also delete it. NOTE: deleting content also +deletes all revisions, so there is no recovery for deleted content. + +.Making Batch Changes + Certain features of content can be edited in batch such as whether a collection of +content items are published or not, sticky at the top of lists, promoted to the front page. + + This is done in the content page (eg. yoursite.com/admin/content). You can use the +filters to narrow down your list, and then check the items you want to manipulate. Then +you can use the drop-down menu with the label "With selection". NOTE: as with the delete +option on the editing form, deletions are permanent and cannot be undone. + + With advanced configurations, you can create triggers using modules like +link:https://www.drupal.org/project/rules[Rules] that are called when a piece of content +is saved. If you want to apply the triggers to a bunch of content you already created, +you can do this by using the "Save Content" option in the drop-down menu. ==== Follow-on tasks @@ -91,15 +184,13 @@ Remove this placeholder text. // Some ideas (remove the // to make these not comments): //* <> //* Brief description of another task not in the book. - - -Remove this placeholder text. - +<> +<<_administering-blocks,Editing Blocks>> ==== Additional resources // In this section, make a list of outside references: videos, Drupal.org // documentation, etc. -Remove this placeholder text. +