For importing nodes into drupal.org for Feeds, it would be very nice to have a Summary field we could extract and display. See #2757921: Import AsciiDoc HTML output into nodes.
To do this, we would need [note: similar to what we are already doing for the copyright notice?]:
a) A way in the AsciiDoc source to define a summary for each topic, and each chapter.
b) Code that would parse this out when displaying or parsing for feeds, and extract it to return for feeds.
c) Code in the Feeds sub-module that would return the summary as a potential field that can be mapped to a field on the topic when importing.
d) We would also need to fill in this value in the AsciiDoc source. But it shouldn't be too hard -- we have a spreadsheet saying what each topic covers, so that can be used to define the summaries.
Comments
Comment #2
jhodgdonComment #4
jhodgdonIt turned out that this was very easy to take care of. I have it working for the Contributor Guidelines book on my local test site, and will test importing to dev site shortly. The code is also committed, and I updated the project README.
For the main User Guide, I am going to create a separate issue to actually add the summaries to the Guide, and then ask my star copy editor contributor to review them. :)